Getting Started with BIN Data Batch
Overview
Pagos BIN Data Batch is a file-based product that allows for bulk BIN requests and information retrieval. You can use BIN Data Batch to efficiently retrieve BIN bank and market details via a file you add into your local database—thereby integrating BIN data with any bank or customer analysis you conduct. Batch is an in-house alternative to requesting directly from our database via the Pagos BIN Data API.
Contact us to get started with Batch.
Updating the BIN Data Batch file
Every Tuesday at 00:00 UTC, Pagos generates and publishes a new batch file with the most up-to-date BIN data from the card networks. You can request this updated file via the BIN Data Batch API.
If you prefer a no-code method for downloading the Batch file, navigate to the Batch tab in the BIN Data section of your Pagos Service Panel. Learn more in our BIN Data guide.
BIN Data Batch Ranges
When networks issue cards, they generate BINs in ranges. All BINs issued within a set range will share flags indicating card currency, card type (e.g. prepaid, reloadable, etc.), local only, gambling enabled/not supported, etc. Because these flags are set at the range level—not the individual BIN level—Batch BIN Data similarly shares BIN details in ranges between a min and max value.
Design your search logic to search for a BIN value within a given range. For example, if you want to review details for BIN 464565, you’d generate the 19-digit value for a card number, padded with zeros; you’d then search for all the rows where the card number 4645650000000000000 is between the bin_min and the bin_max.
Overlapping BIN Ranges
In the Batch file, it’s possible for a BIN to appear in two overlapping BIN ranges. This typically indicates one of the following:
-
The provided BIN is too wide of a range and more digits are required to narrow the results (e.g. the six-digit BIN is in two BIN ranges, but the eight-digit BIN is only in one)
-
The given BIN has both a primary and secondary card brand associated with it. The primary card brand for the BIN will be one of the main card brands—Visa, Mastercard, Amex, and Discover; the secondary is typically a pinless debit network or a regional brand (e.g. ETPOS, Dankort, Carte Bancaire).
If a BIN appears in two overlapping ranges—where one range is smaller and fully contained within a larger one—use the details from the more specific (smaller) range.
Larger Range (overlapping): 6229330000000000000 - 6237969999999999999, UNIONPAY, CN Smaller Range (single): 6233550000000000000 - 6233559999999999999, UNIONPAY, TH
Identical BIN Ranges
It’s possible for two networks to have identical BIN ranges. When this happens, you’ll see two rows in the Batch file with identical bin_min and bin_max values. The responses in other fields, such as card_brand and product_name will be different.
BIN Data Batch FAQ
Why are Batch responses different from my current BIN list provider's responses?
Why are Batch responses different from my current BIN list provider's responses?
Pagos receives BIN data directly from the card brands. As such, our response data is accurate and up-to-date according to the latest card brand records. Because other BIN providers may receive their data from third party sources outside of the card brands, we can’t speak to the accuracy of their responses.
Can a BIN range with the Card Type of 'Credit' have a Card Product name that indicates a debit card?
Can a BIN range with the Card Type of 'Credit' have a Card Product name that indicates a debit card?
Yes. Some card brands issue cards marked as debit, but with a funding source that’s actually credit. This is typical of corporate or professional cards where the credit line can be used despite the card product name indicating it’s debit. Examples include Debit Mastercard BusinessCard and Debit Mastercard Professional Card.