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 :

  • L’enrôlement de l’abonné,
  • Le paiement de l’abonné,
  • La gestion de l’abonné,
  • L’authentification de l’abonné.

Stockage des coordonnées de l’abonné

Lorsque vous enregistrez un abonné dans votre système d’information, vous devez lui associer un identifiant de compte unique que WL Sips va utiliser pour stocker les coordonnées de paiement. Par la suite, vous pouvez le débiter de manière récurrente par transfert de fichier ou en mode en ligne.

Schéma de principe du paiement par abonnement avec une carte :

Vous gérez l’identifiant de l’abonné qui est associé au compte de votre client. WL Sips stocke dans un espace sécurisé PCI appelé wallet les coordonnées de paiement de l’abonné.

Le schéma ci-dessus s’applique aussi au paiement par abonnement avec un mandat SDD.

Dans ce cas, WL Sips stocke l’identifiant du mandat dans la base wallet.

Le service abonnement se base sur le wallet WL Sips qui est un portefeuille virtuel sécurisé dans lequel sont stockées les coordonnées de paiement de l’abonné :

  • Le wallet est un mono moyen de paiement,
  • 1 Abonné = 1 Wallet = 1 moyen de paiement,
  • Identifiant Abonné = merchantWalletId .

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

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

WL Sips stocke dans le wallet, toutes informations nécessaires pour vous permettre de débiter votre abonné à partir de son identifiant :

  • Carte CB, Visa, Mastercard
    • Numéro de carte
    • Date d’expiration
    • Marque de la carte
  • Mandat SDD
    • Identifiant du mandat
Note: par défaut, chaque boutique a sa propre base d’abonnés.

Cependant WL Sips permet de partager une même base wallet entre plusieurs boutiques d’une même enseigne.

Si vous êtes dans ce cas, veuillez contacter l’assistance technique.

Enrôlement de l’abonné

L’enrôlement de l’abonné consiste à enregistrer ses coordonnées de paiement dans le wallet de WL Sips . L’enrôlement peut être associé ou non à un premier paiement.

3 interfaces permettent d’enrôler un abonné :

  • Sips Paypage : vous enregistrez les données de paiement de l’abonné lors du premier paiement réalisé depuis les pages hébergées par WL Sips .
  • Sips Office M2M : vous gérez vos propres pages pour la saisie des données de paiement et vous utilisez l’interface web en ligne pour enregistrer l’abonné dans le wallet WL Sips .
  • Sips Walletpage : vous enregistrez les données de paiement de l’abonné dans un contexte hors paiement depuis les pages de gestion de wallet hébergées par WL Sips .

Paiement de l’abonné

Les paiements récurrents sont ensuite transmis à partir de l’identifiant de l’abonné sans que vous ayez à communiquer les données sensibles.

2 types d’interfaces pour débiter ou créditer les abonnés :

  • Sips Office M2M : Vous vous connectez à WL Sips via une interface en ligne Web pour transmettre les demandes de débit ou de crédit.
  • Sips Office Batch : A chaque échéance, vous transférez à WL Sips le fichier contenant les requêtes de débit ou crédit des abonnés.

Gestion de l’abonné

Du fait que le service d’abonnement se base sur un wallet mono moyen de paiement (1 wallet = 1 moyen de paiement),

la gestion du wallet se traduit par :

  • le changement d’un moyen de paiement par suppression du wallet existant et création d’un nouveau wallet ;
  • la suppression d’un wallet et des coordonnées de paiement à la demande de l’abonné (obligation légale).

Moyen de paiement expiré :

  • les moyens de paiement et les wallets associés, expirés depuis plus de 3 mois, sont supprimés automatiquement de la base wallet

Authentification de l’abonné

Dans la cinématique d’abonnement, vous devez authentifier votre client avant d’accéder à l’identifiant abonné stocké dans votre base client.

Une fois l’authentification faite, vous transmettez à WL Sips l’identifiant abonné dans la requête via le champ merchantWalletId .

