Sign in

97f95b4cfc0d

latestOpenAPI 3.0.32026-07-26184851.6 MB
Withdraw Fiat V2

Child Address Execute

post/v2/wallets/{walletId}/addresses/{addressId}/withdraw/fiat/execute

Path parameters

walletIdstring uuid required

Wallet identifier.

addressIdstring uuid required

Child address 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"
  }
}