Validate Bank Account

Endpoint to validate bank account details for payouts.

Request:

Field	Type	Description
nuban	String(Digits)	Unique bank account number
code	String(Digits)	Unique bank code the list of supported banks
currency	String	Three letters ISO currency code e.g ngn

Example request

cURL

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

Response:

Field	Type	Description
status	Boolean	States if request was successfully executed or not
code	Integer	Internal code, success if 200
msg	String	A description of the status of the request
data	JSON	Account details of validated bank account

Example response

JSON

{
    "status": true,
    "code": 200,
    "msg": "Bank Validated",
    "data": {
        "accountNumber": "0011678314",
        "accountName": "SALAMI MURITALA OLAYIWOLA",
        "bankCode": "000013",
        "bankName": "GUARANTY TRUST BANK"
    }
}