Unfortunately, this feature is not supported on mobile devices. For the best experience, please use a computer.
Access Worldpay
/
Card BIN Data

Card BIN Data (1)

The Card BIN Data API provides detailed information about a card.

Developer Documentation
Download OpenAPI description
openapi.json
openapi.yaml
Overview
License Worldpay
Languages
Servers
Mock server
https://developer.worldpay.com/_mock/products/access/card-bin/openapi/
Try
https://try.access.worldpay.com/api/
Live
https://access.worldpay.com/api/

Get BIN data

Request

Returns card BIN data for the card number or Worldpay token supplied.

Headers
WP-Api-Versioninteger>= 1required

The API version

Example:

1

Bodyapplication/jsonrequired

Lookup details

One of:

Lookup details

merchantobjectrequired

An object that contains information about the merchant and API level configuration.

entitystring[ 1 .. 64 ] characters^[A-Za-z0-9]*$required

Used to route the request in Access Worldpay, created as part of on-boarding.

Example:

"default"

cardNumberstring^\d{12,19}$required

The Primary Account Number (PAN).
Supports full card numbers and network tokens.

Example:

4444333322221111

application/json
{
  "merchant": {
    "entity": "default"
  },
  "cardNumber": "4444333322221111"
}

Responses

Request Successful

Headers
WP-CorrelationIdstring

Generated identifier for the request and response. When contacting support please include this.

Example:

"4c195ce9-3dbd-4bc8-9c94-3d3393842323"

WP-Api-Versionstring

The complete API Version is returned in the WP-Api-Version HPP Header. It contains the Major, Minor and Patch details of API Version.

Example:

"1.1.20240411"

Bodyapplication/json
typestring

The type of account number provided

Enum"pan""networkToken"
Example:

"pan"

brandArray of strings

Brand of the card

Items Enum"airplus""allstar""amex""argencard""aurore""bc""cabal""carnet""cartesBancaires""cencosud"
Example:

"visa"

binstring

Bank Identification Number

Example:

444422

binLengthinteger

Length of the BIN

Example:

6

fundingTypestring

Funding source of the card

Enum"credit""debit""prepaid""chargeCard""deferredDebit"
Example:

"credit"

issuerNamestring

Card issuer name

Example:

"Bank of America"

countryCodestring

Card issuer country, ISO alpha-2 or unknown

Example:

"US"

currencystring

Currency of the card, ISO alpha-3

Example:

"USD"

dccAllowedboolean

Is Dynamic Currency Converstion (DCC) permitted

Example:

true

anonymousPrepaidstring

Anonymous prepaid program and AMLD5 compliance

Enum"anonymousNonCompliant""anonymousCompliant""notPrepaidOrNonAnonomous""unknown"
Example:

"notPrepaidOrNonAnonomous"

categorystring

Card category

Enum"commercial""consumer"
Example:

"consumer"

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