Tip | ||
---|---|---|
| ||
|
Table of Contents |
---|
Description
Cette section aborde la mise en place des abonnements par carte, conformes à la DSP2, sur Axepta Online.
Axepta Online permet de mettre en place 2 types d'abonnement :
- Abonnement d'une durée fixe et d'un montant fixe : Le montant et la durée sont connus lors de la souscription
- Abonnement variable : Le montant et la durée ne sont pas connus lors de la souscription (tacite reconduction).
Note |
---|
Le choix du type d'abonnement doit est défini à la souscription et ne peut pas être modifié au cours de l'abonnement. Si vous souhaitez passer d'un abonnement d'une durée fixe à un abonnement variable il faudra enrôler à nouveau votre client. |
Prérequis
- Vous souhaitez l'abonnement / paiement récurrent par carte
- Vous avez défini quel type d'abonnement vous allez proposer à vos clients (cf. ci-dessous)
- Vous avez recueilli le consentement de votre client pour la souscription d'un nouvel abonnement
- Vous allez stocker les données suivantes :
- L'objet JSON Card contenant : le numéro de carte tokenisé, la marque de la carte et la date d'expiration
- Le schemeReferenceID reçu en réponse de la transaction d'initialisation de l'abonnement
Mise en place d'un abonnement
La mise en place d'un abonnement s'effectue en 2 étapes :
- Echéance 1 : Enrôlement de du client / Initialisation de l'abonnement
- 1ère transaction authentifiée en 3DSV2 initiée par le client, on parlera de CIT (Customer Initiated transaction).
- Cette transaction ne pourra pas bénéficier d'une demande d'exemption de l'authentification 3DS
- Une valeur de chaînage est envoyée dans la réponse de cette transaction. Elle sera stockée par le marchand et utilisée dans toutes les échéances suivantes de l'abonnement.
- 1ère transaction authentifiée en 3DSV2 initiée par le client, on parlera de CIT (Customer Initiated transaction).
- Echéances suivantes de l'abonnement
- Envoi de requêtes de paiement initiéées par le marchand, on parlera de MIT (Merchant Initiated transaction)
- Elles contiennent la valeur de chaînage reçue en réponse de la transaction d'initialisation de l'abonnement.
- Envoi de requêtes de paiement initiéées par le marchand, on parlera de MIT (Merchant Initiated transaction)
Mise en place d'un abonnement
Focus : Chaînage des transactions
Une donnée clé
L'ensemble des échéances d'un abonnement générées par le marchand doivent être chainées à l'échéance d'initialisation de l'abonnement.
La valeur de chaînage est reçue en réponse de l'échéance d'initialisation de l'abonnement, elle est générée soit par la banque du porteur soit par le scheme utilisé (Visa, Mastercard...).
Chez Axepta Online, la valeur de chaînage est le schemeReferenceID.
Principes
Chaînage des transactions d'un abonnement
Implémentation de l'abonnement
Objectif
Mettre en place un abonnement sur Axepta Online
Abonnement d'une durée fixe et d'un montant fixe
Exemple
Le client s’abonne à un gymnase pour 1 an au prix de 34,99 € par mois
- Mois 1 : L’acheteur effectue le paiement du premier mois en ligne (CIT)
- Mois n : Les mois suivants, le commerçant effectue des transactions à 34,99 € (MIT)
Echéance 1 : Enrôlement de du client / Initialisation de l'abonnement
La création de la première échéance d'un abonnement est effectué au cours d'un parcours de paiement via :
- La page de paiement
Le formulaire de carte hébergé par BNP Paribas
Un formulaire de carte hébergé par le marchand - (uniquement si marchand PCI-DSS)
Info |
---|
L’authentification avec le 3D Secure est obligatoire pour la première échéance effectuée en présence du client (CIT) |
Requête
Le tableau suivant décrit les paramètres supplémentaires chiffrés à ajouter aux requêtes de paiement :
Paramètre | Format | CND | Description | Exemple | |||||||
---|---|---|---|---|---|---|---|---|---|---|---|
JSON | M | Objet précisant le type et la série de transactions à l’aide des identifiants de compte de paiement (p. ex., numéro de compte ou token de paiement) qui sont stockés par un commerçant pour traiter les achats futurs d’un client. |
| ||||||||
JSON | O | Objet précisant le parcours d'authentification 3D Secure (obligatoire ou exemption) Ici utilisez : Mandate challenge | __ |
Le tableau suivant décrit les paramètres qui seront reçus dans la réponse du paiement et stockés par le commerçant.
Key | Format | CND | Description |
---|---|---|---|
card | JSON | M | Données de réponse de la carte |
ans..64 | C | Donnée de chaînage des transactions dans le cadre des abonnements effectués par carte |
Info |
---|
|
Echéance suivantes de l'abonnement
Les échéances suivantes d'un abonnement sont initiées par le marchand via :
Server-to-server - direct.aspx
Batch - Batch integration
Info |
---|
Les échéances suivantes ne sont pas soumises à l’authentification avec le 3D Secure car elles sont initiées par le marchand (MIT) |
Requête
Le tableau suivant décrit les paramètres supplémentaires chiffrés à ajouter aux requêtes de paiement :
Paramètre | Format | CND | Description | Exemple | |||||
---|---|---|---|---|---|---|---|---|---|
card | JSON | M | Donnée de la carte | -- | |||||
ans..64 | M | Donnée de chaînage des transactions dans le cadre des abonnements effectués par carte.
| -- | ||||||
JSON | M | Objet précisant le type et la série de transactions à l’aide des identifiants de compte de paiement (p. ex., numéro de compte ou token de paiement) qui sont stockés par un commerçant pour traiter les achats futurs d’un client. |
|
Réponse
Le champ schemeReferenceID peut être valorisé dans la réponse de paiement d'un abonnement, 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 de l'abonnement doit être stockée et réutilisée dans toutes les échéances suivantes de l'abonnement (paiement récurrent).
Abonnement variable
Exemples
- Un client souscrit à un service composé d'un forfait mensuel et d'une part variable → abonnement téléphonique, abonnement à un contrat d'énergie
- Souscription à un service avec tacite reconduction et/ou avec variation annuelle du prix
Note |
---|
We recommend that the amount of the 1st transaction includes future changes in the amount. Example
|
Echéance 1 : Enrôlement de du client / Initialisation de l'abonnement
La création de la première échéance d'un abonnement est effectué au cours d'un parcours de paiement via :
- La page de paiement
Le formulaire de carte hébergé par BNP Paribas
Un formulaire de carte hébergé par le marchand - (uniquement si marchand PCI-DSS)
Info |
---|
L’authentification avec le 3D Secure est obligatoire pour la première échéance effectuée en présence du client (CIT) |
Requête
Le tableau suivant décrit les paramètres supplémentaires chiffrés à ajouter aux requêtes de paiement :
Paramètre | Format | CND | Description | Exemple | |||||
---|---|---|---|---|---|---|---|---|---|
JSON | M | Objet précisant le type et la série de transactions à l’aide des identifiants de compte de paiement (p. ex., numéro de compte ou token de paiement) qui sont stockés par un commerçant pour traiter les achats futurs d’un client. |
| ||||||
JSON | O | Objet précisant le parcours d'authentification 3D Secure (obligatoire ou exemption) Ici utilisez : Mandate challenge | __ |
Réponse
Le tableau suivant décrit les paramètres qui seront reçus dans la réponse du paiement et stockés par le commerçant.
Key | Format | CND | Description |
---|---|---|---|
card | JSON | M | Données de réponse de la carte |
ans..64 | C | Donnée de chaînage des transactions dans le cadre des abonnements effectués par carte |
Info |
---|
|
Echéance suivantes de l'abonnement
Les échéances suivantes d'un abonnement sont initiées par le marchand via :
Server-to-server - direct.aspx
Batch - Batch integration
Info |
---|
Les échéances suivantes ne sont pas soumises à l’authentification avec le 3D Secure car elles sont initiées par le marchand (MIT) |
Requête
Le tableau suivant décrit les paramètres supplémentaires chiffrés à ajouter aux requêtes de paiement :
Paramètre | Format | CND | Description | Exemple | |||||
---|---|---|---|---|---|---|---|---|---|
card | JSON | M | Donnée de la carte | -- | |||||
ans..64 | M | Donnée de chaînage des transactions dans le cadre des abonnements effectués par carte.
| -- | ||||||
JSON | M | Objet précisant le type et la série de transactions à l’aide des identifiants de compte de paiement (p. ex., numéro de compte ou token de paiement) qui sont stockés par un commerçant pour traiter les achats futurs d’un client. |
|
Réponse
Le champ schemeReferenceID peut être valorisé dans la réponse de paiement d'un abonnement, 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 de l'abonnement doit être stockée et réutilisée dans toutes les échéances suivantes de l'abonnement (paiement récurrent).