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étier 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 l'intégration du moyen de paiement Paylib dans WL Sips.
À qui s’adresse ce document ?
Ce document a pour objectif de vous aider à implémenter le moyen de paiement Paylib sur votre site de commerce électronique.
Il comprend :
- des informations fonctionnelles à votre attention ;
- des instructions d'implémentation à destination de votre équipe technique.
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
Comprendre les paiements Paylib avec WL Sips
Principes généraux
Paylib est un wallet porté par des banques françaises permettant d’effectuer des paiements par carte sécurisés et garantis.
Pour pouvoir utiliser Paylib, un client doit préalablement s'inscrire au wallet via sa banque en ligne.
Sur la cinématique de paiement Web, le client est redirigé vers le site Web de Paylib afin de s’authentifier et de choisir sa carte de paiement.
Règles d’acceptation
Fonctionnalités disponibles
Canaux de paiement | ||
---|---|---|
Internet | V | Canal de paiement par défaut |
MOTO | X | |
Télécopie | X | |
SVI | X | |
INAPP | V | Canal de paiement obligatoire pour le paiement par application mobile (disponible uniquement sur Sips Office). |
Typologies de paiement | ||
---|---|---|
Paiement immédiat | X | |
Paiement en fin de journée | V | Méthode par défaut |
Paiement différé | V | Limité par défaut à 6 jours pour bénéficier de la garantie de paiement Paylib. Vous devez souscrire à une
option spécifique pour disposer des paiements à plus de 6 jours
Paylib, cependant, il n'y aura pas de garantie de
paiement. |
Paiement à l'expédition | V | Limité par défaut à 6 jours pour bénéficier de la garantie de paiement Paylib. Vous devez souscrire à une
option spécifique pour disposer des paiements à plus de 6 jours
Paylib, cependant, il n'y aura pas de garantie de
paiement. |
Paiement en plusieurs fois | X | |
Paiement par abonnement | X | |
Paiement par fichier | X | |
Paiement OneClick | V |
Gestion des devises | ||
---|---|---|
Acceptation multidevise | X | Euro uniquement |
Règlement en devise | X | Euro uniquement |
Demande d'autorisation
La garantie de paiement Paylib est liée au résultat de la demande d’autorisation effectuée sur la carte choisie par le client.
De ce fait, le délai maximum autorisé pour un paiement Paylib est de 6 jours (sauf cas particulier de l’option « paiement Paylib à plus de 6 jours » décrit plus bas).
Si vous renseignez un délai de capture supérieur, il sera automatiquement forcé par la plateforme de paiement.
Remise en banque des paiements
Les paiements sont remis en banque conformément aux modalités de paiement que vous avez définies. En standard, la remise en banque est déclenchée la nuit à partir de 22h00, fuseau horaire CET (heure d’Europe Centrale), via un échange de fichier avec l’acquéreur.
Cas particulier : les paiements à plus de 6 jours
Par défaut, le moyen de paiement Paylib limite le délai de capture des transactions à 6 jours maximum afin de garantir le paiement.
Il est cependant possible de créer des transactions Paylib avec un délai de capture supérieur à 6 jours.
Pour cela, vous devrez souscrire à une option « paiement Paylib à plus de 6 jours ».
Si vous avez souscrit à l’option « paiement Paylib à plus de 6 jours », vous serez dans la capacité de créer des transactions dont le délai de capture pourra aller jusqu'à 20 jours.
Si vous indiquez un délai supérieur, il sera automatiquement forcé par la plateforme.
Lors d’un paiement Paylib à plus de 6 jours, la demande d’autorisation auprès de l’acquéreur ne sera pas effectuée en ligne. La plateforme de paiement effectuera un contrôle du numéro de carte auprès de la liste des cartes en opposition afin de vérifier que celle-ci n’a pas été déclarée comme perdue ou volée.
La demande d’autorisation sera effectuée :
- soit lors de la validation du paiement si la transaction a été effectuée en mode « Validation » ;
- soit avant l’envoi en remise si la transaction a été effectuée en mode « Annulation ».
La garantie de paiement étant portée par la demande d’autorisation, il est important de noter que, même si la transaction est indiquée comme acceptée lors de sa création, elle ne sera garantie que lorsque cette demande d’autorisation sera acceptée.
Il est donc conseillé, dans ce mode de fonctionnement, de n’envoyer le colis au client qu'une fois le résultat de cette demande d’autorisation connu.
Contrôles de lutte contre la fraude
Si vous avez un profil fraude appliqué aux cartes CB/VISA/MASTERCARD, il est aussi appliqué aux paiements effectués via Paylib.
Ouvrir votre contrat d'acceptation Paylib
Afin de proposer le paiement Paylib, vous devez détenir un contrat VAD souscrit auprès de votre banque française et contractualiser avec votre revendeur Paylib (généralement votre banque). Pour activer Paylib sur WL Sips, vous devez nous indiquer le nom de votre revendeur Paylib, et nous préciser si l’activation de l’option « paiement Paylib à plus de 6 jours » est autorisée par votre revendeur.
Activer le paiement Paylib OneClick (optionnel)
Si vous le souhaitez, WL Sips vous permet d’accepter des paiements OneClick avec Paylib.
Il faut avoir souscrit au service WL Sips OneClick (contacter l’assistance technique).
Il sera ensuite nécessaire de transmettre un identifiant de wallet (champ merchantWalletId) unique par client lors de vos demandes de paiement.
Effectuer un paiement Paylib
WL Sips vous offre deux solutions pour intégrer le moyen de paiement Paylib :
- Sips Paypage qui assure l’interface de paiement directement avec le client via son navigateur Web.
- Sips Office qui vous laisse la possibilité d’afficher vous-même vos pages de paiement et qui fonctionne par un dialogue de serveur à serveur.
Les modes de remise disponibles pour une transaction Paylib sont les suivants :
- Mode annulation : mode par défaut, il permet de remiser la transaction à une date prédéfinie, appelée délai de capture. Lorsque ce délai de capture est atteint, la remise est automatiquement envoyée. Ce délai est paramétré via le champ captureDay, sa valeur par défaut est 0 (paiement en fin de journée).
- Mode validation : vous devez valider la transaction pour déclencher la remise. Un délai de capture doit aussi être défini. Lorsque ce délai de capture est atteint ou dépassé, vous ne pourrez plus valider la transaction, celle-ci expirera donc automatiquement.
Le diagramme ci-dessous explique les différents états par lesquels peuvent passer les transactions selon le mode de capture choisi :

