Create a fiat payout

POST

/api/v1/fiat/sends

Fiat

Initiate a USD-debited payout to a bank or mobile-money recipient. Requires a SECRET API key. Provide exactly one of sourceAmountUsd or destinationAmount. For merchant payouts set ownerType to MERCHANT and ownerId to your businessId.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Payout accepted

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/fiat/sends' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "ownerType": "MERCHANT",
    "ownerId": "string",
    "destinationCountry": "string",
    "destinationCurrency": "string",
    "sourceAmountUsd": 0,
    "destinationAmount": 0,
    "narration": "string",
    "metadata": {},
    "recipient": {
        "methodId": "string",
        "accountNumber": "string",
        "accountName": "string",
        "phone": "string"
    }
}'

Response Example

{
    "sendId": "string"
}

Modified at 2026-08-02 01:17:30

Preview a fiat collection price

Get payout status