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

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

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
Show optional 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

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

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

1#!/bin/sh
2url="https://api.paystack.co/decision/bin/539983"
3authorization="Authorization: Bearer YOUR_SECRET_KEY"
4
5curl "$url" -H "$authorization" -X GET

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}