Effectuer un paiement Paylib avec Sips Paypage
La cinématique de paiement pour Sips Paypage est décrite ci-dessous :

Paramétrer la requête de paiement
Le champ suivant a un comportement particulier :
Nom du champ | Remarques / règles |
---|---|
captureDay | Si vous bénéficiez de l’option « paiement Paylib à
plus de 6 jours », le délai de capture sera forcé à 20 jours si un
délai supérieur est indiqué dans la requête. Si vous ne
bénéficiez pas de cette option, le délai de capture sera forcé à 6
jours si un délai supérieur est indiqué dans la
requête. |
Analyser la réponse
Afin de bénéficier de Paylib, il est nécessaire de passer à la version 2.6 (ou supérieure) des réponses automatique et manuelle.
Le tableau suivant récapitule les différents cas de réponse à traiter :
État | Champs de la réponse | Action à réaliser |
---|---|---|
Paiement accepté | acquirerResponseCode = 00
authorisationId = (voir le
Dictionnaire des données).paymentMeanBrand = carte
utilisée dans le wallet (VISA, MASTERCARD, CB ou
autre)paymentMeanType =
CARDresponseCode =
00 |
Vous pouvez livrer la commande. |
Refus acquéreur | acquirerResponseCode = (voir
le Dictionnaire des données).responseCode =
05 |
L’autorisation est refusée pour un motif non lié à la
fraude. Si vous n’avez pas opté pour l’option « nouvelle
tentative de paiement » (pour plus de détails veuillez consulter
le Guide de configuration des
fonctionnalités), vous pouvez proposer à votre
client de payer avec un autre moyen de paiement en générant une
nouvelle requête. |
Refus nombre max essais atteint | responseCode = 75 |
Le client a fait plusieurs tentatives qui ont toutes échoué. |
Refus suite problème technique | acquirerResponseCode = 90-98
responseCode = 90, 99
|
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement. |
Pour connaître l'intégralité des codes réponses (responseCode
) et codes réponses
acquéreur (acquirerResponseCode
), veuillez vous
référer au Dictionnaire des
données.
Paiement OneClick
Vous avez la possibilité d’accepter des paiements OneClick avec Paylib sur Sips Paypage. Vous devez avoir souscrit au service OneClick de WL Sips (cf. paragraphe Activer le paiement OneClick).
Vous devez ensuite transmettre le champ merchantWalletId associé à votre client dans chaque requête de paiement.
La page suivante est alors affichée lors de l’enrôlement d’un compte Paylib dans le wallet WL Sips :
Si un compte Paylib a déjà été ajouté dans le wallet WL Sips alors la page de sélection suivante sera affichée :
Deux pages distinctes doivent être affichées en fonction de la méthode d’authentification de votre client :
- une page d’authentification par OTP, intégrant un champ de saisie de code à usage unique
- une page d’authentification sur Smartphone sans champ de saisie
Effectuer un paiement Paylib avec Sips Office
Le processus de paiement pour Sips Office est décrit ci-dessous :

