Quick Actions
Authorize Transfer
Initiate and authorize an international transfer end-to-end.
Convert Money
Convert funds between currencies before disbursement.
Fetch Exchange Rates
Get the latest exchange rates for a currency pair.
Fetch Transaction
Track the status of any global payout transaction.
Authorize Exchange
Transfer funds between your own accounts in different currencies.
List Institution Providers
Retrieve available banks and mobile money providers for your destination country.
How it works
1
Fetch the latest exchange rate
For cross-currency transfers, call the exchange rates endpoint to show your customer the current rate before they confirm the transfer.
2
Fetch payment methods
Call
GET /v1/global-payout/payment-methods to see the available payment rails and the corridors each one serves. Call it again with destinationCountryIsoCode to get that corridor’s exact required fields and selectable values such as purposeOfPayment, accountType, and bankAccountType — requirements differ by destination, so a corridor-specific call is what tells you exactly what to send.3
Authorize the transfer
Submit the recipient details, payment method, source and destination currencies, and any required fields returned by Fetch Payment Methods. Include your own
idempotencyKey so a retry cannot create a second transfer.4
Fetch transaction status
Use the FetchTransaction endpoint with the returned
wtTransactionId to poll for the current status of the transfer at any point in its lifecycle.Both Authorize Transfer and Authorize Exchange accept an optional
idempotencyKey in the request body. Send the same key when retrying a request you are unsure landed, and the original transaction is returned with idempotentReplay: true rather than a second one being created. The key is echoed back on the response, on Fetch Transaction, and on the webhook, so you can reconcile against your own reference. See Retrying safely.Convert Money is optional. Use it to calculate the destination amount for a source amount. For a cross-currency transfer, pass the
exchangeRateId returned by Fetch Exchange Rates as lockedExchangeRateId in the Authorize Transfer request so the transfer uses the rate you quoted to your customer.