/v1/cards

Card bin lookup

Changed on

Returns card information based on the BIN (Bank Identification Number).

post/v1/cards/bin

Request

  • Base URL
    https://api.sandbox.datatrans.com
  • URL
    https://api.sandbox.datatrans.com/v1/cards/bin
  • Auth
    HTTP basic

Request body

binstring required

The BIN (Bank Identification Number), must be numeric and 6 to 8 digits long

Response

BIN successfully processed

brandstring

The brand of the credit card (e.g. VISA CREDIT).

coBrandstring

The coBrand of the card

type'CREDIT' | 'DEBIT' | 'PREPAID'

The type of the card (CREDIT, DEBIT or PREPAID). The property will not be present if the card type is unknown.

usage'CONSUMER' | 'CORPORATE'

The usage of the card (CONSUMER, CORPORATE)

countrystring

2 letter ISO 3166-1 alpha-2 country code

issuerstring

The issuer of the card

accountType'PAN' | 'TOKEN'

Indicates how the card is identified: PAN (the actual card number) or TOKEN (a tokenized surrogate, such as a network or device token).

binLengthinteger

The bin length, if known.

Changes

    • warning

      added the new CONCURRENT_LIMIT_REACHED enum value to the / response property for the response status

    • warning

      added the new NOT_FOUND enum value to the / response property for the response status