Skip to main content
POST
/
withdraw
Withdraw fiat
curl --request POST \
  --url https://staging.api.mavapay.co/api/v1/withdraw \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "amount": "100000",
  "currency": "NGN",
  "beneficiary": {
    "bankAccountNumber": "0123456789",
    "bankAccountName": "JOHN DOE",
    "bankCode": "000013",
    "bankName": "GTBANK PLC"
  }
}
'
{
  "status": "success",
  "data": {
    "id": "d1614a76-9c7f-4111-98a7-43199f307e5b",
    "walletId": "d1614a76-9c7f-4111-98a7-43199f307e5b",
    "ref": "99eeff854ffd345fffs67890",
    "hash": "189727ef2e0f35921af7858b96e27cbad960b0ec2bb2a4ab73b6a231f9ce8727",
    "amount": 1000,
    "fees": 0,
    "currency": "NGN",
    "type": "WITHDRAWAL",
    "status": "SUCCESS",
    "autopayout": true,
    "createdAt": "2021-07-01T12:00:00Z",
    "updatedAt": "2021-07-01T12:00:00Z",
    "metadata": {
      "id": "d1614a76-9c7f-4111-98a7-43199f307e5b",
      "orderId": "99854-2345",
      "bankCode": "090267",
      "bankAccountName": "Satoshi Nakamoto",
      "bankAccountNumber": "0123456789",
      "customerInternalFee": 0,
      "createdAt": "2021-07-01T12:00:00Z",
      "updatedAt": "2021-07-01T12:00:00Z"
    }
  }
}

Authorizations

​
X-API-KEY
string
header
required

Body

application/json
​
amount
string
required

The amount to withdraw in the lowest denomination (e.g., Kobo for NGN). For example, 100000 = 1,000.00 NGN

Example:

"100000"

​
currency
enum<string>
required

The currency to withdraw

Available options:
NGN
​
beneficiary
object
required

The beneficiary bank account details. Use the exact values returned from the Name Enquiry endpoint.

Response

Withdraw response

​
status
string<string>
Example:

"success"

​
data
object