Get the list of brands on the card

post /cardDetails

Send a request with at least the first 6 digits of the card number to get a response with an array of brands on the card. If you include your supported brands in the request, the response also tells you if you support each brand that was identified.

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

Endpoint destination URL

https://checkout-test.adyen.com/v69/cardDetails
Click to copy

Header parameters

Idempotency-Key string

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

Request parameters

cardNumber string Required

A minimum of the first 8 digits of the card number and a maximum of the full card number. 11 digits gives the best result.

You must be fully PCI compliant to collect raw card data.

countryCode string

The shopper country.

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

merchantAccount string Required

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

supportedBrands [string] array

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 parameters

After submitting a call, you receive a response message to inform you that your request was received and processed.

Depending on the HTTP status code of the response message, it is helpful to build some logic to handle any errors that a request or the system may return.

HTTP Responses

  • 200 - OK

    The request has succeeded.

    Show more Show less
  • Request
  • Click to copy
  • Response
  • Click to copy