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/v52/cardDetails
Click to copy

Header Parameters

Idempotency-Keystring

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

Request Parameters

cardNumberstringRequired

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.

countryCodestring

The shopper country.

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

encryptedCardNumberstring
Max length: 15000

The encrypted card number.

merchantAccountstringRequired

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

supportedBrandsarray[string]

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 moreShow less