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 définies par vous-même. 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)
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 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

Aucune donnée spécifique n’est nécessaire pour soumettre une requête d’initialisation de paiement Paylib. Toutefois, les règles suivantes sont appliquées pour 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

Les champs suivants sont retournés dans le cas d’un paiement Paylib :

Nom du champ Remarques / règles
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 Paylib.

responseCode Code réponse
redirectionData Données de redirection récupérées en réponse à l’initialisation du paiement.
redirectionUrl URL de redirection vers le site Paylib
messageVersion Version du message récupérée en réponse à l’initialisation du paiement.

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

Les champs suivants sont retournés pour un paiement Paylib :

Nom du champ Remarques / règles
paymentMeanBrand La valeur de ce champ est toujours PAYLIB.
responseCode Code réponse du serveur WL Sips .
transactionStatus État de la transaction

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

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

Voici le détail d'une transaction effectuée avec une carte enrôlée dans un wallet Paylib :