cardRequest

The cardRequest object allows to transmit information related to the payment card.

Several attributes are required for creating a token:

Attribute Required Format
number

Card number.

requires subscription to “Access to acquisition on the merchant website via Web Services”

string
scheme

Card types.

The possible values are AMEX, CB, MASTERCARD, VISA, VISA_ELECTRON, VPAY, MAESTRO, E-CARTEBLEUE or JCB.

string
expiryMonth

Card expiry month, between 1 and 12.

n..2
expiryYear

Card expiry year in 4 digits.

Example: 2016

n4
cardSecurityCode

Card Security Code code in 3 digits (or 4 for Amex).

This field is mandatory if the card has a Card Security Code. If the Card Security Code is not transmitted, the issuing bank will refuse the payment.

However, this parameter is optional when the source of the transaction is set to MOTO

  string
cardHolderBirthday

Cardholder’s birth date in the YYYY-MM-DD format.

This field is mandatory for the COFINOGA payment method except is a 3D Secure authentication is made.

Required according to the payment method dateTime ans..64
paymentToken

Unique identifier (token) associated with a payment method.

  • This identifier can be generated by the payment gateway.

    In this case, this parameter must not be populated.

  • Otherwise, it can be generated by the merchant website.

    In this case, this parameter must be populated with the desired value of the identifier. Warning, the merchant website must make sure that each identifier is unique. Any registration request containing an existing identifier will be rejected and will provoke an error message.

Requires subscription to “Token management via Web Services”.

  string ans..64