Tip | ||
---|---|---|
| ||
|
Info | ||
---|---|---|
| ||
|
Table of Contents |
---|
Description
CetteThis section covers the implementation recurring card payments, compliant with PSD2, on Axepta Online for CB, VISA, Mastercard.
Axepta Online
permet de mettre en place 2 types d'abonnement :- Abonnement d'un montant et d'une périodicité fixes sur une durée définie : Le montant, la périodicité et la durée sont connus lors de la souscription
- Abonnement variable : tout autre cas, le montant, la périodicité ou la durée ne sont pas connus lors de la souscription (tacite reconduction).
Pour les abonnements / paiements récurrents intiés via une 1ère transaction MOTO, veuillez vous référer à la documentation suivante : ici
Note |
---|
Le choix du type d'abonnement doit être 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
offers 2 kind of subscription :
- Subscription for a fixed amount and frequency over a defined period: The amount, frequency and duration are known when the customer suscribes
- Variable subscription - CIT / MIT : in any other case, the amount, frequency or duration are not known at the time of subscription (tacit renewal).
For recurring card payments with a first MOTO transaction, you can refere to Recurring card payments (Subscription) - MOTO (Mail Order / Telephone Order)
Note |
---|
The kind of subscription must be defined during the first transaction and cannot be modified during subscription. If you want to switch from a fixed-term subscription to a variable subscription, you will have to enroll your customer again (new CIT transaction - Customer Initiated Transaction - with 3DS authentication). |
Prerequisites
Subscription / recurring payment by card
Vous souhaitez l'abonnement / paiement récurrent par carte(CB, Visa, Mastercard):
- Définir quel type d'abonnement vous allez proposer à vos clients (cf. ci-dessous)
- Recueillir le consentement de votre client pour la souscription d'un nouvel abonnement
- 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 :
- Enrôlement du client : Initialisation de l'abonnement lors de la 1ère échéance
- La 1ère transaction, initiée par le client, sera authentifiée en 3DSV2. On parlera alors de CIT ou 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 sera 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 (cf. schéma ci-dessous).
- La 1ère transaction, initiée par le client, sera authentifiée en 3DSV2. On parlera alors de CIT ou Customer Initiated transaction.
- Echéances suivantes de l'abonnement
- Les requêtes de paiement suivantes seront initiéées par le marchand. On parlera de MIT ou Merchant Initiated transaction.
- Elles contiendront la valeur de chaînage reçue en réponse de la transaction d'initialisation de l'abonnement.
- Les requêtes de paiement suivantes seront initiéées par le marchand. On parlera de MIT ou Merchant Initiated transaction.
Mise en place d'un abonnement
Focus : Chaînage des transactions
Une donnée clé
La 1ère échéance d'un abonnement permet de récupérer une donnée de chaînage qui sera utilisée pour relier ("chaîner") les échéances suivantes à cette 1ère échéance.
La donnée de chaînage, reçue en réponse de l'échéance d'initialisation de l'abonnement, est générée soit par la banque du porteur soit par le scheme utilisé (Visa, Mastercard).
Dans la documentation Axepta Online, la donnée de chaînage est renseignée dans le champ schemeReferenceID.
Principes
Chaînage des transactions d'un abonnement
Implémentation de l'abonnement
Choose which kind of subscription you will use (see below)
Get your client's consent for the subscription of a new subscription (on merchant side)
Store the following data
The JSON object Card containing: the tokenized card number (PCNr), the card brand and the expiration date
The schemeReferenceID received in response of the first transaction (subscription initiation transaction)
Subscription flows
The subscription flows are :
- Client enrolement : subscription initiation transaction
The 1st transaction, initiated by the client, will be authenticated with 3DSV2. It's a CIT or Customer Initiated transaction.
This transaction will not be eligible to an exemption request.
A chaining value will be sent in the response of this transaction. It will be stored by the merchant and used in all subsequent transactions (see diagram below).
- Subsequent transactions
- The subsequent transactions will be initiated by the merchant. It's an MIT or Merchant Initiated transaction.
The requests will use the chaining value received in response of the subscription initiation transaction.
- The subsequent transactions will be initiated by the merchant. It's an MIT or Merchant Initiated transaction.
Subscription flows
Focus on transactions chaining
A key data
The reponse of 1st transaction of a subscription will contain the chaining data which will be used to link ("chain") the subsequent transaction to the 1st transaction (initiation of the subscription).
The chaining data, received in response to the subscription initialization, is generated either by the bank or by the scheme (Visa, Mastercard).
In the Axepta Online documentation, the chaining data is called schemeReferenceID.
Principles
Transactions chaining
Subscription implementation
Anchor Subscription for a fixed amount and frequency Subscription for a fixed amount and frequency
Subscription for a fixed amount and frequency
Subscription for a fixed amount and frequency | |
Subscription for a fixed amount and frequency |
Expand | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||
ExampleThe customer subscribes to a gym for 1 year for € 34.99 per month
1. Client enrolement : subscription initiation transaction
Request
|
Abonnement d'un montant et d'une périodicité fixes sur une durée définie
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ExempleLe client s’abonne à un gymnase pour 1 an au prix de 34,99 € par mois
1. Enrôlement du client : Initialisation de l'abonnement lors de la 1ère échéanceLa création de la première échéance d'un abonnement est effectuée au cours d'un parcours de paiement via :
Requête
Paramètre | Format | CND | Description | Exemple | JSON | M | Objet précisant le type et la série de transactions
O Objet précisant le parcours d'authentification 3D Secure (obligatoire ou exemption)
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çantResponse The following table describes the parameters received in the payment response and stored by the merchant.
2. Echéance suivantes de l'abonnement
2. Subsequent transactionsSubsequent transactions are initiated by the merchant through Les échéances suivantes d'un abonnement sont initiées par le marchand via :
Requête Server-to-serverRequest
RéponseResponse
Batch
|
Subscription for variable amount and/or frequency
Abonnement variable- CIT / MIT
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
The variable subscription is a subscription with a variable amount during the subscription and/or a duration not known when the client suscribes. ExamplesThe customer subscribes to a service with a fixed fees and monthly consumptions
L'abonnement variable correspond à un abonnement dont le montant varie au cours de l'abonnement et / ou dont la durée n'est pas connue lors de la souscription. ExemplesLe client s’abonne à un service avec un forfait et des consommations mensuelles
Ou le client s'abonne à un service avec tacite reconduction mensuelle : Or the customer subscribes to a service with tacit monthly renewal :
1.Enrôlement du client : Initialisation de l'abonnement lors de la 1ère échéanceLa création de la première échéance d'un abonnement est effectuée au cours d'un parcours de paiement via : Client enrolement : subscription initiation transaction
Requête
Request
O Objet précisant le parcours d'authentification 3D Secure (obligatoire ou exemption)
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çantResponse The following table describes the parameters received in the payment response and stored by the merchant.
2. Echéance suivantes de l'abonnement
2. Subsequent transactionsSubsequent transactions are initiated by the merchant through Les échéances suivantes d'un abonnement sont initiées par le marchand via :
Requête Server-to-serverRequest
:
RéponseResponse
Batch
|
Subscription with AMEX cards
The recurring card payments, compliant with PSD2, on Axepta Online for AMEX require to use parameter TransactionID instead of schemeReferenceID (request and response).