BIN Setup
How to create BINs, BIN ranges, and sub-BIN ranges for card number allocation before product configuration.
A Bank Identification Number (BIN) is the 6-digit prefix assigned by the card network (Visa, Mastercard, RuPay). BIN ranges define the card number ranges available for issuance under each BIN.
BIN and BIN Range must be created before any product. Products are mapped to BIN ranges at creation time and cannot be retroactively linked.
Setup Flow
Create a BIN
Register the BIN number allocated by the card network.
Navigate to Configuration → BIN Management → Create BIN and fill in the BIN details.
POST /v1/bins/| Parameter | Type | Required | Description |
|---|---|---|---|
binNumber | string | Yes | 6-digit BIN from card network |
network | string | Yes | VISA, MASTERCARD, or RUPAY |
cardType | string | Yes | PREPAID |
issuerName | string | Yes | Issuing bank/institution name |
issuerCountry | string | Yes | ISO country code (e.g., IN) |
status | string | Yes | ACTIVE |
binLength | integer | Yes | 6 |
Create a BIN Range
Define the card number range available for issuance under the BIN.
Example: BIN 650527 → Range 6505270000000001 to 6505270000099999 = 100,000 cards.
Navigate to Configuration → BIN Ranges → Create BIN Range and map it to the BIN.
POST /v1/bin-ranges/| Parameter | Type | Required | Description |
|---|---|---|---|
binNumber | string | Yes | The 6-digit BIN to associate with |
rangeStart | string | Yes | Start of card number range (16 digits) |
rangeEnd | string | Yes | End of card number range (16 digits) |
totalCards | integer | Yes | Total cards in this range |
status | string | Yes | ACTIVE |
cardVendor | string | Yes | Card vendor / manufacturer name |
plasticType | string | Yes | STANDARD or PREMIUM |
Create Sub-BIN Ranges (Optional)
Segment card numbers for different programs under the same BIN.
POST /v1/add/bin-ranges| Parameter | Type | Required | Description |
|---|---|---|---|
parentBinRangeId | string | Yes | Parent BIN range ID |
subRanges | array | Yes | Array of sub-range objects |
subRanges[].programName | string | Yes | Name of the card program |
subRanges[].rangeStart | string | Yes | Start of sub-range |
subRanges[].rangeEnd | string | Yes | End of sub-range |
subRanges[].totalCards | integer | Yes | Cards in this sub-range |
Example: Split a 100K range into 50K for employee cards and 50K for gift cards.
BIN Range Lifecycle
Monitor BIN range utilization. When a range is exhausted during issuance, you will receive PP_CORP_035 (Product BIN Range Exceeded) or PP_CORP_151 (BIN Range Completely Exhausted) errors.
Getting Started
Implementation overview, prerequisites, and step-by-step workflow for launching a prepaid card or digital wallet program on M2P Platform.
Product Configuration
Step-by-step product configuration guide — product types, KYC settings, wallet limits, transaction limits, and notification setup.