Eligible BINs for EMI API v1.0

API Command: eligibleBinsForEMI

The Eligible Bin for EMI API (eligibleBinsForEMI) is used only when the merchant needs the EMI feature of PayU. If you are managing card details on your website, this API can tell the issuing bank of the card bin. It also provides the minimum eligible amount for a particular bank.

You can post a request using any of the following methods:

  • Request without Bank Selection: This is submitting API without bank name in var3 field.
  • Request with Bank Selection: : This is submitting API with bank name in var3 field so that you will get the details for the specified bank.

Environment

Sample request
curl -X POST "https://test.payu.in/merchant/postservice?form=2"-H "accept: application/json" -H "Content-Type: application/x-www-form-urlencoded" -d"key=JP***g&command=eligibleBinsForEMI&var1=Bin&var2=512345&hash=3c923a16606d07f12aa984487626abbc0981f540131f8bb0d24b6322c362089bbd4114d710129ce54128691956775352ac53e7d7943392959d37275c934245f2"
Sample response

Success Scenario

On successful processing from PayU, the response is similar to the following:

{
      "status": 1,
      "msg": "Details fetched successfully",
      "details": {
            "isEligible": 1,
            "bank": "AXIS",
            "minAmount": 2500
      }
}

Failure scenario

If eligibility is not found:

Array 
(
    [status] => 1
    [msg] => Details fetched successfully
    [details] => Array
(
[isEligible] => 0
) )
Response parameters
ParameterDescriptionExample
statusThis parameter returns the status of web service call. The status can be any of the following:
0 - If web service call failed.
1 - If web service call succeeded
msgThis parameter returns whether the EMI details were fetched successfully or not found.Details fetched successfully
detailsThe details of the EMI offer is displayed in a JSON format and it contains the following fields:
isEligible - This paraAny of the following values are
- 0 - If EMI offers are not available for the given card BIN.
- 1 - If EMI offers are available for the given card BIN.
bank - The name of bank that corresponds to the given card BIN
* minAmount - The minimum amount for which the EMI offer is available
{
"isEligible": 1,
"bank": "AXIS",
"minAmount": 2500
}****

Request parameters

/summary>Reference information
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
var1For JSON fields description, refer to Additional Info for General APIs

Use the following sample values while trying out the API:

Example values:

  • var1: Bin or NET
  • var2(first 6/8/9 digits of the card):
    • AXIS EMI: 4453-3410-6587-6437
    • ICICI EMI: 4808-5578-4874-1463
Language
Click Try It! to start a request and see the response here!