Votre gestion des identifiants abonnés attribués à vos clients doit :

  • garantir une relation 1-1 entre l’abonné et le client (1 client = 1 Abonné) ;
  • permettre le stockage des identifiants abonnés.
Attention: l’authentification de l’abonné est sous votre responsabilité.

WL Sips gère le stockage sécurisé des coordonnées de paiement de l’abonné.

Personnalisation des pages

Afin de conserver la charte graphique de votre site de commerce électronique, les pages des interfaces Sips Paypage et Sips Walletpage sont personnalisables.

Veuillez consulter le guide de personnalisation des pages pour davantage d'informations.

Reporting

Nous préconisons l’utilisation de la version TAB20_V2, ou plus, des journaux des transactions, afin d’y retrouver le champ merchantWalletId .

Pour plus d’informations, merci de consulter le guide de description des journaux.

Choix des connecteurs WL Sips pour l’abonnement

Comme WL Sips offre plusieurs interfaces pour enrôler les abonnés et traiter les paiements 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 In-App Sips Office Batch Sips Walletpage Sips Office Extranet BackOffice Préconisations pour choisir le connecteur
Gestion des pages d'enrôlement
Vous externalisez les pages de saisie des coordonnées de paiement pour vous affranchir des exigences PCI. V X X X V X Si vous utilisez Sips Paypage pour traiter vos paiements, vous pouvez capitaliser cette intégration existante pour gérer l’enrôlement de vos abonnés. Sinon utilisez Sips Walletpage pour enrôler vos abonnés.
Vous gérez les pages de saisie des coordonnées de paiement que vous intégrez dans votre processus d’enrôlement des abonnés. X V V X 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 .
Enrôlement avec ou sans paiement
Vous enrôlez l'abonné lors d'un paiement. V V V X X X Sips Paypage , Sips Office ou Sips In-App répondent à votre besoin, en fonction de votre décision d’externaliser ou pas les pages de saisie des coordonnés de paiement.
Vous enrôlez l'abonné hors contexte paiement. non V V V V X Sips Walletpage , Sips Office ou Sips In-App répondent à votre besoin, en fonction de votre décision d’externaliser ou pas les pages de saisie des coordonnés de paiement.
Débiter ou créditer l'abonné
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 V X X Le mode fichier de Sips Office Batch est le connecteur adapté au traitement périodique batch de paiement des abonnés, 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 X Le mode transactionnel de Sips Office est le connecteur adapté pour débiter ou créditer vos abonnés à échéances variables.
Gérer l'abonné
Renouveler le moyen de paiement de l'abonné. Le renouvellement est traité comme l’enrôlement d’un abonné par l’enregistrement des coordonnées de paiement dans un nouveau wallet. Réutilisez le même connecteur que celui utilisé pour l’enrôlement des abonnés.
Vous supprimez l'abonné. X V V V V V Utilisez Sips Office si vous souhaitez une suppression en temps réel et Sips Office Batch dans le cas contraire. Si vous ne souhaitez pas automatiser cette fonctionnalité, vous pouvez supprimer vos abonnés à partir de l’extranet BackOffice WL Sips .
Initialisation de la base des abonnés
Vous migrez une base abonnés existante. X X X V X X Sips Office Batch vous permet d’initialiser la base des abonnés à partir d’une base existante.

Mise en œuvre

Afin de mettre en œuvre l’abonnement WL Sips , vous devez vous munir du guide des connecteurs adéquat.

Enrôler l’abonné avec Sips Walletpage

Avec Sips Walletpage , vous permettez à votre abonné de s’enrôler en dehors d’un contexte de paiement.

Description

  1. Lors du processus d’enrôlement de votre abonné, vous le redirigez vers Sips Walletpage pour lui permettre d’enregistrer ses coordonnées de paiement. L’abonné sélectionne un moyen de paiement, fournit ses coordonnées de paiement puis valide.
  2. WL Sips procède à la vérification 3-D Secure.
  3. WL Sips effectue les contrôles anti-fraude.
  4. WL Sips envoie une demande d’autorisation à l’Acquéreur.
  5. WL Sips enregistre les données du moyen de paiement dans le wallet si les contrôles fraude sont OK et l’autorisation acceptée.
  6. WL Sips affiche la page d’accueil contenant un message de confirmation. L’Abonné peut désormais voir son moyen de paiement sur la page d’accueil.
  7. WL Sips vous retourne les réponses manuelle et automatique contenant le contenu du wallet.

