Note | ||
---|---|---|
| ||
Oui si vous proposez de l'abonnement en ligne à vos clients. Tous les abonnements / paiements récurrents Axepta Online initialisés en 3DSV1 sont concernés par cette modification, que le marchand conserve son implémentation en 3DSV1 ou modifie son implémentation pour être compatible 3DSV2. |
Description
Un changement de la règlementation en vigeurvigueur, associé à la DSP2, impose désormais que les transactions relatives à un abonnement / paiement récurrent soient rattachées à une transaction existanted'initialisation du chaînage (cf. schéma). On parlera alors de chaînage des transactions.
Cette section aborde la mise en place du chaînage sur des abonnements déjà en cours au Axepta Online initialisés en 3DSV1 avant le 01/01/2022.
La mise en place de ce chaînage passe par la gestion d'un paramètre supplémentaire dans les requêtes de paiement, le schemeReferenceID, qui contiendra la valeur permettant de chaîner les transactions.
La mise a à jour des abonnements passe par 2 étapes :
- Initialisation du chaînage (ex: Janvierpar exemple en janvier) : Envoi d'une requête de paiement contenant une valeur de chaînage définie par la marque de la carte du client (CB, VISA, MCcf. section implémentation de cette page) et récupération de la valeur de chaînage à conserverenvoyée par la banque du porteur qui sera conservée par le marchand
- Envoi de transactions chaînées (ex : Février, Marspar exemple en février, en mars...) : Envoi d'une requête de paiement contenant la valeur de chaînage reçue en réponse de la transaction d'initialisation du chaînage.
Info | ||
---|---|---|
| ||
Le chaînage des transactions Axepta Online initiées en 3DSV1 est également à mettre en place pour les abonnements souscrits à partir du 01/01/2022.Pour la mise en place d'un nouvel abonnement se référer à la page suivante : , cf. section Paiement récurrent (Abonnement) / One click |
Schéma
Chaînage des transactions initiées en 3DSV1
Prérequis
- Vous proposez le l'abonnement / paiement récurrent par carte
- Des clients ont réalisés leurs souscriptions leur souscription initiale avant le changement de réglementation01/01/2022
- Vous stockez le pseudo card number (PCNr)
- Vous allez stocker le schemeReferenceID reçu en réponse de la transaction d'initialisation du chaînage
Implémentation du chaînage
Objectif
Mettre en place le chaînage sur des abonnements Axepta Online initialisés en 3DSV1 avant le 01/01/2022.
Exemple
- Echéance Janvier → Initialisation du chaînage avec valeur de chaînage standard définie par la marque de la carte du porteur et récupération du schemeReferenceID en réponse (Implémentation
Vous avez réalisé l'implémentation d'Axepta sans gérer le paramère "msgVer=2.0"
- : cf. Etape 1)
- Echéance Février → Transaction chaînée c'est-à-dire qui contient en paramètre le schemeReferenceID récupérée de la réponse de la transaction d'initialisation du chaînage (Implémentation : cf. Etape 2)
- Echéances Mars et suivantes → Transaction chaînée c'est-à-dire qui contient en paramètre le schemeReferenceID récupérée de la réponse de la transaction d'initialisation du chaînage (Implémentation : cf. Etape 2)
Etape 1 : Initialisation du chaînage
La création d'une nouvelle échéance d'un abonnement (paiement récurrent)
Initialisation du chaînage
La requête de paiement peut être effectuée via :
Server-to-server - direct.aspx
Batch - Batch integration
Requête
Le tableau suivant décrit le paramètre supplémentaire chiffré à ajouter aux requêtes de paiement :
Parameter | Format | CND | Description |
---|---|---|---|
ans..64 | M | Donnée de chaînage des transactions dnans dans le cadre des abonnements effectués par carte Lors de l'initialisation du chaînage, il est nécessaire d'utiliser les valeurs définis définies par les réseaux CB, Visa, Mastercard .(marque de la carte du porteur) : CB : 9999999999999 - 13 chiffres VISA: 887001863998888 - 15 chiffres MasterCard: 1231_MCC999999 - 13 chiffres |
Réponse
:Info |
---|
|
|
|
Etape 2 : Création de transactions chaînées
Axepta Online endpoint
Le paiement peut être effectué par le commerçant avec les endpoint suivants :
Server-to-server - direct.aspx
Batch - Batch integration
Requête
Le tableau suivant décrit les paramètres supplémentaires de requête de paiement chiffré qui doivent être ajoutés :
n16
CNr
TOKEN (Pseudo Card Number, numéro de carte temporaire) : numéro aléatoire généré par la plateforme de paiement qui représente un numéro de carte authentique. Le TOKEN (PCN) commence par 0, et les 3 derniers chiffres correspondent à ceux du véritable numéro de carte. Vous pouvez utiliser le PCN comme un numéro de carte authentique pour une autorisation, une capture et un remboursement.
Le PCNr est une valeure reçu en réponse par la plateforme, il remplacera le CCNr dans la requête ou dans la partie card-JSON.
CCNr
Numéro de la carte (minimum 12 chiffres) sans espaces
Note |
---|
Le marchand doit être PCI DSS compliant pour stocker le CCNr |
CCBrand
a..22
M
CCExpiry
n6
M
En combinaison avec PCNr : date d’expiration de la carte au format AAAAMM (201706).
RTF
a1
M
Pour un paiement récurrent (abonnement) :
I = paiement initial pour le nouvel abonnement
R = paiement récurrent
→ Pour ce cas, utilisez "R"
On récupère la valeur dans la réponse de paiement de "Etape 1" afin que les systèmes en aval puissent chaîner les deux transactions en conséquence.
Etape 1 (3DSV2) :
Axepta Online endpoint
Le paiement peut être effectué par le commerçant avec les endpoint suivants La création d'une nouvelle échéance d'un abonnement (paiement récurrent) peut être effectuée via :
Server-to-server - direct.aspx
Batch - Batch integration
Requête
Le tableau suivant décrit les paramètres supplémentaires de requête de paiement chiffré qui doivent être ajoutés : le paramètre supplémentaire chiffré à ajouter aux requêtes de paiement :
Parameter |
---|
Format | CND | Description |
---|
ans..64 | M |
Extrait du paiement initial et utilisé dans la transaction suivante afin que les systèmes en aval puissent chaîner les deux transactions en conséquence.
Pour la première transaction, le marchand doit utiliser les valeurs définis par les schemes.
CB : 9999999999999 - 13 chiffres
VISA: 887001863998888 - 15 chiffres
MasterCard: 1231_MCC999999 - 13 chiffres
Objet précisant le type et la série de transactions à l’aide des identifiants de compte de paiement (ex : numéro de compte ou TOKEN) qui sont stockés par un commerçant pour traiter les achats futurs d’un client.
{
"type": {
"unscheduled": "MIT"
},
"initialPayment": false
}
Réponse :
- Nous recevrons la nouvelle valeure pour le schemeReferenceID dans la réponse de cette transaction
- Cette valeur sera utilisée dans toutes les transactions MIT suivantes (Step 2)
Etape 2 (3DSV2) :
Axepta Online endpoint
Le paiement peut être effectué par le commerçant avec les endpoint suivants :
Server-to-server - direct.aspx
Batch - Batch integration
Requête
Le tableau suivant décrit les paramètres supplémentaires de requête de paiement chiffré qui doivent être ajoutés :
Donnée de chaînage des transactions dans le cadre des abonnements effectués par carte.
|
Réponse
Le champ schemeReferenceID peut être valorisé dans la réponse d'un paiement récurrent, mais cette valeur ne doit pas être réutilisée.
Seule la valeur reçue dans la réponse de la requête d'initialisation du chaînage doit être stockée et réutilisée dans toutes les échéances suivantes de l'abonnement (paiement récurrent).
{
"type": {
"unscheduled": "MIT"
},
"initialPayment": false
}