Verification

The Verification API allows you perform KYC processes.

Resolve Account

Confirm an account belongs to the right customer

Headers
authorization
String
Set value to Bearer SECRET_KEY
Query Parameters
account_number
String
Account Number
bank_code
String
You can get the list of bank codes by calling the List Banks endpoint
GET/bank/resolve
cURL
1#!/bin/sh
2url="https://api.paystack.co/bank/resolve?account_number=0022728151&bank_code=063"
3authorization="Authorization: Bearer YOUR_SECRET_KEY"
4
5curl "$url" -H "$authorization" -X GET
Sample Response
200 Ok
1{
2 "status": true,
3 "message": "Account number resolved",
4 "data": {
5 "account_number": "0022728151",
6 "account_name": "WES GIBBONS"
7 }
8}

Validate Account

Confirm the authenticity of a customer's account number before sending money

Headers
authorization
String
Set value to Bearer SECRET_KEY
content-type
String
Set value to application/json
Body Parameters
account_name
String
Customer's first and last name registered with their bank
account_number
String
Customer’s account number
account_type
String
This can take one of: [ personal, business ]
bank_code
String
The bank code of the customer’s bank. You can fetch the bank codes by using our List Banks endpoint
country_code
String
The two digit ISO code of the customer’s bank
document_type
String
Customer’s mode of identity. This could be one of: [ identityNumber, passportNumber, businessRegistrationNumber ]
document_number
String
Customer’s mode of identity number
Show optional parameters
POST/bank/validate
cURL
1#!/bin/sh
2url="https://api.paystack.co/bank/validate"
3authorization="Authorization: Bearer YOUR_SECRET_KEY"
4content_type="Content-Type: application/json"
5data='{
6 "bank_code": "632005",
7 "country_code": "ZA",
8 "account_number": "0123456789",
9 "account_name": "Ann Bron",
10 "account_type": "personal",
11 "document_type": "identityNumber",
12 "document_number": "1234567890123"
13}'
14
15curl "$url" -H "$authorization" -H "$content_type" -d "$data" -X POST
Sample Response
200 Ok
1{
2 "status": true,
3 "message": "Personal Account Verification attempted",
4 "data": {
5 "verified": true,
6 "verificationMessage": "Account is verified successfully"
7 }
8}

Resolve Card BIN

Get more information about a customer's card

Path Parameters
bin
String
First 6 characters of card
GET/decision/bin/:bin
cURL
1#!/bin/sh
2url="https://api.paystack.co/decision/bin/539983"
3authorization="Authorization: Bearer YOUR_SECRET_KEY"
4
5curl "$url" -H "$authorization" -X GET
Sample Response
200 Ok
1{
2 "status": true,
3 "message": "Bin resolved",
4 "data": {
5 "bin": "539983",
6 "brand": "Mastercard",
7 "sub_brand": "",
8 "country_code": "NG",
9 "country_name": "Nigeria",
10 "card_type": "DEBIT",
11 "bank": "Guaranty Trust Bank",
12 "linked_bank_id": 9
13 }
14}