v1

latestOpenAPI 3.0.32026-07-26184851.6 MB

Withdraw Fiat

Child Address Execute

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

Request body

referencestring

client reference for tracking transaction

accountIdentifierstring required

destination bank account identifier

amountnumber required

amount to withdraw in asset units

assetIdstring required

asset ID of the stablecoin to withdraw

codestring

currencystring required

destination fiat currency code

institutionIdentifierstring required

bank or institution identifier code

Example request

{
  "accountIdentifier": "8034007516",
  "amount": 0.5,
  "assetId": "37079b6b-b74f-48e9-a394-9a5cbae88f12",
  "code": "956407",
  "currency": "NGN",
  "institutionIdentifier": "OPAYNGPC"
}

Response

200

messagestring

statusCodenumber

Example response

{
  "data": {
    "gateway": "0x30F6A8457F8E42371E204a9c103f2Bd42341dD0F",
    "senderFee": {
      "hex": "0x00",
      "type": "BigNumber"
    },
    "senderFeeRecipient": "0xaeAE273Cc4f8CCdF9786eb2967D5d24E8255c092",
    "transaction": {
      "amount": "0.5",
      "amountPaid": "0.5",
      "amountUSD": "0.5",
      "blockchain": {
        "createdAt": "2026-01-20T08:10:37.776Z",
        "derivationPath": "m/44'/60'/0'/0",
        "id": "384ba700-5831-49a1-8cba-7d89385d5a25",
        "isActive": true,
        "isEvmCompatible": true,
        "isL2": true,
        "name": "base",
        "networkFeeModel": "native",
        "slug": "base",
        "symbol": "eth",
        "updatedAt": "2026-01-20T08:10:37.776Z"
      },
      "createdAt": "2026-01-24T21:05:10.778Z",
      "createdChannel": "dashboard",
      "currency": "USD",
      "fee": "0",
      "feeUSD": "0",
      "id": "f93c28b7-d8f7-43ab-9373-22a9a8931177",
      "metadata": {
        "businessId": "6271be9f-b48a-4e6d-b14b-b76629bc7014",
        "businessProviderId": "1c40879e-c340-4308-92d9-30bdb34b3b84"
      },
      "network": "mainnet",
      "note": "Method: createOrder | Contract Address: 0x30F6A8457F8E42371E204a9c103f2Bd42341dD0F",
      "processingStatus": "PENDING",
      "rate": "1465.14",
      "rateUSD": "1",
      "reason": "{\"method\":\"createOrder\",\"parameters\":[\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\",{\"type\":\"BigNumber\",\"hex\":\"0x07a120\"},{\"type\":\"BigNumber\",\"hex\":\"0x023c52\"},\"0xaeAE273Cc4f8CCdF9786eb2967D5d24E8255c092\",{\"type\":\"BigNumber\",\"hex\":\"0x00\"},\"0xaeAE273Cc4f8CCdF9786eb2967D5d24E8255c092\",\"HblZl+1ItFI/v98ewxY6gq/d+9KqzfjDHGKva2r4KzKFqE19Q+1+IA7w2PE0yKJxB26jNjXYCN32IAnH129K232soxCPXVYRRX+jSps9yOtwUUi0ZPRfInqJXKubGXOJPiQnr9bg81fAkr2+DY9oMMB1u0gzDptBkq3FykFqMYMeXVeyepE0IO2ZJLa7Jk5BtgBP7iQwj7W+PknC8/0rvIz6czDgzFpssTb5QYGR/nPlEUWgHmu5DUD+22wxd/xA/Cm8Y7DWHMCRvNG+0FpVLa2OlPK4f4dI0hKZsuG5iaEl6/ucgHvupl3fAHISnwOqZgM5RvxF8iM5XKvBJkEyZg==\"],\"abi\":{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_token\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"},{\"internalType\":\"uint96\",\"name\":\"_rate\",\"type\":\"uint96\"},{\"internalType\":\"address\",\"name\":\"_senderFeeRecipient\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_senderFee\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"_refundAddress\",\"type\":\"address\"},{\"internalType\":\"string\",\"name\":\"messageHash\",\"type\":\"string\"}],\"name\":\"createOrder\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"orderId\",\"type\":\"bytes32\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}}",
      "recipientAddress": "0x30F6A8457F8E42371E204a9c103f2Bd42341dD0F",
      "reference": "Cy1NqiVNDw7Ajsj1yECX",
      "senderAddress": "0xaeAE273Cc4f8CCdF9786eb2967D5d24E8255c092",
      "status": "PENDING",
      "toAmount": "732570000",
      "tokenAddress": "0x30F6A8457F8E42371E204a9c103f2Bd42341dD0F",
      "type": "OFFRAMP",
      "updatedAt": "2026-01-24T21:05:10.778Z",
      "wallet": {
        "address": "0x969838345E5cd5F755DfcADB57e72F5d23271e48",
        "configurations": {
          "addresses": {
            "prefunding": {
              "rules": []
            }
          },
          "autoSettlement": {
            "rules": []
          },
          "autoSweeping": {
            "isActive": true
          },
          "withdrawal": {
            "gasless": {
              "operator": "gt"
            }
          }
        },
        "createdAt": "2026-01-20T08:44:44.305Z",
        "derivationPath": "m/44'/60'/0'/0/0",
        "description": "This is Base master Wallet",
        "id": "7aa5120b-2106-43c6-92c7-6458b7d2de8b",
        "isActive": true,
        "name": "Base Mainnet",
        "network": "mainnet",
        "status": "ACTIVE",
        "updatedAt": "2026-01-20T08:44:44.305Z"
      }
    }
  },
  "message": "Withdraw fiat execution initiated",
  "statusCode": 200
}