logo Sogenactif

Release 22.4

aller directement au contenu

Rechercher par mots clés

Paiement par abonnement via duplication

Pour rechercher dans la page utiliser Ctrl+F sur votre clavier

Avant de lire ce document nous vous conseillons

Sogenactif est une solution de paiement de commerce électronique multicanale sécurisée conforme à la norme PCI DSS. Elle vous permet d’accepter et de gérer des transactions de paiement en prenant en compte les règles métiers liées à votre activité (paiement à la livraison, paiement différé, paiement récurrent, paiement échelonné, …).

L’objectif du présent document est d'expliquer la mise en œuvre de la solution de paiement par abonnement jusqu'au démarrage en production.

Ce document a pour objectif de vous aider à mettre en place le paiement récurrent des services que vous délivrez à vos clients (appelés abonnés dans la suite du document).

L’objectif est de présenter les fonctionnalités liées au paiement par abonnement et d’expliquer comment les mettre en œuvre avec la solution Sogenactif.

Pour avoir une vue d’ensemble de la solution Sogenactif, nous vous conseillons de consulter les documents suivants :

  • Présentation fonctionnelle
  • Configuration des fonctionnalités
Note: Sogenactif ne gère pas les données personnelles des abonnés (nom, prénom, adresse, âge, e-mail, téléphone ….) mais seulement les coordonnées de paiement qui vous permettent de débiter ou créditer vos abonnés.

Pour vous permettre d'effectuer des paiements, Sogenactif doit stocker les coordonnées de paiement de vos abonnés.

Vous avez quelques points à traiter avant de démarrer :

  • Pour être en conformité avec le RGPD, vous devez compléter votre registre interne de traitement des données personnelles, en précisant que les données bancaires sont conservées par Sogenactif. Pour davantage d'informations sur le RGPD, veuillez vous référer à notre documentation sur la sécurité des systèmes d'information,
  • Informer vos clients du stockage de leurs coordonnées et des modalités des paiements récurrents (durée, montant, périodicité…),

Pour toute question technique ou demande d'assistance, nos services sont disponibles du lundi au vendredi, hors jours fériés, de 9 h à 19 h :

  • par téléphone au : +33 (0) 825 090 095  (0,15 € TTC/min + prix d’un appel local – Tarif au 01/11/2021)
  • par e-mail : supportsogenactif@worldline.com

Pour faciliter le traitement de vos demandes, veuillez communiquer votre identifiant de commerçant : merchantId (numéro à 15 chiffres).

Le paiement par abonnement comporte plusieurs volets :

  • l'enrôlement de l'abonné et son authentification (CIT) ;
  • les débits pour les occurences de l'abonnement (MIT) en dupliquant la CIT ;
  • la gestion de l'expiration du moyen de paiement de l'abonné ;

Les moyens de paiement permettant d’effectuer des paiements récurrents sont :

  • Carte CB, Visa, Mastercard, Amex, Bancontact (option WIP requise)
  • Mandat SDD (SEPA Direct Debit)

Lors de l'enrôlement de l'abonné effectué (CIT), veuillez à bien conserver les informations suivantes :

Par la suite, vous pouvez débiter, de manière récurrente, votre abonné, par transfert de fichier ou en mode en ligne.

Comme Sogenactif offre plusieurs interfaces pour traiter la prise d'abonnement et les paiements récurrents, il convient d’analyser votre besoin métier pour choisir les connecteurs les plus adaptés à votre situation.

Le tableau ci-dessous vous aide à faire votre choix.

Cas d'usage Sogenactif Paypage Sogenactif Office Serveur Sogenactif Office Serveur CSE Sogenactif In-App Sogenactif Office Batch Sogenactif Gestion Choix du connecteur
Prise d'abonnement
Vous souhaitez vous affranchir des exigences PCI. V X V V X X Si vous utilisez Sogenactif Paypage pour traiter vos paiements, vous pouvez capitaliser cette intégration existante pour gérer la prise d'abonnement. Pour le m-commerce, nous préconisons l’usage de Sogenactif In-App.
Vous affichez et sécurisez les pages de saisie des coordonnées de paiement X V V V X X Sogenactif Office Serveur répond à votre besoin pour le e-commerce. Pour le m-commerce, nous préconisons l’usage de Sogenactif In-App.
Les paiements récurrents
Vous débitez ou créditez vos abonnés à échéances fixes (cas des forfaits ou des services facturés après consommation). X V X X V V Le mode fichier de Sogenactif Office Batch est le connecteur adapté au traitement massif de paiement récurrents, mais vous pouvez aussi utiliser Sogenactif Office Serveur.
Vous débitez ou créditez vos abonnés à échéances variables (cas des services prépayés où l’abonné doit charger son compte avant de consommer). X V X X X V Le mode transactionnel de Sogenactif Office Serveur est le connecteur adapté pour débiter ou créditer vos abonnés à échéances variables.
Expiration du moyen de paiement
Renouveler le moyen de paiement de l'abonné. Le renouvellement est traité comme la prise d'abonnement. Réutilisez le même connecteur que celui utilisé pour la prise d'abonnement.
Initialisation de la base des abonnés
Vous migrez une base abonnés existante. X X X X V X Sogenactif Office Batch vous permet d’initialiser la base des abonnés à partir d’une base existante.

