💳
BIN/IIN Validation
Lookup/Validate Bank Identification Numbers of your customers
The IIN (Issuer Identification Number), also known as the BIN (Bank Identification Number), is the first 6 digits of a debit or credit card number. These unique numbers are used to identify the issuing entity, such as the bank or financial institution that issued the card.
By using this module, you can easily fetch the complete data associated with a card, including its type (debit or credit), schema (Visa, Mastercard, etc.), brand (gold, platinum, etc.), bank details, and more. This information can be used for a variety of purposes, such as verifying a customer's payment details, detecting fraudulent transactions, and providing personalised services to your users.
One of the most common and critical use cases of this method is to detect and prevent fraud payments in your app or website. This is an essential task for any business that accepts online payments, as fraud can lead to significant financial losses and reputational damage.
For example, if you notice a user from the UK purchasing large amounts of your product, and the card used for payment is issued by a bank located in the US, this could be a red flag. This may indicate that the user is using a stolen or fraudulent card to complete the checkout process. By flagging such transactions for review or rejection, you can prevent fraud and protect your business from financial loss.
get
https://gregeoip.com
/BINLookup
Method endpoint.
Here's a list of all parameters can be used for this method:
Parameter | Description |
---|---|
key * | Your API Key . |
bin * | The BIN/IIN of the card (min: 6 digits). Sample values:
456789 456789XXXXXX1234 4567891234567890 |
format | The format of the API response.
( JSON , XML , CSV or Newline ) |
callback | |
mode | Lets you use our Development Environment to test the API without affecting your available requests (Learn more). |
All parameters with (*) are required.
{
"data": {
"reason": "",
"isValid": true,
"info": {
"scheme": {
"name": "Visa",
"coName": "Mada",
"isLuna": true,
"isPrepaid": false,
"isCommercial": false,
"type": "debit",
"brand": "Traditional",
"currency": "SAR"
},
"detected_digits": "4",
"syntax": {
"gaps": [
4,
8,
12
],
"lengths": [
16,
18,
19
],
"code": {
"name": "CVV",
"size": 3
}
},
"bank": {
"id": "588847",
"name": "AL RAJHI BANKING AND INVESTMENT CORP.",
"city": "Riyadh",
"url": "https://www.alrajhibank.com.sa",
"phone": "+96611211600",
"latitude": "25",
"longitude": "45"
},
"country": {
"alpha2": "SA",
"name": "Saudi Arabia",
"code": "966",
"numeric": "682",
"emoji": "🇸🇦",
"continent": "Asia",
"languageCode": "ar",
"languageNative": "العربية"
}
}
},
"status": "success",
"executionTime": 2
}
Key | Values |
---|---|
data.reason | String (empty if status is success ) |
data.isValid | Boolean |
data.info.scheme.name | String |
data.info.scheme.coName | String |
data.info.scheme.isLuna | Boolean |
data.info.scheme.isPrepaid | Boolean |
data.info.scheme.isCommercial | Boolean |
data.info.scheme.type | String |
data.info.scheme.brand | String |
data.info.scheme.currency | String |
data.info.detected_digits | String |
data.info.syntax.gaps | Array |
data.info.syntax.lengths | Array |
data.info.syntax.code.name | String |
data.info.syntax.code.size | Integer |
data.info.bank.id | String |
data.info.bank.name | String |
data.info.bank.city | String |
data.info.bank.url | String |
data.info.bank.phone | String |
data.info.bank.latitude | String |
data.info.bank.longitude | String |
data.info.country.alpha2 | String |
data.info.country.name | String |
data.info.country.code | String |
data.info.country.numeric | String |
data.info.country.emoji | String |
data.info.country.continent | String |
data.info.country.languageCode | String |
data.info.country.languageNative | String |
Last modified 26d ago