Paramétrer la requête

Sips Walletpage est l’interface qui permet à l’abonné de gérer son wallet.

Pour répondre au cas d’utilisation de l’abonnement vous devez renseigner les champs de la manière suivante:

Champ Valorisation dans le cadre de l’abonnement
merchantWalletId Identifiant de l’abonné
PaymentMeanBrandList Liste des moyens de paiement que vous souhaitez proposer en abonnement
walletActionnameList Création du wallet par ajout d’un moyen de paiement (valeur = ADDPM)

Veuillez consulter le guide Sips Walletpage pour savoir comment renseigner la requête en fonction de votre besoin métier.

Analyser la réponse

Etat Champs de la réponse Action à réaliser
Abonné enrôlé

walletPaymentMeanDataList contient 1 moyen de paiement.

walletCreationDateTime renseigné.

Stockez dans votre base client les données suivantes de l’abonné :

  • merchantWalletId
  • paymentMeanId
  • PanExpiryDate
  • maskedPAN

Vous pouvez soumettre des paiements récurrents.

Abonné non enrôlé

walletPaymentMeanDataList non renseigné.

walletCreationDateTime non renseigné.

Resoumettez une requête d’enrôlement du wallet

Enrôler l’abonné avec Sips Paypage

Il s’agit d’une cinématique de paiement Sips Paypage classique dans laquelle les coordonnées de paiement sont enregistrées dans le wallet en cas de transaction acceptée.

Description

  1. Pour enregistrer les coordonnées de paiement de l’abonné vous le redirigez vers Sips Paypage en communiquant dans la requête les données de la transaction (montant, devise, ..) ainsi que l’identifiant de l’abonné (champ merchantWalletId ).
  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. Si la transaction est acceptée WL Sips enregistre les coordonnées de paiement de l’abonné dans le wallet.
  8. WL Sips vous retourne les réponses manuelle et automatique contenant les détails de la transaction y compris le résultat de l’enregistrement de l’abonné dans le wallet.
  9. WL Sips vous retourne les réponses manuelle et automatique contenant les détails de la transaction y compris le résultat de l’enregistrement de l’abonné dans le wallet.
  10. 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.
Note: la réglementation vous impose d'indiquer au préalable à votre abonné que le moyen de paiement est enregistré et de faire référence aux mentions CNIL adéquates.

Paramétrer la requête

C’est une requête Sips Paypage classique dans laquelle vous renseignez l’identifiant de l'abonné (champ merchantWalletId ) pour l’enregistrement des coordonnées de paiement dans le wallet.

Pour enrôler un abonné sans 1er paiement associé, 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 à l’enrôlement de l’abonné sont les suivants :

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

Transaction acceptée

Abonné enrôlé

responseCode = 00

acquirerResponseCode = 00

paymentMeanId = 1

merchantWalletId = idem requête

Stockez dans votre base client les données suivantes de l’abonné :

  • merchantWalletId
  • paymentMeanId
  • PanExpiryDate
  • maskedPAN

Vous pouvez soumettre des paiements récurrents.

Transaction acceptée

Abonné non enrôlé

responseCode = 00

acquirerResponseCode = 00

paymentMeanId = non renseigné

merchantWalletId = idem requête

Transaction acceptée mais problème technique temporaire lors de l’enrôlement du moyen de paiement dans le wallet.

Transaction refusée

Abonné non enrôlé

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

Enrôler l’abonné avec Sips Office

Avant d’enregistrer le moyen de paiement dans le wallet, vous devez au préalable l’avoir vérifié via une requête de paiement standard.

Description

