Bin Details

June 5, 2026 ยท View on GitHub

Bank Identification Number (BIN) details used to fund a payment.

Structure

BinDetails

Fields

NameTypeTagsDescriptionGetterSetter
BinStringOptionalThe Bank Identification Number (BIN) signifies the number that is being used to identify the granular level details (except the PII information) of the card.

Constraints: Minimum Length: 1, Maximum Length: 25, Pattern: ^[0-9]+$
String getBin()setBin(String bin)
IssuingBankStringOptionalThe issuer of the card instrument.

Constraints: Minimum Length: 1, Maximum Length: 64
String getIssuingBank()setIssuingBank(String issuingBank)
BinCountryCodeStringOptionalThe two-character ISO 3166-1 code that identifies the country or region. Note: The country code for Great Britain is GB and not UK as used in the top-level domain names for that country. Use the C2 country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.

Constraints: Minimum Length: 2, Maximum Length: 2, Pattern: ^([A-Z]{2}|C2)$
String getBinCountryCode()setBinCountryCode(String binCountryCode)
ProductsList<String>OptionalThe type of card product assigned to the BIN by the issuer. These values are defined by the issuer and may change over time. Some examples include: PREPAID_GIFT, CONSUMER, CORPORATE.

Constraints: Minimum Items: 1, Maximum Items: 256, Minimum Length: 1, Maximum Length: 255
List getProducts()setProducts(List products)

Example (as JSON)

{
  "bin": "bin0",
  "issuing_bank": "issuing_bank0",
  "bin_country_code": "bin_country_code4",
  "products": [
    "products8",
    "products9",
    "products0"
  ]
}