v1

latestOpenAPI 3.0.32026-07-26184851.6 MB

Withdraw Fiat V2

Master Wallet Execute

post/v2/wallets/{id}/withdraw/fiat/execute

Path parameters

idstring uuid required

Wallet identifier.

Request body

assetIdstring uuid required

amountstring required

currencystring required

paymentMethodstring required

paymentMethodDataobject

isGaslessWithdrawboolean

referencestring

Unique client reference used for reconciliation and safe retries.

metadataobject

Your application metadata.

notestring

Human-readable transaction note.

providerstring

Example request

{
  "reference": "wd_20260719_001",
  "metadata": {
    "payoutId": "payout_123"
  },
  "note": "Vendor payout"
}

Response

Successful response.

statusCodeinteger required

messagestring required

Human-readable result.

Example response

{
  "statusCode": 200,
  "message": "Withdrawal initiated successfully",
  "data": {
    "id": "5b26b640-7a15-48aa-a465-82a4cb6e927b",
    "reference": "wd_20260719_001",
    "senderAddress": "0x947514e4B803e312C312da0F1B41fEDdbe15ae7a",
    "recipientAddress": "0123456789",
    "amount": "100.00",
    "amountPaid": "100.00",
    "amountUSD": "100.00",
    "fee": "1.50",
    "currency": "NGN",
    "status": "pending",
    "processingStatus": "pending",
    "type": "offramp",
    "createdAt": "2026-07-19T12:30:00.000Z",
    "updatedAt": "2026-07-19T12:30:00.000Z"
  }
}