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

Prérequis

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

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

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

Objectif

Mettre en place un abonnement sur Axepta Online

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

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

Réponse

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

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)

1. Enrôlement du client : Initialisation de l'abonnement lors de la 1ère échéance

La création de la première échéance d'un abonnement est effectuée 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 le marchand est certifié PCI-DSS

Requête

Le tableau suivant décrit les paramètres supplémentaires chiffrés à ajouter aux requêtes de paiement :

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

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.

2. 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

Requête

Le tableau suivant décrit les paramètres supplémentaires chiffrés à ajouter aux requêtes de paiement :

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

Réponse

Abonnement variable

Exemples

• Un client souscrit à un service composé d'un forfait mensuel et d'une part variable. Exemple : abonnement téléphonique, abonnement à un contrat d'énergie, etc.
  
• Souscription à un service avec tacite reconduction et/ou avec variation annuelle du prix

1. Enrôlement du client : Initialisation de l'abonnement lors de la 1ère échéance

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 le marchand est certifié PCI-DSS

Requête

Le tableau suivant décrit les paramètres supplémentaires chiffrés à ajouter aux requêtes de paiement :

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

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.

2. 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

Requête

Le tableau suivant décrit les paramètres supplémentaires chiffrés à ajouter aux requêtes de paiement :

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

Réponse