Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Tip
titleUn abonnement conforme à la réglementation (DSP2)
  • Première échéance de l'abonnement : Transaction fortement authentifiée en 3DSV2 (SCA) sans demande d'exemption
  • Chaînage des échéances suivantes avec la 1ère échéance de l'abonnement



Table of Contents


Description


Cette section aborde la mise en place des abonnements par carte, conformes à la DSP2, sur Axepta Online via pour les cartes CB, VISA, Mastercard.


Axepta Online permet de mettre en place 2 types d'abonnement :

  • Abonnement d'une durée fixe un montant et d'un montant fixeune 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 : Le montant et tout autre cas, le montant, la périodicité ou la durée ne sont pas connus lors de la souscription (tacite reconduction).


Pour le paiement récurrent via un paiement 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 est ê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


  • 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
    Vous allez stocker
    • 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. Echéance 1 : Enrôlement de du client / : Initialisation de l'abonnement lors de la 1ère échéance
    1. La 1ère transaction authentifiée en 3DSV2 , initiée par le client, on parlera 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 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
    1. Envoi de Les requêtes de paiement suivantes seront initiéées par le marchand, on . On parlera de MIT (ou Merchant Initiated transaction).
    2. Elles contiennent 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 sur Axepta Online

Mise en place d'un abonnement


Focus : Chaînage des transactions


Une donnée clé

L'ensemble des échéances La 1ère échéance d'un abonnement générées par le marchand doivent être chainées à l'échéance d'initialisation de l'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, 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 Dans la documentation Axepta Online, la valeur donnée de chaînage est renseignée dans le champ schemeReferenceID.


Principes

Chaînage des transactions

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

un montant et d'

un montant fixe

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)


Echéance

1

: Enrôlement de

. 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é 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)


Info

L’authentification avec le 3D Secure est obligatoire pour la première échéance effectuée en présence du initée par le client (CIT)


Requête

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


ParamètreFormatCNDDescriptionExemple

credentialOnFile

JSONMObjet précisant le type et la série de transactions


Code Block
themeEclipse
linenumberstrue
{
    "type": {
        "recurring": {
            "recurringFrequency": 30,
            "recurringStartDate": "2019-09-14",
            "recurringExpiryDate": "2020-09-14"
        }
    },
    "initialPayment": true
}


threeDSPolicy

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.


KeyFormatCNDDescription
cardJSONMDonnées de réponse de la carte

schemeReferenceID

ans..64CDonnée de chaînage des transactions dans le cadre des abonnements effectués par carte


Info
  • Les données renseignées dans les champs card et schemeReferenceID seront réutilisées dans toutes les prochaines échéances de cet abonnement
  • Le La donnée renseignée dans le schemeReferenceID de cette transaction sera utilisé utilisée pour chaîner les prochaines échéances suivantes à l'échéance initiale.



2. Echéance suivantes de l'abonnement


Les échéances suivantes d'un abonnement sont initiées par le marchand via :


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

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


ParamètreFormatCNDDescriptionExemple
cardJSONMDonnée de la carte--

schemeReferenceID

ans..64M

Donnée de chaînage des transactions dans le cadre des abonnements effectués par carte.


Info

Utiliser la valeur reçue dans la réponse de la requête d'initialisation de l'abonnement


--

credentialOnFile

JSONMObjet précisant le type et la série de transactions


Code Block
languagejson
{
    "type": {
        "recurring": {
            "recurringFrequency": 30,
            "recurringStartDate": "2019-09-14",
            "recurringExpiryDate": "2020-09-14"
        }
    },
    "initialPayment": false
}




RéponseLe champ schemeReferenceID peut être valorisé dans la réponse de paiement d'un abonnement, mais cette valeur ne doit pas être réutilisée.


Warning

Seule la

valeur

donnée reçue dans le schemeReferenceID de 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).

Selon les émetteurs, le champ schemeReferenceID peut être valorisé dans la réponse d'une échéance, mais la donnée reçue ne doit pas être réutilisée.



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



Note

We recommend that the amount of the 1st transaction includes future changes in the amount.

Example

  • A customer subscribes to a service with a monthly fee of 20 euros and whose estimated consumption is 15 euros on average
  • The first transaction should be 45 euros.
  • It means that the merchant will be able to create transactions up to 45 euros



Echéance

1

: Enrôlement de

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


Info

L’authentification avec le 3D Secure est obligatoire pour la première échéance effectuée en présence du initée par le client (CIT)


Requête

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


ParamètreFormatCNDDescriptionExemple

credentialOnFile

JSONMObjet précisant le type et la série de transactions


Code Block
languagejson
{
    "type": {
        "unscheduled": "CIT"
    },
    "initialPayment": true
}


threeDSPolicy

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.


KeyFormatCNDDescription
cardJSONMDonnées de réponse de la carte

schemeReferenceID

ans..64CDonnée de chaînage des transactions dans le cadre des abonnements effectués par carte


Info
  • Les données renseignées dans les champs card et schemeReferenceID seront réutilisées dans toutes les prochaines échéances de cet abonnement
  • Le La donnée renseignée dans le schemeReferenceID de cette transaction sera utilisé utilisée pour chaîner les prochaines échéances suivantes à l'échéance initiale.



2. Echéance suivantes de l'abonnement


Les échéances suivantes d'un abonnement sont initiées par le marchand via :


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

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


ParamètreFormatCNDDescriptionExemple
cardJSONMDonnée de la carte--

schemeReferenceID

ans..64M

Donnée de chaînage des transactions dans le cadre des abonnements effectués par carte.


Info

Utiliser la valeur reçue dans la réponse de la requête d'initialisation de l'abonnement


--

credentialOnFile

JSONMObjet précisant le type et la série de transactions


Code Block
languagejson
{
    "type": {
        "unscheduled": "MIT"
    },
    "initialPayment": false
}



RéponseLe champ schemeReferenceID peut être valorisé dans la réponse de paiement d'un abonnement, mais cette valeur ne doit pas être réutilisée.


Warning

Seule la

valeur

donnée reçue dans le schemeReferenceID de 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).

Selon les émetteurs, le champ schemeReferenceID peut être valorisé dans la réponse d'une échéance, mais la donnée reçue ne doit pas être réutilisée.