Getting Started with Parrot Batch BIN Data
Overview
Parrot Batch BIN Data is a file-based product that allows for bulk BIN requests and information retrieval. You can use Parrot Batch BIN Data 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. Batched BIN Data is an in-house alternative to requesting directly from our database via the Pagos BIN Data API.
Contact us to get started with Parrot Batch.
How Parrot Batch BIN Data Works
Complete the following basic steps to update your batch BIN Data:
-
You’ll request a copy of the BIN database for use in your local environment.
-
We’ll return a file with bank and market information for every BIN.
-
Retrieve bulk BIN data and add this file to your database. Now you have a local copy of the most up-to-date BIN information.
-
We’ll generate and publish a new weekly file every Tuesday at 12:00 UTC, so you can repeat the process as often as you would like.
Parrot Batch BIN Ranges
When networks issue cards, they generate BINs in ranges. All BINs issued within a set range will share flags indicating card currency, cart 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 Parrot Batch BIN Data 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).
Identical BIN Ranges
It’s possible for two networks to have identical BIN ranges. When this happens, you’ll see two rows in the Parrot Batch BIN Data file with identical bin_min and bin_max values. The responses in other fields, such as card_brand and product_name will be different.