Description

Cette section aborde la mise en place des abonnements par carte, conformes à la DSP2, sur Axepta Online pour les cartes 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 fixedéfinie : Le montant, la périodicité et la durée sont connus lors de la souscription
• Abonnement variable : Le montant et - CIT/MIT : 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 : Paiement récurrent carte (Abonnement) - MOTO (Mail Order / Telephone Order)

Prérequis

• Vous souhaitez l'abonnement / paiement récurrent par carte Vous avez défini (CB, Visa, Mastercard) :
  
  • Définir quel type d'abonnement vous allez proposer à vos clients (cf. ci-dessous)
  Vous avez recueilli
  • Recueillir le consentement de votre client pour la souscription d'un nouvel abonnement
  • (côté marchand)
  • Stocker
  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 étpaes étapes :

1. Enrôlement de du client / : Initialisation de l'abonnement (par exemple en janvier) :lors de la 1ère échéance
   1. La 1ère transaction,
   2. 1ère transaction authentifiée en 3DSV2 initiée par le client, sera authentifiée en 3DSV2. On parlera alors de CIT ou Customer Initiated transaction.
      
   3. Cette transaction ne pourra pas bénéficier d'une demande d'exemption de l'authentification 3DS.
   4. Une valeur de chaînage est 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).
      
2. Echéances suivantes de l'abonnement (par exemple en février, en mars...) :
   1. Les
   2. Envoi de requêtes de paiement suivantes seront initiéées par le marchand. On parlera de MIT ou Merchant Initiated transaction.
      
   3. Elles contiennent contiendront la valeur de chaînage reçue en réponse de la transaction d'initialisation de l'abonnement.

Image Added

Mise en place d'un abonnement

Focus : Chaînage des transactions

Image Removed

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 : 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)

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

Image Added

Chaînage des transactions d'un abonnement

Implémentation de l'abonnement

Abonnement d'un montant et d'une périodicité fixes sur une durée définie

{
    "type": {
        "recurring": {
            "recurringFrequency": 30,
            "recurringStartDate": "2019-09-14",
            "recurringExpiryDate": "2020-09-14"
        }
    },
    "initialPayment": true,
    "useCase": "fixed"
}

Etape 1 : Initialisation du chaînage

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

{
    "type": {
        "recurring": {
            "recurringFrequency": 30,
            "recurringStartDate": "2019-09-14",
            "recurringExpiryDate": "2020-09-14"
        }
    },
    "initialPayment": false,
    "useCase": "fixed"
}

Abonnement d'un montant et/ou d'une périodicité variable - CIT / MIT

{
    "type": {
        "unscheduled": "CIT"
    },
    "initialPayment": true,
  	"useCase": "ucof"   
}

Lors de l'initialisation du chaînage, il est nécessaire d'utiliser les valeurs 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

Etape 2 : Création de transactions chaînées

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

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.

{
    "type": {
        "unscheduled": "MIT"
    },
    "initialPayment": false,
  	"useCase": "ucof"   
}

Abonnement avec des cartes AMEX

Les abonnements par carte, conformes à la DSP2, sur Axepta Online pour les cartes AMEX nécessite l'usage du paramètre TransactionID à la place du paramètre schemeReferenceID (requête et réponse).