WL SIPS DOCS

Release 22.4

aller directement au contenu

Rechercher par mots clés

Intégration Paylib

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

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.

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

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.

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

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.

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.

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.

Si vous avez un profil fraude appliqué aux cartes CB/VISA/MASTERCARD, il est aussi appliqué aux paiements effectués via 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.

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.

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 :


status possibles pour une transaction Paylib

En mode validation, quatre status sont possibles. Si la transaction est abandonnée, le status devient ABORTED (responseCode 17). Si la transaction est rejetée, le status devient REFUSED (responseCode différent de 00). Lorsque la transaction est acceptée (responseCode 00), si le captureDay est inférieur ou égal à 6, la transaction doit être validée et le status devient TO_VALIDATE. Si le captureDay est supérieur à 6, le status de la transaction devient TO_REPLAY. En mode annulation, les status ABORTED et REFUSED existe également. En revanche, lorsque la transaction est acceptée, si le captureDay est inférieur ou égal à 6, le status devient TO_CAPTURE. Si le captureDay est supérieur à 6, le status devient TO_AUTHORIZE.

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


étapes d'un paiement Paylib via paypage

1) Le client procède au paiement. 2) Il est redirigé sur les pages de paiement hébergées par WL Sips et choisit de payer avec Paylib. 3) Il est redirigé sur les pages Paylib où il s'identifie et paie. 4) Il est redirigé vers les pages WL Sips. 5) Si le client a cliqué sur le bouton "retour à la boutique", WL Sips envoie la réponse manuelle. 6) WL Sips envoie la réponse automatique.

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.

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)
Vous pouvez livrer la commande.
Refus acquéreur acquirerResponseCode = (voir le Dictionnaire des données). 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.

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


Le processus de paiement pour Sips Office est décrit ci-dessous :


étapes d'un paiement paylib avec office

1) Le client procède paiement. 2) Vous initialisez le paiement en envoyant une requête paymentProviderInitialize à WL Sips qui vous retourne la redirectionUrl pour la suite du paiement. 3) Grâce à la redirectionUrl, vous redirigez votre client vers la page Paylib où s'identifie et paie. 4) Le client revient sur votre site. 5) Vous finalisez le paiement en envoyant une requête paymentProviderFinalize à WL Sips qui vous retourne le résultat du paiement. 6) Vous affichez le résultat du paiement à votre client sur votre site.

L’initialisation d’un paiement Paylib est effectuée en appelant la méthode PaymentProviderInitialize.

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.

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 = 00
authorisationId = (voir le Dictionnaire des données).
messageVersion = version du message récupérée en réponse à l’initialisation du paiement.
paymentProviderSessionId = 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.
redirectionData = 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 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). 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.

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

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.

Tip: vous pouvez, en réponse à votre requête paymentProviderFinalize, obtenir un code 24 « Opération impossible ». Ce code signifie que cette requête a déjà été envoyée et traitée pour la transaction concernée. Si vous ne pouvez identifier ce traitement, nous vous invitons à utiliser la fonction GetTransactionData du service diagnostic : cette opération permet de récupérer des informations relatives à une transaction créée préalablement à l'aide de WL Sips.

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).

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).
transactionStatus = (voir le Dictionnaire des données).
Vous pouvez livrer la commande.
Refus acquéreur acquirerResponseCode = (voir le Dictionnaire des données). 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 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.

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é :


Schéma trop complexe à décrire. Merci de contacter le support sips@worldline.com

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
Note: pour les transactions Paylib, le champ paymentMeanBrand est renseigné avec la valeur PAYLIB.

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 ».


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 WL Sips.
En fermant ce bandeau vous refusez notre utilisation des traceurs sur votre appareil.

Paramètres