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. 

In this case, the card or type of card has to be configured to have this behaviour. It is then expected that for this card the information sent in response to the payment are the same for the CardAcquisition response. Data that could be protected in the response are grouped in the data structure SentitiveCardData. In BalanceInquiryResponse and CardAcquisitionResponse, AllowedProduct may be provided for card with retsrictions on products. 

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.