Skip to main content
POST
cURL

Headers

Authorization
string
required

Bearer token for authentication.

Example:

"Bearer <token>"

accountId
string
required

The parent accountId of the business.

Example:

"890022ce-bae0-45c1-9b9d-ee7872e6ca27"

Body

application/json

Exchange authorization payload

amount
number
required
Example:

1

sourceCurrency
string
required
Example:

"USD"

destinationCurrency
string
required
Example:

"CDF"

senderName
string
required
Example:

"John Doe"

receiverName
string
required
Example:

"John Doe"

sourceCountryIsoCode
string
required
Example:

"CD"

destinationCountryIsoCode
string
required
Example:

"CD"

narration
string
Example:

"Transfer between my accounts"

lockedExchangeRateId
string

The exchangeRateId from a prior Fetch Exchange Rates call. When provided, the exchange is fulfilled at that exact rate.

Example:

"01kkk4b7rh8pcvtw1s1nxs144s"

Response

200 - application/json

Exchange authorized successfully.

code
string
Example:

"00"

description
string
Example:

"Successful"

data
object