Get Bin Info API

API Command: getBinInfo

The Get BIN Info API or getBinInfo API is used to determine the following for a single card or multiple cards:

  • card’s issuing bank
  • card type such as, Visa, Master, etc.
  • card category such as Credit/Debit, etc.
  • cards with zero redirect support
  • cards with SI support

You can fetch cards details with the following specific feature-level information:

  • Complete BIN list having ATM PIN support is required
  • Complete BIN list with OTP-on-the-fly support (IVR) is required

When fetching multiple card details, you can limit the number of card details in the response using the start index and offset.

Reference information for request parameters

ParameterReference
keyFor more information on how to generate the Key and Salt, refer to any of the following:

- Production: Generate Merchant Key and Salt
- Test: Generate Test Merchant Key and Salt
hashHash logic for this API is:
sha512(key|command|var1|salt)
sha512
var1Specify any of the following values in this field based on the output you required:

- 1: Specify this value if a single bin-level information is required. Output contains the information on a single bin only.
- 2: Specify this value if a specific feature-level information is required. Output would give the bin list.
- 3: Specify this value if all the bins and their information are required
var2The value specified in this parameter is based on any of the following var1 parameter value.

If var1 = 1, specify the bin number in the var2 parameter.

If var1 = 2, specify any of the following values:

- 1: Specify this value to get complete bin list having ATM PIN support is required
- 2: Specify this value to get complete bin list with OTP-on-the-fly support (IVR) is required
var3Specify the start index in this parameter. By default, the value will be set as 0.
var4The offset is specified in this field. This is useful when several card bins are returned and you can display number of bins per page based on the offset. By default, it is set as 100.
var5The parameter is used to check whether the Native OTP or SI is supported by the card. The is_zero_redirect_supported and is_si_supported parameters return the response for the following cases:
- If var1=1 and var5=1, two extra parameters will be sent in response:
- is_zero_redirect_supported
- is_si_supported
- If var1 is specified with the value as 2 or 3 and var5 is specified as 0 or 1, and the is_zero_redirect_supported and is_si_supported parameters will not return a response
Note: The var2 parameter value needs to be posted according to the var1 parameter value.

Response parameters

For the description of the response parameters and sample responses, refer to Additional Info for General APIs

Request parameters

Use the following sample values while trying out the API:

Example values

Language
Click Try It! to start a request and see the response here!