logo Sogenactif

Release 22.4

aller directement au contenu

Rechercher par mots clés

Paiement en plusieurs fois

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 échelonné jusqu'au démarrage en production.

L’objectif est de présenter et d'expliquer comment mettre en oeuvre le paiement échelonné 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

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

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 échelonné (montant, nombre d'échéances, …) ;

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 échelonné comporte plusieurs volets :

  • la mise en place de l'échéancier lors du paiement de la première échéance (CIT) ;
  • le traitement des échéances suivantes (MIT) ;
  • la gestion de l'expiration du moyen de paiement du client ou du refus d'une des échéances.

Les moyens de paiement permettant d’effectuer des paiements récurrents sont : CB, Visa, Mastercard et Amex.

Comme Sogenactif offre plusieurs interfaces pour traiter le paiement échelonné, il convient d’analyser votre besoin métier pour choisir les connecteurs les plus adaptés à votre situation.

Il existe deux modes d'intégration différents pour créer des paiements échelonné :

  • via Sogenactif Paypage : vous transmettez le détail de chaque échéance à Sogenactif : une autorisation est effectuée lors de la prise de commande pour payer la première échéance. Si le paiement est accepté, les différentes échéances sont effectivement créées et envoyées en banque à la date demandée ;
  • via Sogenactif Office Serveur, Sogenactif Office Batch ou Sogenactif Gestion: vous appelez Sogenactif à chaque nouvelle échéance : lors du premier paiement Sogenactif se charge uniquement de traiter celui-ci. Vous devez rappeler Sogenactif à nouveau à chaque échéance en appliquant l'une des méthodes suivantes :
    • Dupliquer la première transaction (fonction duplicate)
    • En créant une nouvelle transaction
      • via Sogenactif Gestion
      • fonction walletOrder avec l'identifiant du wallet Sogenactif dans lequel la carte de la CIT est enregistrée

Le tableau ci-dessous récapitule les interfaces disponibles en fonction de ces deux modes :

Cas d'usage Sogenactif Paypage Sogenactif Office Serveur Sogenactif Office Batch Sogenactif In-App Sogenactif Gestion
Passage de commande et première échéance (CIT) V V X V X
Echéances suivantes (MIT) Gérées automatiquement par Sogenactif Gérées par le commerçant Gérées par le commerçant X V

En fonction de la manière dont vous traitez les échéances, les données à conserver varient :

Connecteur Données à conserver pour traiter les MIT
Sogenactif Paypage X
Sogenactif Office Serveur via duplication référence de la CIT (champ transactionReference ou s10TransactionId/s10TransactionDate)
Sogenactif Office Serveur via walletOrder

Pour rappel, le client doit nécessairement s'authentifier avec 3-D Secure. Le montant à authentifier doit être égal au montant total de la commande. Sur ce type de paiement, aucune exemption à l'authentification forte ne peut être accordée. Pour des raisons réglementaires, le frictionless n'est pas possible lors de la mise en place d'un paiement échelonné, il y aura nécessairement une authentification en mode Challenge. Cette première échéance bénéficie de la garantie de paiement (contrairement aux échéances suivantes).

Le moyen de paiement doit être valide à la date de la dernière échéance (par exemple, dans le cas des cartes, la date d’expiration doit être postérieure à la dernière échéance). Dans le cas contraire, le paiement est refusé.

Lorsque la mise en place des différents paiement est faite avec Sogenactif Paypage, l'ensemble des échéances seront créées lors de la saisie des coordonnées bancaires, dès lors que le premier paiement est accepté.


Diagramme décrivant la prise de commande et 1ère échéance via Paypage

  1. Pour mettre en place l'échéancier, vous redirigez le client vers Sogenactif Paypage en communiquant dans la requête les informations détaillées sur toutes les échéances (référence, date de remise souhaitée, montant, ...).
  2. Sogenactif affiche la page de paiement (seuls les moyens de paiements supportant le paiement échelonné sont disponibles), le client sélectionne le moyen de paiement, 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 une transaction par échéance dans le back office.
  7. Sogenactif vous retourne les réponses manuelle et automatique contenant les détails de la transaction.
  8. Sogenactif envoie la transaction en remise (si applicable) en fonction des modalités que vous avez paramétrées dans la requête de paiement.

Pages de paiement

  • affichage de chaque date et montant, si moins de 5 échéances :

    Capture d'écran de la Paypage affichant les échéances si moins de 5

    Dans le bloc "Détails de la transaction", dans la section intitulée "Echéances", chaque échéance avec la date et le montant s'affiche l'une en dessous de l'autre.
  • affichage du nombre d'échéances, des dates de début et fin des opérations, si plus de 5 échéances :

    Capture d'écran de la paypage montrant les échances si plus de 5

    Dans le bloc"Détails de la transaction", dans la section intitulée "Paiement en x échéances" (x étant le nombre d'échéances) est affichée ceci : Première échéance : "date de la première échéance : montant". Suivi de x échéances, du "date de la première échéance +1" au "date de la dernière échéance".

À la fin du processus, le ticket affiche le détail des échéances :


Capture d'écran du ticket affichant le détail des échéances

En dessous du message indiquant que le paiement a été accepté est affiché un tableau reprenant le détail des échéances avec la date d'échéance en première colonne, le montant en deuxième colonne et la référence de la transaction dans la troisièmres colonne.

Vous devez renseigner certains paramètres de manière spécifique pour demander la création d'un paiement échelonné :

Champ Règle de valorisation
paymentPattern INSTALMENT
challengeMode3DS forcé à CHALLENGE_MANDATE
captureMode Forcé par Sogenactif Paypage à AUTOR_CAPTURE quelle que soit la valeur transmise.
captureDay Ignoré par Sogenactif Paypage, les dates fournies dans le champ instalmentData.datesList font référence.
amount Doit être égale à la somme des montants des échéances transmis dans la liste instalmentData.amountsList.
instalmentData.number nombre d'échéances
instalmentData.datesList Les dates de chaque échéance :
  • doivent être uniques ;
  • transmises dans l'ordre chronologique ;
  • la période entre la première et la dernière date ne peut pas dépasser la durée légale du paiement échelonné sans frais (90 jours).
instalmentData.transactionReferencesList Liste des transactionReference des différentes échéances.Le premier élément de la liste doit être égal au champ transactionReference de la requête.
instalmentData.amountsList Liste des montants des échéances transmis dans l'ordre des échéances. La somme des montant doit être égal au champ amount de la requête.

Veuillez consulter un des guides Sogenactif Paypage pour savoir comment renseigner les autres champs.

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

Transaction acceptée (premier paiement effectué avec succès).

responseCode = 00

acquirerResponseCode = 00

Transaction refusée (premier paiement refusé).

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

Sogenactif traite automatiquement les échéances suivantes en fonction des dates de remise demandées. Cela signifie que pour chaque échéance, Sogenactif effectue une demande d'autorisation et de remise (si applicable) automatiquement le jour demandé.

Sogenactif se charge de chaîner chaque échéance (MIT) avec la transaction créée lors du premier paiement (CIT).

Vous pouvez consulter le résultat de ces opérations dans vos journaux des opérations ou sur Sogenactif Gestion.

Avec Sogenactif Office Serveur, vous avez la possibilité de gérer chaque échéance d'un paiement échelonné.

Vous procédez tout d'abord au premier paiement pour la mise en place de l'échéancier. Si ce premier paiement est effectué avec succès, plusieurs options s'offrent à vous

  • Dupliquer la première transaction : la chaînage est effectué par Sogenactif
  • Créer de nouvelles transactions grâce à la méthode walletOrder : vous devez effectuer le chaînage CIT-MIT vous-même


Diagramme décrivant la prise de commande et 1ère échéance via Office

  1. Vous affichez l'échéancier de paiement sur les pages de votre site Web et vous demandez à votre client de saisir ses coordonnées bancaires.
  2. Vous effectuez une requête vers Sogenactif Office Serveur en communiquant dans la requête les informations détaillées sur la commande globale et sur la première échéance.
  3. Sogenactif procède à la vérification 3-D Secure.
  4. Sogenactif effectue les contrôles anti-fraude que vous avez paramétrés.
  5. Sogenactif envoie une demande d’autorisation à l’acquéreur.
  6. Sogenactif enregistre la première échéance dans le back office.
  7. Sogenactif vous retourne le résultat du paiement dans la réponse.
  8. Sogenactif envoie la transaction en remise (si applicable) en fonction des modalités que vous avez paramétrées dans la requête de paiement.

Les méthodes cardCheckEnrollment et walletCheckEnrollment vous permettent d'initialiser un paiement échelonné avec Sogenactif Office Serveur.

Vous devez renseigner certains paramètres de manière spécifique pour demander la création de ce type de paiement :

Champ Règle de valorisation
paymentPattern INSTALMENT
challengeMode3DS forcé à CHALLENGE_MANDATE
amount Doit être positionné au montant de la première échéance.
authenticationData.authentAmount Doit être positionné au montant global de la commande.
recurringData.recurringSequence Doit être positionné à 1 (la séquence de l'échéance en cours de traitement).
recurringData.recurringSequenceMax Doit être positionné au nombre d'échéances total.
recurringData.recurringPeriod Doit être positionné au nombre de jours minimum entre deux échéances consécutives.
recurringData.recurringEndDate Doit être positionné à la date de la dernière échéance prévue.

Veuillez consulter un des guides Sogenactif Office Serveur pour savoir comment renseigner les autres champs.

En fonction de la réponse retournée par Sogenactif Office Serveur, vous déterminez la suite du déroulement de ce paiement échelonné :

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

Transaction acceptée (premier paiement effectué avec succès)

responseCode = 00

acquirerResponseCode = 00

Vous pouvez traiter la commande en fonction du niveau de garantie souhaitée (champ guaranteeIndicator).

Vous conservez la référence de cette première transaction (CIT) qui vous servira pour les échéances suivantes.

Transaction refusée (premier paiement refusé)

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

Vous pouvez proposer à votre client de payer avec un autre moyen de paiement en générant une nouvelle requête.

L'appel à la fonction duplication vous permet de procéder au paiement de chaque échéance suivante (MIT).

Sogenactif Office Serveur se charge de chaîner chaque échéance (MIT) avec la transaction créée lors du premier paiement (CIT).

Consultez le guide connecteur Sogenactif Office Serveur ou Sogenactif Office Batch pour mettre en place l'appel à la fonction duplicate.

Utilisation de la méthode walletOrder si la carte a été préalablement enregistrée dans le wallet Sogenactif (lors de la CIT ou auparavant lors d'un achat précédent). En plus des champs classiques de la méthode, vous devez envoyer les champs ci-dessous :

Champ Valeur
paymentPattern RECURRING_N
initialSchemeTransactionIdentifier valeur du champ schemeTransactionIdentifier reçu en réponse de la CIT
merchantWalletId identifiant du wallet dans lequel la carte utilisée lors de la CIT est stockées
paymentMeanId identifiant de la carte utilisée lors de la CIT au sein du wallet Sogenactif

Pour connaître l'ensemble des champs de la méthode walletOrder, veuillez-vous référer aux documentations des connecteurs Sogenactif Office Serveur et Sogenactif Office Batch.

Voici un exemple de paiement en plusieurs fois avec le connecteur Sogenactif Paypage :

Paiement d'une commande de 900€ en trois échéances de 300€

  • Jour de la commande
    • Authentification 3DS v2 avec montant total commande (challenge obligatoire) : 900€
    • Demande d’Autorisation avec données 3DS, montant première échéance : 300€
    • Remise avec données 3DS : 300€
  • Jour de la 2ème échéance
    • Demande d’autorisation chaînée avec la CIT : 300€
    • Remise sans données 3DS : 300€
  • Jour de la 3ème échéance
    • Demande d’autorisation chaînée avec la CIT : 300€
    • Remise sans données 3DS : 300€

Paramètres de la requête :

champ CIT MIT
paymentPattern INSTALMENT Gérée par Sogenactif
ChallengeMode3DS CHALLENGE_MANDATE
captureMode AUTHOR_CAPTURE
amount somme des montants des échéances
instalmentData.datesList dates des échéances
instalmentData.transactionRefrencesList transactionReference des différentes échéances
instalmentData.amountsList montants des différentes échéances
instalmentData.number nombre d'échéances

Voici un exemple de paiement en plusieurs fois avec un premier paiement à moins de 6 jours :

Paiement d'une commande de 500€ en 2 échéances :

  • Jour de la commande
    • Authentification 3DS v2 avec montant total commande (challenge obligatoire) : 500€
    • Demande d’Autorisation avec données 3DS, montant première échéance : 250€
  • Jour de la 1ère échéance
    • Remise avec données 3DS : 250€
  • Jour de la 2ème échéance
    • Demande d'autorisation chaînée avec la CIT : 250€
    • Remise sans donnée 3DS : 250€

Exemple en image d'un paiement en plusieurs fois dont 1er paiement à moins de 6 jours

Le 28 juillet 2021 jour de la commande (CIT) avec une authentification du montant total de la commande, soit 500 euros et une demande d'autorisation du montant de la première échéance, soit 250 euros. La durée de la demande d'autorisation cours du 28 juillet au 3 août (6 jours). Le 2 août 2021, soit J+4, a lieu la remise avec les données 3DS de la première échéances (CIT) pour 250 euros. Le 2 septembre 2021, soit J+31, déclenchement de la 2ème échéance (MIT1) entraînant une demande d'autorisation chaînée avec la CIT et une remise dans données 3DS pour un montant de 250 euros.

Connecteurs :

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

Paramètres de la requête :

champ CIT MIT via duplicate MIT via walletOrder
paymentPattern INSTALMENT X INSTALMENT
ChallengeMode3DS CHALLENGE_MANDATE X X
captureDay [ 0 , 6 ] [ 0 , 99 ] [ 0 , 99 ]
captureMode AUTHOR_CAPTURE
  • AUTHOR_CAPTURE
  • VALIDATION
  • AUTHOR_CAPTURE
  • VALIDATION
amount montant 1ère échéance montant nème échéance montant nème échéance
authenticationData.authentAmount montant total de la commande X X
recurringData.recurringSequence 1 X Numéro d'échéance
recurringData.recurringSequenceMax nombre total d'échéances X X
recurringData.recurringPeriod nombre maximum de jours entre 2 échéances consécutives X X
recurringData.recurringEndDate date de la dernière échéance X X
initialSchemeTransactionIdentifier X X valeur du champ schemeTransactionIdentifier reçu en réponse de la CIT

Voici un exemple de paiement en plusieurs fois avec un premier paiement à plus de 6 jours :

Paiement d'une commande de 500€ en 2 échéances :

  • Jour de la commande
    • Authentification 3DS v2 avec montant total commande (challenge obligatoire) : 500€
    • Demande de renseignement : autorisation avec données 3DS : 0€
  • Jour de la 1ère échéance
    • Demande d'autorisation chaînée avec la CIT : 250€
    • Remise sans donnée 3DS : 250€
  • Jour de la 2ème échéance
    • Demande d'autorisation chaînée avec la CIT : 250€
    • Remise sans donnée 3DS : 250€

Exemple en image d'un paiement en plusieurs fois dont 1er paiement à plus de 6 jours

Le 28 juillet 2021, jour de la commande (CIT) avec une authentification du montant total de la commande, soit 500 euros et une demande de renseignement déclenchée par un montant à 0 euro. La durée de la demande d'autorisation cours du 28 juillet au 3 août (6 jours). Le 5 août 2021, soit J+8, a lieu le déclencement de la 1ère échéance (MIT1) entrainant une demande d'autorisation chaînée avec la CIT et une remise sans les données 3DS pour un montant de 250 euros. Le 5 septembre 2021, soit J+38, déclenchement de la 2ème échéance (MIT2) entraînant une demande d'autorisation chaînée avec la CIT et une remise dans données 3DS pour un montant de 250 euros.

Connecteurs :

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

Paramètres de la requête :

champ CIT MIT via duplicate MIT via walletOrder
paymentPattern INSTALMENT X INSTALMENT
ChallengeMode3DS CHALLENGE_MANDATE X X
captureDay 0 [ 0 , 99 ] [ 0 , 99 ]
captureMode X
  • AUTHOR_CAPTURE
  • VALIDATION
  • AUTHOR_CAPTURE
  • VALIDATION
amount 0 montant nème échéance montant nème échéance
authentAmount montant total de la commande X X
recurringSequence 1 X Numéro d'échéance
initialSchemeTransactionIdentifier X X valeur du champ schemeTransactionIdentifier reçu en réponse de la CIT

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

Votre boutique doit être configurée sur Sogenactif pour accepter le paiement échelonné. Vous devez demander à Société Générale d’activer ce service sur votre boutique si ce n'est pas déjà le cas.

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 transactionReference 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 Paypage ou à Sogenactif Office Serveur en fonction du connecteur choisi.

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

URL Sogenactif URL du serveur de paiement Sogenactif récupéré par e-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