Convert Money
POST /v1/global-payout/money/convert
When moving funds across currencies, Convert Money calculates the converted amount for you. Call this endpoint when you need to know the destination amount for a source amount before authorizing a transfer. The exchange rate and applicable fees are automatically scoped to the region configured for your authenticated account.
Convert Money is available only for supported currency corridors. Call Fetch Exchange Rates first to confirm that the pair is available. If a corridor is unavailable, the API returns an error asking you to contact support.
Request body
number
required
The amount to convert in the source currency.
string
required
The ISO 4217 currency code of the source amount (e.g.,
USD).string
required
The ISO 4217 currency code to convert into (e.g.,
EUR).string
required
The type of transaction. Use
EXCHANGE for currency conversions.Response body
number
required
The original amount in the source currency.
string
required
The source currency code.
string
The source amount formatted as a display string (e.g.,
$15.00).number
required
The converted amount in the destination currency.
string
required
The destination currency code.
string
The destination amount formatted as a display string.
number
The spread amount applied to the conversion.
string
The currency the spread is denominated in.
string
required
The ID of the exchange rate used for this conversion. To have a transfer use the rate quoted to your customer, use the
exchangeRateId returned by Fetch Exchange Rates as lockedExchangeRateId in Authorize Transfer.string
The currency pair notation (e.g.,
EUR/USD).number
Any applicable transaction fee.
string
The currency the fee is charged in.