Access Worldpay
/
Card BIN data

Last Updated: 24 June 2024 | Change Log

Card BIN Data

New

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

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

Supported payment methods: American Express / Carte Bancaires / Discover / Diners / EFTPOS / ELO / JCB / Maestro / MasterCard / MasterCard Debit / Visa / Visa Debit / Visa Electron (UK only)

Requesting Card BIN Data

You can request card BIN data using a full card number, network token or a Worldpay token. Please see our API Reference for full details.

POST https://try.access.worldpay.com/api/cardBin/panLookup

Card Number

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

Example request

{
  "merchant": {
    "entity": "default"
  },
  "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.

Example request

{
  "merchant": {
    "entity": "default"
  },
  "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 card to verify your implementation in Try, however, please note that some API specific test cards may return different results.

See also