cardRequest

L'objet cardRequest permet de transmettre les informations sur la carte de paiement.

Selon le type de paiement (paiement avec saisie des données bancaires ou paiement par alias), un ou plusieurs attributs sont requis.

  • Paiement avec saisie des données bancaires :
Attribut Requis Format
number

Numéro de la carte.

requiert la souscription au service "Accès à l'acquisition sur site marchand via Web Services"

string
scheme

Type de carte choisi par l'acheteur.

Exemple de valeurs possibles: AMEX, CB, MASTERCARD, VISA, VISA_ELECTRON, VPAY, MAESTRO, E-CARTEBLEUE, JCB.

Pour plus de détails, consultez la Liste des types de carte supportés.

string
expiryMonth

Mois d’expiration de la carte, entre 1 et 12.

n..2
expiryYear

Année d’expiration de la carte sur 4 digits.

Exemple : 2016

n4
cardSecurityCode

Cryptogramme visuel à 3 chiffres (ou 4 pour Amex).

Ce champ est obligatoire lorsque la carte dispose d’un code cryptogramme visuel. Si le CVV n’est pas transmis, la banque émettrice refusera le paiement.

En revanche, ce champ est facultatif lorsque l'origine de la transaction est valorisée à MOTO.

  string
cardHolderBirthday

Date de naissance du porteur au format YYYY-MM-DD.

Ce champ est obligatoire pour le moyen de paiement COFINOGA excepté si une authentification 3D Secure est réalisée.

Requis selon le moyen de paiement dateTime ans..64
cardHolderName

Nom du porteur.

Ce champ correspond au nom du porteur de carte.

Obligatoire pour DECIDIR et VISANET, acquéreurs d'Amérique en Sud.

Requis selon le moyen de paiement string
proofOfIdType

Type de pièce d'identité.

Valeurs possibles :

  • DNI (= Documento Nacional de Identidad) Obligatoire pour DECIDIR.
Requis selon le moyen de paiement string
proofOfIdNumber

Numéro de pièce d'identité officielle.

Correspond au numéro de pièce d'identité du type de pièce sélectionné. Exemple : 2AZ265480.

Le format dépend du type de pièce d'identité et est de 7 à 13 caractères, chiffres, lettres et/ou points.

Obligatoire pour DECIDIR.

Requis selon le moyen de paiement an..13
walletPayload

Permet de transmettre une payload chiffrée lors d'un paiement par wallet (ApplePay, GooglePay, etc...).

Requiert la souscription au service "Transmission des données de paiement chiffrées par Web Services SOAP".

  json
  • Paiement utilisant un alias existant :
Attribut Requis Format
paymentToken

Identifiant unique (alias) associé à un moyen de paiement.

  • Soit cet identifiant a été généré par la plateforme.
  • Soit cet identifiant a été généré par le site marchand.

Requiert la souscription au service "Paiement par alias".

string ans..64
cardSecurityCode

Cryptogramme visuel à 3 chiffres (ou 4 pour Amex).

Pour que le paiement soit garanti, le marchand doit demander à l'acheteur :

  • la saisie du cryptogramme visuel
  • une authentification 3D Secure
  string ans..64

Remarque :

Pour qu'un paiement utilisant un alias existant (paiement en un clic) soit garanti, le marchand doit demander à l'acheteur :
  • la saisie du cryptogramme visuel
  • une authentification 3D Secure