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": 1000,
  "currency": "NGN",
  "bankAccountNumber": "0123456789",
  "walletId": "d1614a76-9c7f-4111-98a7-43199f307e5b"
}
'
{
  "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
number<number>
Example:

1000

​
currency
enum<string>
Available options:
NGN,
KES,
BTC,
USD
​
bankAccountNumber
string<string>
Example:

"0123456789"

​
walletId
string<string>
Example:

"d1614a76-9c7f-4111-98a7-43199f307e5b"

Response

Withdraw response

​
status
string<string>
Example:

"success"

​
data
object