Unfortunately, this feature is not supported on mobile devices. For the best experience, please use a computer.

Card BIN Data (20230808)

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

Download OpenAPI description
Overview
License Worldpay
Languages
Servers
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:

"MindPalaceLtd"

cardNumberstring^\d{12,19}$required

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

Example:

4444333322221111

application/json
{ "merchant": { "entity": "MindPalaceLtd" }, "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" }