cardRequest

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

Several attributes are required for creating a token:

Table 1. 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
paymentToken

Unique identifier (token) associated to a payment method.

  • This identifier can either be generated by the gateway.

    In this case, this parameter is not required.

  • Or by the merchant website.

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

Requires subscription to the service "Token management via SOAP Web Services".

  string ans..64