Card Bin
This API enables developers to verify the first six digits of a credit or debit card number known as the Bank Identification Number (BIN). The response provides information such as the card brand, sub-brand, issuing bank, country code, and card type.
Test Data
Number: 539941
Post
{{URL}}/identitypass/verification/card_bin
Request Header
| Key | Description |
|---|---|
| app-id | Your App ID |
| x-api-key | Your Secret Key |
Request Body
| Key | Description |
|---|---|
| Number | Bank Identification Number |
Sample Response
{
"status": true,
"response_code": "00",
"detail": "Verification Successful",
"data": {
"bin": "123456",
"brand": "mastercard",
"sub_brand": "",
"country_code": "NG",
"country_name": "Nigeria",
"card_type": "debit",
"bank": "Zenith Bank",
"currency": "NGN"
}
}
Response Description
| Response | Description |
|---|---|
| status | indicates that the request was successful |
| response_code | Represents the response code. |
| detail | Indicates the outcome of the verification process and states if the verification was successful or not. |
| data | An array containing the retrieved card information. |
| bin | Represents the Bank Identification Number (BIN) of the payment card. |
| brand | Specifies the brand of the payment card. |
| sub_brand | Refers to any sub-brand associated with the payment card. |
| country_code | Represents the two-letter country code associated with the payment card. |
| country_name | Provides the name of the country where the card is issued. |
| card_type | Specifies the type of the payment card. |
| bank | Indicates the name of the bank that issued the payment card. |
| currency | Represents the currency associated with the payment card. |
Updated 2 months ago