💳

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.
Method Parameters
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
Tells the API to return the response as a callback function (Check out Callback section).
mode
Lets you use our Development Environment to test the API without affecting your available requests (Learn more).
All parameters with (*) are required.
Sample Response
{
    "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
}
Response Possible Values
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

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	Tells the API to return the response as a callback function (Check out Callback section).
mode	Lets you use our Development Environment to test the API without affecting your available requests (Learn more).

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

Phone Number Validation

Next - METHODS

Payment Fraud Prevention

Last modified 26d ago