La collecte des coordonnées de paiement se fait sur Sogenactif Paypage.

Si le moyen de paiement de l'abonné est une carte :

  • il doit nécessairement s'authentifier 3-D Secure.
  • Vous pouvez utilisez le champ authenticationData.authentAmount pour procéder à une authentification d'un montant différent de celui du montant à payer lors de la première échéance.
  • Vous devez conserver la référence de la transaction dans votre système d'information, afin de débiter votre abonné pour les échéances ultérieures.

Diagramme décrivant l'enrôlement de l'abonné via Paypage

  1. Lors de la prise d'abonnement vous redirigez le nouvel abonné vers Sogenactif Paypage en communiquant dans la requête les données de la transaction (montant de la première échéance, devise, ..).
  2. Sogenactif affiche la page de paiement, l’abonné fournit ses coordonnées de paiement puis valide.
  3. Sogenactif procède à la vérification 3-D Secure.
  4. Sogenactif effectue les contrôles anti-fraude.
  5. Sogenactif envoie une demande d’autorisation à l’acquéreur.
  6. Sogenactif enregistre la transaction dans le back office.
  7. Sogenactif vous retourne les réponses manuelle et automatique contenant les détails de la transaction. Vous enregistrez votre référence de la transaction, ainsi que la date d'expiration de la carte
  8. Sogenactif envoie ou pas la transaction en remise en fonction des modalités que vous avez paramétrées dans la requête de paiement.

C’est une requête Sogenactif Paypage classique, veuillez consulter un des guides Sogenactif Paypage pour savoir comment renseigner la requête en fonction de votre besoin métier.

Cependant, les champs suivants ont un comportement particulier et doivent être valorisés comme ceci :

Champ Valeur
paymentPattern RECURRING_1
challengeMode3DS CHALLENGE_MANDATE
captureDay 0 à 6
captureMode AUTHOR_CAPTURE ou VALIDATION
amount montant de la première échéance (peut être valorisé à 0 si la première échéance est gratuite ou si le premier paiement a lieu plus tard)
authentAmount à valoriser si le champ amount = 0 avec le montant moyen d'une occurence de paiement de l'abonnement.

Si le champ n'est pas rempli, le montant de l'authentification sera le même que celui indiqué dans le champ amount.

Sogenactif retourne une réponse manuelle et automatique classique Sogenactif Paypage.

Les champs relatifs à la prise d'abonnement sont les suivants :

Etat Champs de la réponse Actions à réaliser

Transaction acceptée (prise d'abonnement réussie)

responseCode = 00

acquirerResponseCode = 00

Stockez dans votre base client la référence de la transaction :

Vous pouvez soumettre des paiements récurrents.

Transaction refusée (prise d'abonnement refusée)

responseCode = XX (différent de 00) Consultez le guide connecteur Sogenactif Paypage pour analyser la réponse de Sogenactif.

La collecte des coordonnées de paiement se fait sur votre site e-commerce.

Vous utilisez ensuite deux méthodes :

  • cardCheckEnrollment : vérifie l'enrôlement 3-D Secure de la carte (voir la documentation Sogenactif JSON ou SOAP pour connaître l'intégralité des paramètres de la requête)
  • cardValidateAuthenticationAndOrder : authentification du porteur et demande d'autorisation (voir la documentation Sogenactif JSON ou SOAP pour connaître l'intégralité des paramètres de la requête)

Pour la méthode cardCheckEnrollment, ces champs ont un comportement particulier et doivent être valorisé comme ceci :

