Data Dictionary
Field | Type | Description | Example |
---|---|---|---|
BinMin | string | The minimum account number for this BIN's assigned account number range. | 4429310000000000 |
BinMax | string | The maximum account number for this BIN's assigned account number range. | 4429319999999999 |
BinLength | nullable int | The length of the BIN (typically 4, 6, or 8). | 6 |
CleanBankName | string | Normalized bank name that has been formatted to proper case, removes unnecessary punctuation and misspellings, and spells out uncommon banking acronyms. | American Federal Credit Union |
ProductName | string | The name of the card product. | Mastercard Prepaid Gold Payroll |
CardBrand | string | The primary card network that can process this card. | Visa |
CountryAlpha2 | string | Two letter country code representing the issuing country; Alpha 2 code meets the ISO3166 standards. | US |
CountryName | string | Country in which the issuing bank resides. | United States |
CountryNumeric | string | Numeric country code representing the issuing country; the numeric country code meets ISO 3166 standards. | 840 |
Type | string | Type of Payment Card. | Debit |
BankName | string | Name of Issuing Bank. | Bank of America National Association |
BankUrl | string | URL of issuing bank website. | https://www.bankofamerica.com |
BankPhone | string | Phone number of issuing bank. | 180004321000 |
ProductCode | string | The card product ID according to the card brand. | MGP |
Prepaid | nullable boolean | Prepaid card type indicator. | True |
Regulated | nullable boolean | Indicator of the presence of an interchange regulation on a BIN. | False |
RegulatedName | string | The name of the interchange regulation. | GOVERNMENT NON-EXEMPT INTERCHANGE FEE (WITH FRAUD) |
Reloadable | nullable boolean | (Visa-only field) Indicator of reloadable or non-reloadable prepaid | True |
PanOrToken | string | Indicates if an account number is a network token. | False |
AccountUpdater | nullable boolean | (Visa-only field) Visa Account Updater (VAU) enabled. | True |
Alm | nullable boolean | (Visa-only field) Indicator of a BIN or Account Range participating in Account Level Management. | False |
DomesticOnly | nullable boolean | (Visa-only field) Domestic-only BIN can only be used within the country in which the card was issued. | False |
GamblingBlocked | nullable boolean | (Visa-only field) Indicator that this BIN is not permitted to be used for online gambling. | False |
Level2 | nullable boolean | (Visa-only field) Indicator of Level 2 interchange rate eligibility. | False |
Level3 | nullable boolean | (Visa-only field) Indicator of Level 3 interchange rate eligibility. | False |
IssuerCurrency | string | The currency that was issued to this BIN to transact in. | usd |
CardSegmentType | string | Indicates if card is a consumer card or commercial card. | Consumer |
ComboCard | string | Indicator for a card that has combined card type capabilities. | credit and prepaid |
CardBrandIsAdditional | nullable boolean | Set to false if the BIN range is associated with a primary card network and set to true if associated with a secondary network. Primary networks are Visa, Mastercard, Discover, Amex, JCB, or UnionPay. The secondary is typically a pinless debit network or a regional brand (e.g. Star, NYCE, ETPOS, Dankort, Carte Bancaire, etc.) note that secondary network's typically provide less in their BIN data. If multiple networks share a BIN range and all have card_brand_is_additional set to false, the primary network will be Visa, Mastercard, Discover, Amex, JCB, or UnionPay. | False |
CorrelationId | string | ID that maps a BIN range to a specific network file; used for troubleshooting. | eyJGaWxlSWQiOjE0NDUsIlZlcnNpb24iOjEwfQ== |
SharedBin | nullable boolean | Set to true if BIN is shared by multiple issuers. | False |
IssuerSupportsTokenization | boolean | Set to true if the card brand data indicates the issuing bank supports network tokenization. | True |
BillpayEnabled | boolean | BIN has been enabled to make bill payments to service providers electronically, or over the internet. | True |
EcomEnabled | boolean | BIN has been enabled to make ecommerce purchases, or purchases over the internet. | True |
Cost | JSON array | Identifies associated costs by name and amount, embedded as JSON in the column | See cost fields below |
AuthenticationName | string | Name of authentication that is required. | EU PSD2 - SCA |
AdditionalCardBrands | List | List of any secondary card networks which fall into the same range as the primary card network. Are indicated by "CardBrandIsAdditional" : "true" |
Cost Fields
Field | Type | Description | Example |
---|---|---|---|
CapRegionShortName | string | An abbreviated region name where the interchange cap applies. Possible values are "Dom" and "Inter" for domestic and international, respectively. | Dom |
CapAdvaloremAmount | nullable decimal | The interchange percentage assessed, shown in decimals for the capped interchange. | 0.002 |
CapTypeName | string | The name of the regulated interchange cap. | US Durbin Regulation Debit Visa |
CapFixedAmount | nullable decimal | If a fixed or regulated interchange amount applies, the amount will be shown here. | 0.21 |
CapTypeQualifierCurrency | string | The currency of the qualified fixed_amount for the regulated or capped interchange. | usd |
CapTypeQualifierText | string | The description of the interchange cap or regulation. | US Durbin Regulation Debit Visa |
CapTypeQualifierLower | string | The minimum merchant processing volume amount limit for the interchange cap. | 101mm |
CapTypeQualifierUpper | string | The maximum merchant processing volume amount limit for the interchange cap. | 500mm |
Updated 3 days ago