Add BIN

The Bank Identification Number (BIN) refers to the 6 or 8 digits of a card’s Primary Account Number (PAN). This set of numbers identifies the issuing institution of the card. All payment cards come with a BIN.

BINs must exist before you can create card products.

Use case

Here we will create a new BIN with the Mastercard scheme.

Use case data	API parameters with values
BIN number	"binNumber": "555678"
Product scheme	"productScheme": "MASTERCARD"
Card processor	"processor": "NETS"

Sample API call

To create the BIN, use the following endpoint:

https://card-api.sandbox.tuumplatform.com/api/v1/bin

Learn more about the add BIN endpoint in the Tuum developer portal.

Sample request

The sample request body is as follows:

JSON

{
  "binNumber": "555678",
  "productScheme": "MASTERCARD",
  "processor": "NETS",
  "tenantCode": "MB"
}

cURL

Sample response

Below you will find the response to the sample request:

Response

{
  "errors": null,
  "validationErrors": null,
  "data": {
    "binId": "C001664282456",
    "binNumber": "555678",
    "productScheme": "MASTERCARD",
    "statusCode": "ACTIVE",
    "processor": "NETS",
    "reason": null,
    "tenantCode": "MB"
  }
}

Result

The BIN is added to the system with the ACTIVE status. An ID is automatically assigned to the BIN.