Champ Valeur
paymentPattern RECURRING_1
challengeMode3DS CHALLENGE_MANDATE
amount montant de la première échéance de l'abonnement (peut-être valorisé à 0 si la première échéance est gratuite par exemple ou si le 1er paiement ne s'effectue que plus tard)
authentAmount à valoriser si le champ amount = 0 avec le montant moyen d'une occurence de paiement de l'abonnement.

Si le champ n'est pas rempli, le montant de l'authentification sera le même que celui indiqué dans le champ amount.

captureDay 0 à 6
captureMode AUTHOR_CAPTURE ou VALIDATION
Attention: Vous devez conserver la référence de la transaction dans votre système d'information, afin de débiter votre abonné pour les échéances ultérieures.

Une fois la prise d'abonnement acceptée, vous pouvez débiter des lots d'abonnés par transfert de fichier avec Sogenactif Office Batch, grâce à la duplication de transactions. Les transactions sont automatiquement chaînées avec la CIT par Sogenactif.


Diagramme décrivant le débit de l'abonné via Sips Office Batch

Vous formatez un fichier Sogenactif Office Batch constitué de requêtes duplicate.

Chaque enregistrement duplicate contient :

Les étapes suivantes s'enchainent :

  1. Vous envoyez le fichier à Sogenactif via FTPS ou SFTP.
  2. Sogenactif récupère les coordonnées de paiement de l’abonné.
  3. Sogenactif exécute des contrôles anti-fraude que vous avez configurés sur votre boutique.
  4. Sogenactif envoie les demandes d’autorisation aux acquéreurs.
  5. Sogenactif stocke la transaction dans le back office.
  6. Sogenactif formate le fichier réponse et vous le renvoie.
  7. Le soir, Sogenactif envoie les remises de paiement des transactions acceptées.

Veuillez consulter les guides Sogenactif Office Batch XML ou Sogenactif Office Batch CSV pour avoir le détail sur la mise en œuvre (structure du fichier, description des enregistrements, transfert du fichier, gestion des erreurs…).

Pour générer un paiement récurrent avec la méthode duplicate, vous renseignez les champs ci-dessous :

Champ Valeur
fromTransactionReference ou couple fromS10TransactionReference.fromS10TransactionId / fromS10TransactionReference.fromS10TransactionIdDate Référence de la transaction réalisée lors de la prise d'abonnement

ou

Référence de la transaction réalisée lors de la dernière modification du moyen de paiement

amount montant de l'échéance

Veuillez consulter les guides Sogenactif Office Batch XML ou Sogenactif Office Batch CSV pour savoir comment renseigner les autres champs de la requête en fonction de votre besoin métier.

Etat Champs de la réponse Actions à réaliser
Transaction acceptée responseCode = 00 Vérifiez le lendemain dans le journal des transactions que l’envoi en paiement a bien été effectué (transactionStatus = CAPTURED).
Transaction refusée responseCode = XX Consultez les guides connecteurs Sogenactif Office Batch pour analyser la réponse de Sogenactif.

Le connecteur Sogenactif Office Serveur JSON/SOAP propose aussi la méthode duplicate en mode message avec les mêmes règles que Sogenactif Office Batch pour le formatage de la requête et l’analyse de la réponse.

Veuillez consulter un des guides Sogenactif Office Serveur pour avoir le détail de mise en œuvre.

Comme vous avez conservé la date d'expiration du moyen de paiement lors de la prise d'abonnement, vous pouvez alerter votre abonné suffisament longtemps avant la date d'expiration, de manière à lui demander de revenir sur votre site e-commerce et renouveler son moyen de paiement.

Le renouvellement du moyen de paiement doit être géré de la même manière qu'une prise d'abonnement. Une fois le nouveau moyen de paiement saisi et validé, conservez la nouvelle date d'expiration du moyen de paiement, ainsi que la nouvelle référence de transaction pour l'utiliser au moment des futurs débits récurrents.

Voici un exemple de paiement par abonnement avec une première échéance à moins de 6 jours :


Exemple en image d'un abonnement dont le 1er paiement est à moins de 6 jours

Connecteurs :

CIT MIT
Connecteur
  • Sogenactif Paypage
  • Sogenactif Office Serveur
  • Sogenactif In-App
  • Sogenactif Office Serveur
  • Sogenactif Office Batch

Paramètres de la requête :

champ CIT MIT
paymentPattern RECURRING_1 X
ChallengeMode3DS CHALLENGE_MANDATE X
captureDay [ 0 , 6 ] [ 0 , 99 ]
captureMode
  • AUTHOR_CAPTURE
  • VALIDATION
  • AUTHOR_CAPTURE
  • VALIDATION
