v1

latestOpenAPI 3.0.0Proprietary2026-07-2233792.6 KB

Conversion

Convert Fiat to USD

Convert local fiat (NGN or GHS) balance to USD. Optionally provide a withdrawal address ID to automatically withdraw the converted USD to that address.

post/payments/fiat-to-usd

Request body

amountnumber required

Amount in local fiat (NGN or GHS) to convert to USD.

pinstring

Transaction PIN (required when withdrawalAddressId is provided).

withdrawalAddressIdstring

ID of a saved withdrawal address. If provided, the converted USD is withdrawn to this address; PIN is required.

Example request

{
  "amount": 50000,
  "withdrawalAddressId": "6932dc98c2ceccdea367388a"
}

Response

Conversion (and optional withdrawal) completed successfully