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. 
curl --request POST \
  --url https://api.nomba.com/v1/global-payout/exchange/authorize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountId>' \
  --data '{
    "amount": 1,
    "sourceCurrency": "USD",
    "destinationCurrency": "CDF",
    "senderName": "ADEBUKOLA AKANJI",
    "receiverName": "ADEBUKOLA AKANJI",
    "sourceCountryIsoCode": "CD",
    "destinationCountryIsoCode": "CD",
    "authCode": "5555",
    "narration": "Transfer between my accounts"
  }'

​
Request body

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

​
Response body

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