Verify Bank Account NGN

This endpoint is used to validate a bank account recipient before initiating an NGN payout.

POST /api/validate-account

Headers

Name	Value
Content-Type	application/json
Token	token

Body

Name	Type	Description
bank_account_number*	string	The account number to be verified
bank_code*	string	The code of the bank associated with the account
currency_code*	string	The currency code of the account

Response

Request

curl --location 'https://api.tumapay.com/api/validate-account' \
--header 'token: [Generated after Login]' \
--data '{
    "bank_account_number": "<Bank account number>",
    "bank_code": "<GET from https://api.tumapay.com/api/get-banks?country=NIGERIA>",
    "currency_code": "NGN"
}'

Successful Response

{
  "status": {
    "type": "number"
  },
  "message": {
    "type": "string"
  },
  "accountName": {
    "type": "string"
  },
  "accountNo": {
    "type": "number"
  }
}

Unsuccessful Response

{
  "error": "Invalid request"
}