Card BIN Data

The Card BIN Data API provides detailed information about a card allowing you to:

• optimize your checkout experience
• reduce risk
• comply with regulations

Requesting Card BIN Data

You can request card BIN data using Card Number or a Worldpay Token. Please see our API Reference for full details.

Card Number

Request BIN data using the full card number. To use this option you must ensure you are PCI Compliant.

Request example

{
"merchant": {
"entity": "MindPalaceLtd"
},
"cardNumber": "4444333322221111"
}

Response example

If the request is successful you will receive a 200 response which will include the Card BIN data.

{
"type": "pan",
"brand": [
"visa"
],
"bin": "444433",
"binLength": 6,
"fundingType": "debit",
"issuerName": "Bank of America",
"countryCode": "US",
"currency": "USD",
"dccAllowed": true,
"anonymousPrepaid": "notPrepaidOrNonAnonomous",
"category": "consumer"
}

Worldpay Token

Request BIN data using a Worldpay Token.

Request example

{
"merchant": {
"entity": "MindPalaceLtd"
},
"token": "https://access.worldpay.com/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0NzI0NE1rdUtjMUFJdjYxVnlibWZuUT0ifQ"
}

Response example

If the request is successful you will receive a 200 response which will include the Card BIN data.

{
"type": "pan",
"brand": [
"visa"
],
"bin": "444433",
"binLength": 6,
"fundingType": "debit",
"issuerName": "Bank of America",
"countryCode": "US",
"currency": "USD",
"dccAllowed": true,
"anonymousPrepaid": "notPrepaidOrNonAnonomous",
"category": "consumer"
}

Testing

You can use any valid card to verify your implementation in Try.