Sign in

v1

latestOpenAPI 3.1.02026-07-2022194782.1 KB
Payments

Get the brands and other details of a card

Use this endpoint to get information about the card or network token that enables you to decide on the routing of the transaction and the eligibility of the card for the type of transaction.

If you include your supported brands in the request, the response also tells you if you support each brand that was identified on the card.

If you have an API-only integration and collect card data, use this endpoint to find out if the shopper's card is co-bad. For co-badged cards, you must let the shopper choose the brand to pay with if you support both brands.

Server-side API libraries

We provide open-source server-side API libraries in several languages:

  • PHP
  • Java
  • Node.js
  • .NET
  • Go
  • Python
  • Ruby
  • Apex (beta)

See our integration examples for example uses of the libraries.

Developer resources

BIN Lookup API is available through a Postman collection. Click the button below to create a fork, then set the environment variables at Environments > Adyen APIs.

Run in Postman

post/cardDetails

Headers

Idempotency-Keystring

A unique identifier for the message with a maximum of 64 characters (we recommend a UUID).

Request body

cardNumberstring

A minimum of the first six digits of the card number. The full card number gives the best result.

You must be fully PCI compliant to collect raw card data. Alternatively, you can use the encryptedCardNumber field.

countryCodestring

The shopper country code.

Format: ISO 3166-1 alpha-2 Example: NL or DE

encryptedCardNumberstring

The encrypted card number.

merchantAccountstring required

The merchant account identifier, with which you want to process the transaction.

supportedBrandsstring[]

The card brands you support. This is the brands array from your /paymentMethods response.

If not included, our API uses the ones configured for your merchant account and, if provided, the country code.

Response

OK - the request has succeeded.

fundingSourcestring

The funding source of the card, for example DEBIT, CREDIT, or PREPAID.

isCardCommercialboolean

Indicates if this is a commercial card or a consumer card. If true, it is a commercial card. If false, it is a consumer card.

issuingCountryCodestring

The two-letter country code of the country where the card was issued.