Skip to main content

Authorize Exchange

POST /v1/global-payout/exchange/authorize

Move funds between your own accounts with ease. AuthExchange is designed for internal transfers, allowing you to shift balances across your accounts in different currencies without the overhead of an external disbursement flow.

Request body

number
required
Amount to transfer in the source currency.
string
required
ISO 4217 currency code of the source account (e.g., USD).
string
required
ISO 4217 currency code of the destination account (e.g., CDF).
string
required
Name of the account holder initiating the exchange.
string
required
Name of the receiving account holder. For own-account exchanges this is typically the same as the sender.
string
required
ISO 3166-1 alpha-2 country code of the source account (e.g., CD).
string
required
ISO 3166-1 alpha-2 country code of the destination account (e.g., CD).
string
Description or memo for the exchange.
string
The exchangeRateId from a prior Fetch Exchange Rates call. When provided, the exchange is fulfilled at that exact rate.

Response body

string
required
Unique GlobalPayout transaction ID. Use this to track the exchange via Fetch Transaction.
string
Internal core transaction reference.
string
required
Processing status. One of: PROCESSING, COMPLETED, FAILED, PENDING.
string
Core system status (e.g., SUCCESS).
string
Transaction type. Will be EXCHANGE for own-account transfers.
object
Transaction metadata including currency pair details, amounts, and spread info.