Vous gérez la saisie des données du moyen de paiement sur votre site Web.

  1. Etape 1 : Vous faîtes une requête à WL Sips pour vérifier le moyen de paiement avant d’enrôler L'abonné .
    • Authentification 3-D Secure pour vérifier que c’est bien le titulaire qui utilise la carte (CB, Visa, Mastercard).
    • Contrôles de lutte contre la fraude que vous avez configurés en fonction de vos règles métier (ex. carte étrangère, carte commerciale, ..)
    • Demande d’autorisation vers l’acquéreur pour vérifier que la carte n’est pas en opposition (carte volée, perdue, ..)
    1. WL Sips enregistre la transaction.
    2. En fonction des éléments fournis dans la requête, WL Sips envoie, ou pas, la transaction en remise vers l’acquéreur.
    • WL Sips vous envoie les résultats de la vérification du moyen de paiement.
  2. Etape 2 : Une fois la vérification du moyen de paiement effectuée, vous sollicitez WL Sips une seconde fois pour enregistrer le moyen de paiement dans le wallet.
  3. WL Sips vous retourne la réponse de l’enregistrement du moyen de paiement.

La séquence décrite ci-dessus se transpose sur Amex et SDD .

Paramétrer les requêtes de vérification du moyen de paiement

Vous utilisez les méthodes ci-dessous en fonction du niveau de vérification du moyen de paiement à enrôler.

Carte CB, Visa, Mastercard, Oney, AMEX

Méthodes du service CheckOut Type de vérification

cardCheckEnrollment

cardValidateAuthentication

Authentification 3-D Secure seule
CardOrder Demande d’autorisation avec contrôles anti-fraude

cardCheckEnrollment

cardValidateAuthenticationAndOrder

Authentification 3DS et demande d’autorisation avec contrôles anti-fraude

Mandat SDD

Méthodes du service CheckOut Type de vérification
directDebitOrder Demande d’autorisation SDD avec contrôle anti-fraude

Veuillez consulter le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) ainsi que les guides des moyens de paiement pour connaître les détails d'implémentation.

Analyser la réponse d’authentification

Méthode cardValidateAuthentication

Etat Champs de la réponse Action à réaliser
Porteur authentifié holderAuthentResponseCode = 00 Vous pouvez enregistrer la carte dans le wallet via la méthode addcard .
Échec d’authentification du porteur holderAuthentResponseCode=01 Indiquez au client que son numéro de carte est invalide et demandez-lui d’enrôler un autre moyen de paiement
Autres refus holderAuthentResponseCode=XX

Si l’authentification 3DS est une obligation pour votre business pour enrôler une carte, demandez au client d’enrôler un autre moyen de paiement.

Si l’authentification 3DS n’est pas une obligation pour votre business pour enrôler une carte, vous pouvez poursuivre la vérification de la carte avec une requête cardOrder.

Analyser la réponse d’autorisation avec contrôles fraude

Méthodes CardOrder, cardValidateAuthenticationAndOrder et directDebitOrder

Etat Champs de la réponse Action à réaliser
Transaction acceptée

responseCode = 00

acquirerResponseCode = 00

Vous pouvez enregistrer la carte dans le wallet via la méthode addcard ou addDirectDebit.
Transaction refusée responseCode = XX Indiquez au client que son numéro de carte est invalide et demandez-lui d’enrôler un autre moyen de paiement.

Paramétrer la requête d’enrôlement des coordonnées de paiement de l'abonné

Vous utilisez les méthodes ci-dessous en fonction du moyen de paiement à enrôler. Le champ merchantWalletId contient l’identifiant du client.

Carte CB, Visa, Mastercard, Oney, Amex

Méthodes du service wallet Type d’action
addcard Ajout d’une carte dans le wallet

Mandat SDD

Méthodes du service wallet Type d’action
addDirectDebit Ajout d’un mandat dans le wallet

Veuillez consulter le guide Sips Office adéquat ainsi que les guides des moyens de paiement pour savoir comment renseigner la requête en fonction de votre besoin métier.

Analyser la réponse d’enrôlement

Etat Champs de la réponse Action à réaliser
Abonné enrôlé