Initialiser un paiement (PaymentProviderInitialize)
L’initialisation d’un paiement Paylib est effectuée en appelant la méthode PaymentProviderInitialize.
Requête d’initialisation du paiement
Vous devez valoriser les champs spécifiques suivants dans la requête dinitialisation pour un paiement Paylib:
Nom du champ | Remarques / règles |
---|---|
paymentMeanBrand | Portefeuille utilisé pour le paiement. |
captureDay | Si vous bénéficiez de l’option « paiement Paylib à
plus de 6 jours », le délai de capture sera forcé à 20 jours si un
délai supérieur est indiqué dans la requête. Si vous ne
bénéficiez pas de cette option, le délai de capture sera forcé à 6
jours si un délai supérieur est indiqué dans la
requête. |
orderChannel | Si vous souhaitez faire un paiement In-App, le mot-clef à envoyer est « INAPP ». La valeur par défaut est « INTERNET » et déclenchera un paiement Web. |
Réponse d’initialisation du paiement
Le tableau suivant récapitule les différents cas de réponse à traiter :
État | Champs de la réponse | Action à réaliser |
---|---|---|
Initialisation paiement acceptée | acquirerResponseCode =
00authorisationId = (voir le
Dictionnaire des données).messageVersion = version du
message récupérée en réponse à l’initialisation du
paiement.paymentMeanBrand =
PAYLIBpaymentProviderSessionId =
Token Paylib. Ce champ n’est retourné que dans une cinématique de
paiement In-App. Ce Token est nécessaire pour les échanges entre
l’application mobile et le site Web Paylib.responseCode =
00redirectionData = données de
redirection récupérées en réponse à l’initialisation du
paiement.redirectionUrl = URL
intent |
Redirigez le client vers redirectionUrl . |
Initialisation de paiement rejetée | responseCode <>
00 |
Consultez le champ errorFieldName , puis corrigez
la requête.En cas d’erreur persistante, contactez
l'assistance technique. |
Refus acquéreur | acquirerResponseCode = (voir
le Dictionnaire des données).responseCode =
05 |
L’autorisation est refusée pour un motif non lié à la fraude, vous pouvez proposer à votre client de payer avec un autre moyen de paiement en générant une nouvelle requête. |
Refus suite problème technique | acquirerResponseCode = 90-98
responseCode = 90, 99
|
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement. |
Pour connaître l'intégralité des codes réponses (responseCode
) et codes réponses
acquéreur (acquirerResponseCode
), veuillez vous
référer au Dictionnaire des
données.
Rediriger le client vers le site Web Paylib
Le client doit être redirigé vers l’URL redirectionUrl fournie en réponse de la méthode paymentProviderInitialize. Cette redirection consiste à effectuer un appel POST sur l’URL redirectionUrl obtenue dans la réponse à l’initialisation de paiement. Les paramètres POST à transmettre sont redirectionData et messageVersion obtenus également dans la réponse à l’initialisation de paiement.
A la fin de la cinématique de paiement, le client est redirigé vers l’URL fournie dans la requête d’initialisation, merchantReturnUrl. Les champs suivants sont transmis en POST et doivent être récupérés pour finaliser le paiement :
Nom du champ | Remarques / règles |
---|---|
responseCode | Code réponse du processus |
redirectionData | Données de redirection récupérées en réponse à l’initialisation du paiement. |
messageVersion | Version du message récupérée en réponse à l’initialisation du paiement. |
amount | Montant de la transaction en centimes |
merchantId | Identifiant de la boutique |
transactionReference | Référence de la transaction |
transactionId | Identifiant de la transaction |
transactionDate | Date de la transaction |
Finaliser un paiement (PaymentProviderFinalize)
Cette dernière étape vous permet d’obtenir le statut du paiement. Les paramètres obtenus lors de la redirection après la cinématique de paiement sur le site Web Paylib sont à transmettre lors de cet appel. La méthode utilisée pour finaliser un paiement est paymentProviderFinalize.
Requête de finalisation du paiement
Vous devez valoriser les champs spécifiques suivants dans la requête de finalisation pour un paiement Paylib.
Nom du champ | Remarques / règles |
---|---|
redirectionData | Données de redirection récupérées au retour du client vers votre site Web (voir Rediriger le client vers le site Web Paylib). |
messageVersion | Version du message récupérée au retour du client vers votre site Web (voir Rediriger le client vers le site Web Paylib). |
Réponse de finalisation du paiement
Le tableau suivant récapitule les différents cas de réponse à traiter :
État | Champs de la réponse | Action à réaliser |
---|---|---|
Paiement accepté | acquirerResponseCode =
00authorisationId = (voir le
Dictionnaire des données).paymentMeanBrand =
PAYLIBresponseCode =
00transactionStatus = (voir le
Dictionnaire des données). |
Vous pouvez livrer la commande. |
Refus acquéreur | acquirerResponseCode = (voir
le Dictionnaire des données).responseCode =
05 |
L’autorisation est refusée pour un motif non lié à la fraude, vous pouvez proposer à votre client de payer avec un autre moyen de paiement en générant une nouvelle requête. |
Refus Soft Decline | acquirerResponseCode = A1
responseCode =
05 |
L’acquéreur a refusé le paiement car il n’y a pas eu
d'authentification 3-D Secure. Veuillez retenter le paiement
en activant l'authentification 3-D Secure. |
Refus suite problème technique | acquirerResponseCode = 90-98
responseCode = 90, 99
|
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement. |
Pour connaître l'intégralité des codes réponses (responseCode
) et codes réponses
acquéreur (acquirerResponseCode
), veuillez vous
référer au Dictionnaire des
données.
Gérer vos transactions Paylib
Opérations de caisse disponibles
Les opérations suivantes sont disponibles sur les transactions Paylib :
Gestion de caisse | ||
---|---|---|
Annulation | V | |
Validation | V | |
Remboursement | V | |
Duplication | V | La transaction résultant d’une duplication n’est pas une transaction Paylib mais une transaction carte classique, sans garantie de paiement. |
Recyclage | X | |
Crédit | X |
Le diagramme ci-dessous vous permet de savoir quelle opération de gestion de caisse est disponible lorsqu'une transaction est dans un état donné :

Consulter vos transactions Paylib
Journaux
Les journaux mis à disposition par WL Sips vous permettent d’avoir une vision exhaustive et consolidée de vos transactions, opérations de caisse, situation comptable et impayés. Vous pouvez utiliser ces informations pour enrichir votre système d’information.
La disponibilité des transactions Paylib pour chaque type de journal est récapitulée dans le tableau ci-dessous :
Disponibilité des journaux | |
---|---|
Journal des transactions | V |
Journal des opérations | V |
Journal de rapprochement des transactions | V |
Journal de rapprochement des impayés | X |
Sips Office Extranet
Vous pouvez consulter vos transactions Paylib et effectuer différentes opérations de gestion de caisse grâce à Sips Office Extranet.
D’un point de vue back office, les transactions Paylib sont assimilées à des transactions cartes CB, VISA ou MASTERCARD. Vous pouvez distinguer les paiements effectués via Paylib par :
- le mode de saisie des données de paiement, positionné à « WALLET » ;
- le portefeuille électronique, positionné à « PAYLIB ».