Overview

Parrot Batch is a file-based product that allows for bulk BIN requests and information retrieval. You can use Parrot 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. Parrot Batch is an in-house alternative to requesting directly from our database via the Parrot API.

📘

Getting Started

Contact us to get started with Parrot Batch.

How Parrot Batch Works

Parrot Batch v3

If you're using Parrot Batch v3, complete the following basic steps to update your BIN data:

1. You'll request a copy of the BIN database for use in your local environment.
2. We'll return a file with bank and market information for every BIN.
3. 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.
4. Parrot Batch will 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 v1 & v2

If you're using Parrot Batch v1 or v2, complete the following basic steps to update your BIN data:

1. You'll request a copy of the BIN database for use in your local environment.
2. We'll return a file with bank and market information for every BIN.
3. 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.
4. Repeat the process as often as you need new BIN data.

We update our BIN data weekly and will notify you of changes to the database based on the version you have.

📘

Keep in mind

BIN data isn’t stagnant. To conduct the most reliable analysis on transaction failures, real time transaction logic, and workflow management, update your BIN data at least once every two weeks.

Parrot Batch v3 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—Parrot Batch v3 similarly shares BIN details in ranges between a min and max value.

If you're using Parrot Batch v3, you'll need to 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 v3 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 have identical BIN ranges. When this happens, you'll see two rows in the Parrot Batch v3 file with identical bin_min and bin_max values. The responses in other fields, such as card_brand and product_name will be different.

Parrot Batch FAQ

Why are Parrot's 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, so 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?

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.