Bin Details
June 5, 2026 ยท View on GitHub
Bank Identification Number (BIN) details used to fund a payment.
Structure
BinDetails
Fields
| Name | Type | Tags | Description | Getter | Setter |
|---|---|---|---|---|---|
Bin | String | Optional | The 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) |
IssuingBank | String | Optional | The issuer of the card instrument. Constraints: Minimum Length: 1, Maximum Length: 64 | String getIssuingBank() | setIssuingBank(String issuingBank) |
BinCountryCode | String | Optional | The 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) |
Products | List<String> | Optional | The 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 | setProducts(List |
Example (as JSON)
{
"bin": "bin0",
"issuing_bank": "issuing_bank0",
"bin_country_code": "bin_country_code4",
"products": [
"products8",
"products9",
"products0"
]
}