Payout API

The GlobalPayTech Payout API allows merchants to transfer funds from their GlobalPayTech account or wallet to external recipients such as customers, vendors, or partners.
It provides a reliable, secure, and trackable way to disburse payments — supporting use cases like withdrawals, merchant settlements, vendor payments, and refunds.

Overview

The payout process is asynchronous. Once a payout is initiated, the GlobalPayTech system validates the request, routes it through the appropriate payment network or bank, and sends webhook notifications at every major step — from initiated to completed or failed.

Each payout transaction has a unique reference ID, making it easy to reconcile and audit.

Note

The payout request body has a unified payload for all payout. You are adviced to check the required payload based on your APM method. APM methods

Use Cases

Use Case	Description
Customer Withdrawal	Send funds back to customer bank accounts or wallets.
Vendor Payments	Pay suppliers or affiliates automatically

Payout Flow

sequenceDiagram
    participant Merchant as 🏬 Merchant Server
    participant GlobalPayTech as 🌐 GlobalTech API
    participant Bank as 🏦 Destination Bank
    participant Beneficiary as 👤 Recipient

    Merchant->>GlobalTech: POST /v1/payouts/initiate (amount, bank_account, reference)
    GlobalPayTech-->>Merchant: Returns payout_id and status: "pending"
    GlobalPayTech->>Bank: Submits transfer request
    Bank-->>GlobalPayTech: Confirms transfer processing
    GlobalTech-->>Merchant: Webhook (payout.processing)
    Bank-->>GlobalPayTech: Confirms success or failure
    GlobalTech-->>Merchant: Webhook (payout.completed or payout.failed)
    Merchant-->>Beneficiary: Notifies recipient of successful payout