amount montant 1ère échéance montant nème échéance
authentAmount montant moyen des échéances X

Voici un exemple de paiement par abonnement avec une première échéance à plus de 6 jours :


Exemple en image d'un paiement par abonnement avec 1ere échéance à plus de 6 jours

Le 28 juillet 2021 jour de la commande (CIT) avec une authentification à 10 euros et une demande de renseignement déclenchée par un montant à 0 euro.. La durée de la demande d'autorisation court du 28 juillet au 3 août (6 jours). Le 5 août 2021, soit J+8, déclenchement de la 1ère échéance (MIT1) qui entraîne une demande d'autorisation chaînée avec la CIT et une remise sans données 3DS de 10 euros. Le 2 septembre 2021, soit J+34, déclenchement de la 2ème échéance (MIT2) qui entraîne une demande d'autorisation chaînée avec la CIT et une remise sans données 3DS de 10 euros.

Connecteurs :

CIT MIT
Connecteur
  • Sogenactif Paypage
  • Sogenactif Office Serveur
  • Sogenactif In-App
  • Sogenactif Office Serveur
  • Sogenactif Office Batch

Paramètres de la requête :

champ CIT MIT
paymentPattern RECURRING_1 X
ChallengeMode3DS CHALLENGE_MANDATE X
captureDay 0 [ 0 , 99 ]
captureMode X
  • AUTHOR_CAPTURE
  • VALIDATION
amount 0 montant nème échéance
authentAmount montant moyen des échéances X

Lorsque vous avez choisi les interfaces Sogenactif qui répondent à votre besoin (cf. chap. Choix des connecteurs Sogenactif pour l’abonnement), vous devez intégrer les connecteurs pour connecter votre site à Sogenactif et suivre les indications de la partie mise en oeuvre.

Une fois la mise en œuvre des connecteurs Sogenactif réalisée, vous pouvez effectuer des tests pour valider votre intégration.

Données de test
merchantId 201000076690001
clé secrète p64ifeYBVIaRcjaWoahCiw9L8wokNLqG2_YOj_POD4g
version de la clé 1
cartes de test cf page "Cartes de test"

Serveur URL de test
Paypage POST https://payment-webinit-sogenactif.test.sips-services.com/paymentInit
Paypage JSON https://payment-webinit-sogenactif.test.sips-services.com/rs-services/v2/paymentInit
Paypage SOAP https://payment-webinit-sogenactif.test.sips-services.com/services/v2/paymentInit
Office https://office-server-sogenactif.test.sips-services.com
IMPORTANT: la boutique de test est configurée en "mode transactionReference", sans génération automatique du transactionReference. Par conséquent, il est nécessaire que vous transmettiez le champ transactionRefence valorisé dans vos requêtes de test.

Votre boutique n’est pas inscrite sur Sogenactif.

Si votre boutique n’a pas encore été inscrite, vous devez remplir le formulaire d’inscription et le retourner à Société Générale.

Votre boutique est déjà inscrite sur Sogenactif.

Si votre boutique est déjà inscrite sur Sogenactif, vous devez vous assurer auprès de Société Générale que vous avez bien accès à Sogenactif Office Batch ou à Sogenactif Office Serveur.

Vous devez changer l’URL pour vous connecter au serveur Sogenactif de production en utilisant les identifiants reçus lors l’inscription merchantId, secretKey et keyVersion.

URL Sogenactif URL du serveur de paiement Sogenactif récupéré par mail.
MerchantId Identifiant de la boutique reçu par mail.
SecretKey Clé secrète que vous récupérez via l’extranet Sogenactif Téléchargement.
KeyVersion Version clé secrète récupérée sur Sogenactif Téléchargement (logiquement 1 pour la 1ère clé).
Tip: une erreur fréquente est d’oublier un de ces quatre paramètres, ce qui conduit systématiquement à une erreur.

Si vous souhaitez personnaliser vos pages de paiement, veuillez suivre la procédure décrite dans la documentation Custompages.

Retourner en haut de page Besoin d'aide ?

Besoin d'aide ?

Fermer

Ce site utilise des traceurs pour améliorer votre expérience de navigation, effectuer des analyses et des recherches sur votre utilisation du site web de documentation Sogenactif.
En fermant ce bandeau vous refusez notre utilisation des traceurs sur votre appareil.

Paramètres