walletReponseCode = 00

paymentMeanId = 1

Vous pouvez débiter ou créditer votre abonné.

Abonné non enrôlé

Requête invalide

walletReponseCode = xx

paymentMeanId = non renseigné

Consultez le guide connecteur Sips Office pour analyser la réponse de WL Sips .

Enrôler l’abonné avec Sips Office Batch

L’interface Sips Office Batch propose la même cinématique d’enrôlement que Sips Office JSON/SOAP avec une différence majeure :

Note: l’authentification 3-D Secure du porteur lors de l’étape de vérification du moyen de paiement n’est pas disponible avec Sips Office Batch .

Pour le reste ce qui est décrit dans le paragraphe 3.1.2 s’applique aussi à Sips Office Batch .

Débiter l’abonné avec Sips Office Batch via la méthode walletOrder

Une fois l’abonné enregistré, vous pouvez le débiter en mode hors ligne avec Sips Office Batch .

Description

Vous formatez un fichier Sips Office Batch en utilisant la méthode walletorder .

Chaque enregistrement walletOrder contient :

  • L’identifiant de l’abonné à débiter (champ merchantWalletid ),
  • Les données des transactions (montant, référence commande,…).
  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é stockées dans le wallet.
  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 abonné avec la méthode walletOrder , vous renseignez les champs ci-dessous :

Champ Valeur Commentaire
merchantWalletID ˂id abonné˃
paymentMeanId 1 L’identifiant du moyen de paiement dans le wallet est obligatoire bien que le wallet ne contienne qu'un seul moyen de paiement.
paymentPattern RECURRING_N Paiement récurrent pour indiquer à l’acquéreur qu'il n’y a pas de données 3-D Secure et le CVV.
cardCSCValue Non renseigné Paiement récurrent pour indiquer à l’acquéreur qu'il n’y a pas de données 3-D Secure et le CVV.

captureMode

captureDay

Non renseigné Remise en paiement le soir même.

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 .

Débiter l’abonné avec Sips Office

Le connecteur Sips Office JSON/SOAP propose aussi la méthode walletOrder 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.

Créditer l’abonné avec Sips Office Batch

Vous pouvez créditer un abonné à partir de son identifiant sans faire référence à une transaction initiale de débit.

Note: seules les cartes CB, Visa et Mastercard supportent cette fonctionnalité.

Description

La solution Sips Office Batch permet de réaliser des paiements par lot.

Vous formatez un fichier Sips Office Batch en utilisant la méthode walletCredit .

Chaque enregistrement walleCredit contient :

  • L’identifiant de l’abonné à débiter (champ merchantWalletId ),
  • Les données des transactions (montant, référence commande,…).
  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é stockées dans le wallet.
  3. WL Sips envoie les demandes d’autorisation aux acquéreurs.
  4. WL Sips stocke la transaction dans le back office.
  5. WL Sips formate le fichier réponse et vous le renvoie.
  6. Le soir, WL Sips envoie les remises de paiement des transactions acceptées.

Veuillez consulter les guides Sips Office Batch XML ou 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 abonné avec la méthode walletCredit , vous renseignez les champs ci-dessous :

Champ Valeur Commentaire
merchantWalletID ˂id abonné˃
paymentMeanId 1 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 = CREDITED)
Transaction refusée responseCode = XX Consultez le guide connecteur Sips Office Batch pour analyser la réponse de WL Sips .

Créditer l’abonné avec Sips Office

Le connecteur Sips Office JSON/SOAP propose aussi la possibilité de créditer un abonné via la méthode walletCreditHolder en mode message.

Les règles pour le formatage de la requête et l’analyse de la réponse sont les mêmes que celles de Sips Office Batch .

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

Gérer les moyens de paiement et le compte d’un abonné

Avec Sips Walletpage

Description

L’interface Sips Walletpage permet à l’abonné de gérer de manière autonome son wallet. Les fonctionnalités suivantes sont disponibles :

  • consultation du contenu d’un compte abonné,
  • ajout d’un moyen de paiement à un compte abonné vierge,
  • édition d’un moyen de paiement d’un compte abonné,
  • suppression d’un moyen de paiement d’un compte abonné,
  • mise à jour d’un moyen de paiement d’un compte abonné,
  • suppression d’un compte abonné.

