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

curl -X 'POST' \
  'https://card-api.sandbox.tuumplatform.com/api/v1/bin' \
  -H 'accept: application/json' \
  -H 'x-channel-code: SYSTEM' \
  -H 'x-tenant-code: MB' \
  -H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHBpcnlEVGltZSI6IjIwMjMtMDYtMjhUMTg6MTk6MDEiLCJyb2xlcyI6WyJBRE1JTiJdLCJuYW1lIjoiSm9obiBPZmZpY2VyIiwiZW1wbG95ZWVJZCI6IjEiLCJ0ZW5hbnRDb2RlIjoiTUIiLCJleHAiOjE2ODc5NzYzNDF9.kjxE2BGzG81mCLf8rvhqXG6k_J9VqT9PGAXhSbJNexM' \
  -H 'Content-Type: application/json' \
  -d '{
  "binNumber": "555678",
  "productScheme": "MASTERCARD",
  "processor": "NETS",
  "tenantCode": "MB"
}'

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.