Introduction

WL Sips 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 en plusieurs fois , …).

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.

A qui s’adresse ce document

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 WL Sips .

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

  • Présentation fonctionnelle
  • Guide de Configuration des fonctionnalités
Note: WL Sips 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.

Prérequis

Le paiement par abonnement nécessite que les coordonnées de paiement de vos clients abonnés soient stockées par WL Sips pour vous permettre d’effectuer des paiements.

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 WL Sips . Pour davantage d'informations sur le RGPD, veuillez vous référer à notre guide de Sécurité des systèmes d'informations ,
  • Informer vos clients du stockage de leurs coordonnées et des modalités des paiements récurrents (durée, montant, périodicité…),
  • Vérifier auprès de votre acquéreur que votre contrat supporte les paiements récurrents.

Vue d'ensemble du service abonnement

Le paiement par abonnement comporte plusieurs volets :

  • La prise d'abonnement,
  • Les paiements récurrents,
  • La gestion de l'expiration du moyen de paiement de l'abonné,
  • L’authentification de l’abonné.

Données à conserver

Lorsque vous enregistrez un nouvel abonné dans votre système d’information, vous devez lui associer la référence de la transaction de paiement initiée lors de la collecte de ses coordonnées de paiement. Les coordonnées de paiement sont stockées dans le système d'information de WL Sips .

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

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

  • Carte CB, Visa, Mastercard, Amex,
  • Mandat SDD (SEPA Direct Debit)

Choix des connecteurs WL Sips pour l’abonnement

Comme WL Sips 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 Sips Paypage Sips Office Sips Office CSE Sips In-App Sips Office Batch Sips Office Extranet BackOffice Préconisations pour choisir le connecteur
Prise d'abonnement
Vous souhaitez vous affranchir des exigences PCI. V X V V X X Si vous utilisez Sips 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 Sips In-App .
Vous affichez et sécurisez les pages de saisie des coordonnées de paiement X V V V X X Sips Office répond à votre besoin pour le e-commerce. Pour le m-commerce, nous préconisons l’usage de Sips 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 Sips Office Batch est le connecteur adapté au traitement massif de paiement récurrents, mais vous pouvez aussi utiliser Sips Office
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 Sips Office 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 Sips Office Batch vous permet d’initialiser la base des abonnés à partir d’une base existante.

Mise en oeuvre

Prise d'abonnement avec Sips Paypage

La collecte des coordonnées de paiement se fait sur Sips Paypage . Si le moyen de paiement de l'abonné est une carte, il doit nécessairement s'authentifier 3-D Secure. Vous devez conserver la référence de la transaction dans votre système d'informations, afin de débiter votre abonné pour les échéances ultérieures.

Description

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

Paraméter la requête

C’est une requête Sips Paypage classique dans laquelle vous renseignez le montant de la première échéance dans le champ amount .

Si la première échéance est gratuite, vous transmettez une transaction en mode validation que vous ne validerez pas (champ captureMode = VALIDATION).

Veuillez consulter un des guides Sips Paypage pour savoir comment renseigner la requête en fonction de votre besoin métier.

Analyser la réponse

WL Sips retourne une réponse manuelle et automatique classique Sips 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 Sips Paypage pour analyser la réponse de WL Sips .

Prise d'abonnement avec Sips Office

La collecte des coordonnées de paiement se fait sur votre site e-commerce. Si le moyen de paiement de l'abonné est une carte, il doit nécessairement s'authentifier 3-D Secure. Vous devez conserver la référence de la transaction dans votre système d'informations, afin de débiter votre abonné pour les échéances ultérieures.

Lors de la prise d'abonnement, vous transmettez une transaction de paiement, avec le montant de la première échénace dans le champ amount . Veuillez vous référer au Guide 3-D Secure pour mettre en oeuvre la prise d'abonnement.

Paiements récurrents avec Sips Office Batch

Une fois la prise d'abonnement acceptée, vous pouvez débiter des lots d'abonnés par transfert de fichier avec Sips Office Batch , grâce à la duplication de transactions.

Description

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

Chaque enregistrement duplicate contient :

Les étapes suivantes s'nechainent :

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

Veuillez consulter les guides Sips Office Batch XML ou Sips 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…).

Paramétrer la requête

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

Champ Valeur Commentaire
fromTransactionReference ou couple fromS10TransactionReference.fromS10TransactionId / sfromS10TransactionReference.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 L’identifiant du moyen de paiement dans le wallet est obligatoire bien que le wallet ne contienne qu'un seul moyen de paiement.

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

Analyser la réponse

Etat Champs de la réponse Actions à réaliser
Transaction acceptée responseCode = 00 Vérifier 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 Sips Office Batch pour analyser la réponse de WL Sips .

Paiements récurrents avec Sips Office

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

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

Expiration du moyen de paiement

Vous avez conservé la date d'expiration du moyen de paiement lors de la prise d'abonnement, ce qui vous permet d'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 référence de transaction pour l'utiliser au moment des futurs débits récurrents.

Démarrer l'abonnement en 4 étapes

Etape 2 - Tester le service sur l'environnement de recette

Une fois la mise en œuvre des connecteurs WL Sips 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.test.sips-atos.com/paymentInit
Paypage JSON https://payment-webinit.test.sips-atos.com/rs-services/v2/paymentInit
Paypage SOAP https://payment-webinit.test.sips-atos.com/services/v2/paymentInit
Office https://office-server.test.sips-atos.com
Attention: 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.

Etape 3 - Souscrire au service en production

Votre boutique n’est pas inscrite sur WL Sips .

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

Votre boutique est déjà inscrite sur WL Sips .

Si votre boutique est déjà inscrite sur WL Sips , vous devez vous assurer auprès de Worldline que vous avez bien accès à Sips Office Batch ou à Sips Office

Etape 4 - Démarrer et valider le service en production

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

URL WL Sips URL du serveur de paiement WL Sips 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 Sips Download .
KeyVersion Version clé secrète récupérée sur Sips Download (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 le document Custompages .