Paramétrer la requête

Par défaut, l’ensemble des fonctionnalités de gestion est disponible pour l’utilisateur. Toutefois, il est possible de réduire le périmètre de ces fonctionnalités, en indiquant la liste de fonctionnalités souhaitée dans le champ walletActionNameList .

Pour la gestion de wallet, vous devez renseigner les champs ci-dessous :

Champ Valorisation
merchantWalletId Identifiant de l'abonné
walletActionList Liste des fonctionnalités proposées sur Sips Walletpage . Si non renseigné, toutes les fonctionnalités sont disponibles.

Veuillez consulter le guide Sips Walletpage correspondant au connecteur choisi (JSON, POST ou SOAP) pour savoir comment renseigner la requête en fonction de votre besoin métier.

Analyser la réponse

Etat Champs de la réponse Actions à réaliser
abonné supprimé walletPaymentMeanDataList non renseigné
abonné non supprimé walletPaymentMeanDataList renseigné

Vous pouvez mettre à jour votre système d’information avec le nouveau contenu du wallet.

Avec Sips Office et Sips Office Batch

Vue d'ensemble

Le service « Wallet » de l’interface Sips Office vous permet de gérer le contenu des wallets de vos clients. Les fonctionnalités suivantes sont disponibles :

  • Obtention du contenu complet d’un compte abonné,
  • Obtention du détail d’un moyen de paiement contenu dans un compte abonné,
  • Création d’un nouveau compte abonné,
  • Suppression d’un compte abonné,
  • Suppression d’un moyen de paiement d’un compte abonné.

En utilisant les interfaces Sips Office ou Sips Office Batch , vous devez gérer les pages de gestion du wallet pour permettre à vos abonnés de gérer leur compte.

Consulter le contenu d’un compte OneClick avec Sips Office

Sips Office vous permet de consulter les coordonnées d’un client via la requête getWalletData .

  • Paramétrer la requête
    Pour consulter le contenu d’un wallet avec la méthode getWalletData , vous devez renseigner les champs ci-dessous :
    Champ Valorisation
    merchantWalletID Identifiant du client

    Veuillez consulter le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) 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 Action à réaliser
    abonné trouvé dans la base wallet

    walletReponseCode = 00

    walletPaymentMeanDataList renseigné avec les moyens de paiement enregistrés dans le wallet
    L'abonné existe dans le wallet.
    Analysez le champ walletPaymentMeanDataList pour accéder aux données du moyen de paiement du client.
    • paymentMeanBrand
    • paymentMeanId
    • maskedPAN
    • PANExpiryDate
    abonné non trouvé dans la base wallet

    walletReponseCode = 25

    Le compte a été supprimé ou n’a pas été créé.
    Autre refus

    walletReponseCode = xx

    Consultez le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) pour analyser la réponse de WL Sips .

Modifier un moyen de paiement d’un compte OneClick avec Sips Office

Sips Office vous permet de modifier l’alias d’un moyen de paiement d’un abonné via la requête updatePaymentMean .

  • Paramétrer la requête
    Pour modifier un moyen de paiement avec la méthode updatePaymentMean , vous devez renseigner les champs ci-dessous :
    Champ Valorisation
    merchantWalletID Identifiant du client
    paymentMeanId Numéro de séquence du moyen de paiement
    paymentMeanAlias Nouvel alias du moyen de paiement

Veuillez consulter le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) 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 Action à réaliser
Alias modifié

walletReponseCode = 00

walletActionDateTime renseigné

Client non trouvé dans base wallet

walletReponseCode = 25

Le compte abonné n’existe pas.
Autre refus

walletReponseCode = xx

Consultez le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) pour analyser la réponse de WL Sips .

Supprimer un moyen de paiement d’un compte OneClick avec Sips Office

