cardRequest

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

Depending on the payment type (payment by token or payment by form, when the buyer enters the payment method details manually), one or several attributes are required.

Table 1. The cardRequest object
cardRequest
Attribute Required Format
number

Card number.

requires subscription to the service "Access to acquisition on the merchant website via SOAP 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 expiration 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.

Required depending on the payment method dateTime ans..64