Feensure BIN Lookup API

Feensure BIN Lookup API

The BIN Lookup API provides detailed information about a payment card using its first 6 digits (BIN). Optionally, it can estimate interchange fees depending on the subscription plan and request details.

Endpoint

POST https://api.feensure.com/lookup

Headers

  • Content-Type: application/json
  • X-API-Key: <your-api-key>

Request Body

{
  "bin": "516760",              // Required - First 6 digits of card
  "amount": 7437.12,            // Optional - Transaction amount in decimal
  "payment_type": "online"      // Optional - Enum: "online" or "retail"
}
Note:
  • bin must be a 6-digit numeric string.
  • amount is optional but required to receive estimated_interchange_value.
  • payment_type is optional. Acceptable values: online, retail.

Successful Response

{
  "bin": "516760",
  "brand": "MASTERCARD",
  "category": "WORLD BUSINESS",
  "type": "DEBIT",
  "product_name": "Mastercard Business Debit",
  "bank_details": {
    "issuer": "REVOLUT, LTD.",
    "issuer_country": "GB"
  },
  "scheme_info": {
    "business_card": true,
    "is_deferred": false,
    "is_prepaid": false,
    "is_purchasing": false,
    "is_virtual": false
  },
  "interchange_estimation": {
    "comission_rate": 1.7,
    "constant_fee": 0,
    "currency": "GBP",
    "estimated_interchange_value": 126.43
  }
}
Note: The interchange_estimation object is only available for customers on the Cost Saver plan or higher.
estimated_interchange_value is only included if amount is provided in the request.

Error Responses

{
  "error": "Missing required field: bin"
}
{
  "error": "Invalid API Key"
}

Support

If you need help integrating this API, please contact support@feensure.com.