Sips Office vous permet de supprimer un moyen de paiement d’un client via la requête deletePaymentMean .

  • Paramétrer la requête

Pour modifier un moyen de paiement avec la méthode deletePaymentMean , vous devez renseigner les champs ci-dessous :

Champ Valorisation
merchantWalletID Identifiant de l'abonné
paymentMeanId Numéro de séquence du moyen de paiement

Veuillez consulter le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) 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 Action à réaliser
Moyen de paiement supprimé

walletReponseCode = 00

walletActionDateTime renseigné

Client / moyen de paiement non trouvé dans base wallet

walletReponseCode = 25

Autre refus

walletReponseCode = xx

Consultez le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) pour analyser la réponse de WL Sips .

Supprimer un client avec Sips Office

Sips Office vous permet de supprimer un abonné via la requête signOff .

  • Paramétrer la requête

Pour supprimer un wallet avec la méthode signOff , vous devez renseigner les champs ci-dessous :

Champ Valorisation
merchantWalletID Identifiant du client

Veuillez consulter le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) 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 Action à réaliser
abonné supprimé walletReponseCode = 00 Vous pouvez mettre à jour votre système d’information
abonné non supprimé walletReponseCode = xx Consultez le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) pour analyser la réponse de WL Sips .

Avec Sips Office Extranet

Via Sips Office Extranet , vous avez la possibilité de supprimer un moyen de paiement pour le compte de votre abonné . Cette fonctionnalité est protégée par un droit d’accès qui vous est attribué lors de votre inscription. Si vous avez besoin de cette fonctionnalité, mais que vous n’avez pas le droit d’accès, veuillez contacter l’assistance technique.

Changer le moyen de paiement d’un abonné

Si l’abonné souhaite changer de moyen de paiement (carte perdue, validité expirée, …), vous devez créer un nouveau wallet avec un nouvel identifiant abonné pour enregistrer les nouvelles coordonnées de paiement.  

Traiter l’expiration des moyens de paiement des abonnés

Vous recevez mensuellement par mail ou fichier SFTP le journal des cartes échues . Ce journal référence les clients dont le moyen de paiement va expirer dans un délai 3 mois.

A partir du journal des cartes échues , vous pouvez alerter vos clients pour qu'ils renouvellent leur moyen de paiement enregistré dans le wallet.

A noter que vous n’avez pas besoin de ce fichier pour connaître la date d’expiration du moyen de paiement des clients. En effet, lors de l’enrôlement de l'abonné , vous recevez en réponse des informations que vous pouvez stocker dans votre système d’information :

  • Identifiant du moyen de paiement dans le wallet (champ paymentMeanId )
  • Marque du moyen de paiement (champ paymentMeanBrand )
  • Date d'expiration (champ panExpiryDate )
  • PAN masqué (champ maskedPAN )

Pour avoir le contenu détaillé du journal des cartes échues , veuillez consulter le document Description des journaux.

Démarrer l’abonnement en 5 étapes

Etape 1 - Souscrire au service

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 (en demandant le service abonnement) 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 demander à Worldline d’activer le service abonnement.

Données de configuration du service abonnement.

  • Interfaces utilisées pour l’enrôlement
    • Sips Paypage
    • Sips Walletpage
    • Office Server
    • Sips Office Batch
  • Interfaces utilisées pour débiter ou créditer vos abonnés
    • Office server
    • Sips Office Batch
  • Dans le cas d’une base abonnés partagée entre plusieurs boutiques d’une même enseigne, indiquer l’identifiant de l’enseigne.
Note: si votre base abonnée est partagée entre plusieurs boutiques, vous devez l’indiquer dans le formulaire d’inscription ou le dire à l’assistance technique.

Si ce n’est pas précisé, WL Sips définit une base wallet dédiée à votre boutique.

Etape 2 - Mettre en œuvre le service

Lorsque vous avez choisi les interfaces WL Sips qui répondent à votre besoin (cf. chap. 3), vous devez intégrer les connecteurs WL Sips pour connecter votre site à WL Sips .

