Endpoint to validate bank account details for payouts.

Request:

FieldTypeDescription
nubanString(Digits)Unique bank account number
codeString(Digits)Unique bank code the list of supported banks
currencyStringThree letters ISO currency code e.g ngn

Example request

curl --location 'https://api.vendy.money/bank/validate?nuban=0011678314&code=000013&currency=ngn' \
--header 'Authorization: Bearer <token>'

Response:

FieldTypeDescription
statusBooleanStates if request was successfully executed or not
codeIntegerInternal code, success if 200
msgStringA description of the status of the request
dataJSONAccount details of validated bank account

Example response

{
    "status": true,
    "code": 200,
    "msg": "Bank Validated",
    "data": {
        "accountNumber": "0011678314",
        "accountName": "SALAMI MURITALA OLAYIWOLA",
        "bankCode": "000013",
        "bankName": "GUARANTY TRUST BANK"
    }
}
Language
Credentials
Header
Click Try It! to start a request and see the response here!