Guide d'intégration
Cas d'utilisation
Utilisez le Web Service V4.1/PCI/Charge/CreatePayment en fonction du protocole d'authentification et du résultat de l'authentification.
Authentification 3D Secure v2
Tester
Testez le Web Service V4.1/PCI/Charge/CreatePayment depuis notre playground.
Données d'authentification
Récupérez les données suivantes :
Protocole d'authentification
Nom | Description |
---|---|
name | Nom du protocole d'authentification, avec la valeur THREEDS |
version | Version du protocole d'authentification. Valeurs possibles :
|
directoryServer | Nom du Directory Server (DS) utilisé lors de l'authentification.
Valeurs possibles :
|
ChallengePreference | Préférence 3DS transmise au DS si l'authentification du porteur est réussi, avec un statut en `SUCCESS` ou en `ATTEMPT`. |
- Si le statut de l'authentification a pour valeur
SUCCESS
ouATTEMPT
, récupérez ces informations :
</tbody>
Nom | Description |
---|---|
authenticationType | Nom du protocole d'authentification. Valeur requise :
|
authenticationValue | Référence générée par l'émetteur pour valider l'intégrité des données de la transaction. Selon le Directory Server utilisé,
Ex: +kAr/o8S0DxgGYkz7QQHZCw8V5k= |
commerceIndicator | Indicateur de commerce électronique (ECI). Valeur retournée par l'ACS après l'authentification, en fonction du statut de l’authentification et du type de carte.
Ex: 05 |
dsTransID | Identifiant unique de la transaction généré par le DS 3DS2.
Ex : d6706a0d-c48d-4cf4-a1d2-d4a401a3143e |
exemption | Exemption appliquée.
Requis pour le FRICTIONLESS, valeur du champ `authenticationType` . Voir : Motif de débrayage et exemptions.
Ex: LOW_VALUE |
requestorName | Nom du marchand utilisé lors de l'authentification du porteur. |
acsTransID | Identifiant de transaction unique généré par l'ACS.
Ex: d727ebfe-de4c-4682-85fa-e60ca00a9cff |
authValueAlgorithm | Algorithme utilisée pour vérifier de l’authentification du porteur.
Valeurs possibles :
|
dsScore | Scoring d'authentification.
Ex : 31 |
- Si le statut de l'authentification est en échec avec les valeurs suivantes :
- DISABLED
- ENROLLED_UNAVAILABLE
- FAILED
- NOT_ENROLLED
- UNAVAILABLE
Dans ce cas, récupérez ces informations :
Nom | Description |
---|---|
challengeCancelationIndicator | Nom du protocole d'authentification. Valeur requise :
Indicateur d'annulation de challenge reçu dans le message RReq. Valeur retournée par le DS en cas d'annulation de l'authentification.
Ex: 01 |
transactionStatusReason | Raison de l'échec d'authentification retournée par le DS en cas d'échec d'authentification.
Ex: 82 |
Pour le réseau CB
Requête
Champs obligatoires
- Montant
- Devise
Données de la carte
- Type du moyen de paiement :
CARDS
- Numéro principal de la carte : pan.
- Mois d'expiration.
- Année d'expiration.
Données d'authentification
- Sur le protocole
- nom :
THREEDS
- numéro de version
- directoryServer : CB
- challengePreference: Ex : NO_CHALLENGE_REQUESTED en cas de réussite lors de l'authentification (statut
SUCCESS
ouATTEMPT
).
- Données de test
authValueAlgorithm : | 2 | authenticationType : | FRICTIONLESS |
authenticationValue : | +kAr/o8S0DxgGYkz7QQHZCw8V5k= | commerceIndicator : | 05 |
challengePreference : | NO_CHALLENGE_REQUESTED | dsTransID : | d6706a0d-c48d-4cf4-a1d2-d4a401a3143e |
exemption : | LOW_VALUE | acsTransID : | d727ebfe-de4c-4682-85fa-e60ca00a9cff |
requestorName : | DEMO STORE | dsScore : | 31 |
Exemple de requête
{ "amount": "1230", "currency": "XPF", "paymentForms": [ { "paymentMethodType": "CARD", "pan": "4970110000001029", "expiryMonth": "03", "expiryYear": "27", "securityCode": "123" } ], "customer": { "email": "sample@example.com" }, "authenticationDetails":{ "protocol":{ "name":"THREEDS", "version":"2", "directoryServer":"CB", "challengePreference":"NO_CHALLENGE_REQUESTED" }, "status":"SUCCESS", "authenticationType":"FRICTIONLESS", "commerceIndicator":"05", "authenticationValue":"+kAr/o8S0DxgGYkz7QQHZCw8V5k=", "dsTransID":"d6706a0d-c48d-4cf4-a1d2-d4a401a3143e", "acsTransID":"d727ebfe-de4c-4682-85fa-e60ca00a9cff", "authValueAlgorithm":"2", "dsScore":"31", "exemption":"LOW_VALUE", "requestorName":"DEMO STORE" } }
Pour connaître l'intégralité et la description des champs, consultez le playground : V4.1/PCI/Charge/CreatePayment (menu à gauche)
Pour le réseau VISA / Mastercard / AMEX
Requête
Champs obligatoires
- Montant
- Devise
Données de la carte
- Type du moyen de paiement :
CARDS
- Numéro principal de la carte : pan.
- Mois d'expiration.
- Année d'expiration
Données d'authentification
- Sur le protocole
- nom :
THREEDS
- numéro de version
- directoryServer : le nom du DS. Ex :
VISA
ouMASTERCARD
ouAMEX
- challengePreference: Ex :
NO_CHALLENGE_REQUESTED
en cas de réussite lors de l'authentification (statutSUCCESS
ouATTEMPT
).
- Données de test
authenticationType : | FRICTIONLESS | dsTransID : | d6706a0d-c48d-4cf4-a1d2-d4a401a3143e |
authenticationValue : | +kAr/o8S0DxgGYkz7QQHZCw8V5k= | commerceIndicator : | 05 |
challengePreference : | NO_CHALLENGE_REQUESTED | exemption : | LOW_VALUE |
Exemple de requête pour VISA
{ "amount": "990", "currency": "XPF", "paymentForms": [ { "paymentMethodType": "CARD", "pan": "4970110000001029", "expiryMonth": "09", "expiryYear": "27", "securityCode": "123" } ], "customer": { "email": "sample@example.com" }, "authenticationDetails":{ "protocol":{ "name":"THREEDS", "version":"2.1.0", "directoryServer":"VISA", "challengePreference":"NO_CHALLENGE_REQUESTED" }, "status":"SUCCESS", "authenticationType":"FRICTIONLESS", "commerceIndicator":"05", "authenticationValue":"+kAr/o8S0DxgGYkz7QQHZCw8V5k=", "dsTransID":"d6706a0d-c48d-4cf4-a1d2-d4a401a3143e", "exemption":"OTHER_EXEMPTION", } }
Pour connaître l'intégralité et la description des champs, consultez le playground : V4.1/PCI/Charge/CreatePayment (menu à gauche)
Authentification débrayée
Le service permet de créer un paiement lorsque l'authentification du porteur a été volontairement désactivée.
Dans ce cas, la raison de cette décision doit être précisée en utilisant le champ exemption (Voir chapitre Motif de débrayage et exemptions).
Champs obligatoires
- Montant
- Devise
Données de la carte
- Type du moyen de paiement :
CARDS
- Numéro principal de la carte : pan.
- Mois d'expiration.
- Année d'expiration.
Données d'authentification
- Statut :
DISABLED
- Exemption : Voir : Motif de débrayage et exemptions.
Exemple de requête
{ "amount": "1230", "currency": "XPF", "paymentForms": [ { "paymentMethodType": "CARD", "pan": "4970100000000022", "expiryMonth": "09", "expiryYear": "27", "securityCode": "123" } ], "customer": { "email": "sample@example.com" }, "authenticationDetails":{ "status":"DISABLED", "exemption":"OTHER_EXEMPTION" } }
Pour connaître l'intégralité et la description des champs, consultez le playground : V4.1/PCI/Charge/CreatePayment (menu à gauche)