Le chapitre précédent a décrit comment utiliser WL Sips dans le cadre de l’abonnement en fonction des différents connecteurs :

  • Nom des méthodes,
  • Valorisation et analyse des champs métier de l’abonnement.

Vous devez consulter les guides des connecteurs choisis pour paramétrer les requêtes de paiement en fonction de vos besoins ( customerID , orderId , returnContext ,….).

Etape 3 - Tester le service sur l’environnement recette

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

Contactez l’assistance technique pour vous configurer un transfert de fichier si vous utilisez Sips Office Batch .

Données de test
merchantId 201000076660001
clé secrète 8yTiAEzvhl7xt3_oEbdaH9Y9NY9A4XpNEjkk6q6Dou4
version de la clé 1
carte de test cf page " Cartes de test "

Serveur URL de test
WalletPage POST https://payment-webinit.test.sips-atos.com/walletManagementInit
WalletPage JSON
WalletPage SOAP https://payment-webinit.test.sips-atos.com/services/v2/walletManagementInit
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 4 - Valider le service en production

Vous êtes à présent en mesure de valider la connexion à WL Sips de production.

Au préalable, nous conseillons d’isoler votre site Web du public pour éviter que des clients effectuent des transactions pendant cette phase de validation.

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 ou vos pages de gestion du wallet, veuillez suivre la procédure décrite dans le document Custompages .

Comment valider l’enrôlement

Immédiatement

  • Soumettez une requête d’enrôlement selon le scénario d’enrôlement que vous avez choisi.
  • Consultez le contenu du wallet via la méthode getWalletData du connecteur Sips Office .
  • Soumettez une seconde fois la requête avec le même identifiant abonné, vous devez avoir un refus d’enrôlement car le wallet est mono moyen de paiement.

Comment valider le débit abonné

Immédiatement

  • Soumettez une requête walletOrder pour déclencher un débit abonné.
  • Consultez la transaction via Sips Office Extranet BackOffice à partir du transactionReference ou du S10transactionId .

Le lendemain

  • Vérifiez la présence de la transaction dans le journal des transactions.
  • Vérifiez sur votre compte commerçant que l’opération a bien été créditée.
  • Remboursez la transaction via Sips Office Extranet BackOffice (optionnel).

Le sur lendemain

  • Vérifiez que l’opération de remboursement apparaît dans le journal des opérations.
  • Vérifiez sur votre compte commerçant le débit suite au remboursement.

Comment valider le crédit abonné

Immédiatement

  • Soumettez une requête walletCredit ou WalletCreditHolder pour déclencher un crédit abonné.
  • Consultez la transaction via Sips Office Extranet BackOffice à partir du transactionReference ou du S10transactionId .

Le lendemain

  • Vérifiez la présence de la transaction dans le journal des transactions.
  • Vérifiez sur votre compte que l’opération a bien été débitée.

Etape 5 - Démarrer le service en production

Une fois la validation du passage en production effectuée, ouvrez votre site au public pour permettre à vos abonnés d'utiliser le service OneClick et de s’enregistrer.

L’enrôlement des abonnés

Dans la journée

  • Surveillez le taux d’acceptation (nombre de responseCode 00 par rapport au nombre total de transactions),
  • Vérifiez la nature des refus non bancaires,
    • Problème technique : responseCode 90, 97, 99,
    • Fraude : responseCode 34, 3D Failure,
    • Nombre max de tentatives de paiement atteint : responseCode 75.

Le lendemain

  • Vérifiez dans le journal des transactions la présence de toutes les transactions traitées (acceptées et refusées),
  • Vérifiez, dans le journal des opérations, la présence des opérations que vous avez effectuées ainsi que les remises (si vous avez choisi cette option du journal).

Le débit des abonnés

Lorsque vous soumettez vos premiers débits abonnés via Sips Office Batch ou Sips Office :
  • Surveillez le taux d’acceptation (nombre de responseCode 00/nombre total de transactions).
  • Vérifiez la nature des refus non bancaires
    • Problème technique : responseCode 90, 97, 99,
    • Fraude acquéreur : responseCode 34.