Search docs

Are you looking for test card numbers?

Would you like to contact support?

Start searching Adyen's documentation...

  Documentation

CardData

Definition: Information related to the payment card used for the transaction.

Usage: Allows acquisition of the card data by the Sale System before the Payment, CardAcquisition or BalanceInquiry request to the POI. It could also be sent in the CardAcquisition response, to be processed by the Sale System.

Type: defined data structure

Component Required Type Description Rule

PaymentBrand

Conditional

String

Type of payment card.

If card PAN is readable .

MaskedPan

Conditional

String

 

 

PaymentAccountRef

Conditional

String

 

 

Conditional

Cluster

Entry mode of the payment instrument information.

Mandatory in the request.

CardCountryCode

Conditional

DigitString

Country Code attached to the card (3 numerics).

If available in the card.

The length of the string must be exactly 3

ProtectedCardData

Conditional

ContentInformation

Sensitive information related to the payment card, protected by CMS.

SensitiveCardData protected by CMS EnvelopedData.

Conditional

Defined datastructure

Sensitive information related to the payment card, entered or read by the Sale System.

If structure non empty and unprotected.

AllowedProductCode

Required Array

DigitString

Product codes that are payable by the payment card.

If not all the products are accepted for the payment card proposed by the Customer. In this case, Result is failure, ErrorCondition is Payment Restriction. For One Time Reservation, the POI can send product codes payable by the payment, even if the POI did not send SaleItem in the request. If at least one product sent in the request is accepted, the Result is Success.

The length of the string must be greater than or equal to 1 and less than or equal to 20

Required Array

Defined datastructure

Product that is payable by the payment card.

 

Conditional

Defined datastructure

Surrogate of the PAN (Primary Account Number) of the payment card to identify the payment mean of the customer. It allows, for a merchant, to identify the customer.

Restriction of product payable by a card.

Required Array

Defined datastructure

Customer order attached to a customer, recorded in the POI system. Allows the management of customer orders by the POI, for instance in a multi-channel or a click and collect sale transaction.