Paylib

De Documentation Mercanet
Aller à : navigation, rechercher

Introduction

Objectif du présent document

Le présent document a pour objectif d’accompagner les commerçants dans l’implémentation de l’option de paiement Paylib sur Mercanet.

Info.png A noter

Tous les termes, acronymes, expressions spécifiques à la Mercanet et son contexte sont définies dans le document : GLOSSAIRE N’hésitez pas à vous y référer chaque fois que nécessaire.

Fonctionnement

Principe général

Paylib est un portefeuille électronique permettant d’effectuer des paiements carte sécurisés et garantis. Lors de la cinématique de paiement Web, le porteur est redirigé vers le site de Paylib afin de s’authentifier et de choisir sa carte de paiement.

Disponibilité par interface

La présence de l’internaute étant obligatoire pour authentification lors d’un paiement Paylib, un paiement offline n’est pas possible.

Interface (mode) Moyen de paiement

Mercanet Essentiel

Mercanet Gestion Plus

Mercanet Batch

Sips Walletpage

POST

JSON

SOAP

JSON

SOAP

Batch

POST

JSON

SOAP

Paylib

-

-

-

-

Cinématiques de paiement

Parcours utilisateur Web

Lors d’un paiement via Paylib, le parcours de l’internaute se présente comme ci-dessous :

Paylib 1.PNG

Figure 1 - Parcours utilisateur sur une cinématique de paiement Paylib

Le processus d’authentification est réalisé sur les pages du site Paylib.

Pour bénéficier de Paylib, l’internaute devra s’être préalablement inscrit au portefeuille électronique via sa banque en ligne.

Sur l’interface Mercanet Gestion Plus, la page de choix du moyen de paiement et la page de ticket de caisse sont hébergées par le site commerçant.

Mercanet Essentiel

La cinématique de paiement réalisé dans le cadre de Mercanet Essentiel est décrite ci-dessous :
Paylib 2.PNG
Figure 2 - Cinématique de paiement Paylib sur Mercanet Essentiel

Etape

Description

1

L’internaute valide sa commande sur le site du commerçant.

2

Le commerçant initialise une session de paiement et redirige l’internaute vers la page de sélection des moyens de paiement.

3

L’internaute choisit Paylib comme moyen de paiement et est redirigé vers le site Paylib.

4

Paylib demande à l’internaute de s’identifier, s’authentifier, choisir son moyen de paiement et valider son paiement.

5

Une fois la cinématique Paylib validée, l’internaute est redirigé à nouveau sur Mercanet.

6

Mercanet récupère les données cartes et d’authentification de façon sécurisée auprès du serveur Paylib.

7

Mercanet effectue la demande d’autorisation auprès du système d’acquisition carte.

8

Mercanet reçoit la réponse à la demande d’autorisation.

9

Mercanet informe le commerçant du résultat de la cinématique de paiement en ligne

10

Le commerçant informe l’internaute du résultat de la cinématique de paiement en ligne.

10’

Mercanet affiche le ticket de caisse à l’internaute (si requis) pour l’informer du résultat de la cinématique de paiement en ligne.

11

Mercanet envoie les transactions pour remise en banque.

12

Le commerçant peut être informé de l’arrivée des fonds par le biais des outils de reporting.

Mercanet Gestion Plus (mode Web)

La cinématique de paiement réalisé dans le cadre de Mercanet Gestion Plus en mode Web est décrite ci-dessous :
Paylib 3.PNG
Figure 3 - Cinématique de paiement Paylib Web sur Mercanet Gestion Plus

Etape

Description

1

L’internaute valide sa commande sur le site du commerçant. Il choisit de payer sa transaction via Paylib.

2

Le commerçant initialise une session de paiement auprès de Mercanet.

3

Mercanet confirme l’initialisation de la transaction et indique en réponse l’URL vers laquelle rediriger le porteur.

4

Le commerçant redirige l’internaute vers Paylib via la plateforme Mercanet. Paylib demande à l’internaute de s’identifier, s’authentifier, choisir son moyen de paiement et valider son paiement.

5

Une fois la cinématique Paylib validée, l’internaute est redirigé à nouveau sur Mercanet.

6

Mercanet récupère les données cartes et d’authentification de façon sécurisée auprès du serveur Paylib.

7

Mercanet effectue la demande d’autorisation auprès du système d’acquisition carte.

8

Mercanet reçoit la réponse à la demande d’autorisation.

9

Mercanet redirige l’internaute vers le site commerçant.

10

Le commerçant demande la finalisation de la transaction auprès de Mercanet.

11

Mercanet informe le commerçant du résultat de la cinématique de paiement en ligne. Le commerçant informe l’internaute du résultat de la cinématique de paiement en ligne.

12

Mercanet envoie les transactions pour remise en banque.

13

Le commerçant peut être informé de l’arrivée des fonds par le biais des outils de reporting.

Pages de paiement

Paylib 4.PNG
Figure 4 - Choix du moyen de paiement

Paylib 5.PNG
Figure 5 - Page Paylib : identification du porteur

Paylib 6.PNG
Figure 6 - Page Paylib : choix de la carte et validation

Paylib 7.PNG
Figure 7 - Ticket de caisse

Fonctionnalités

Type de fonctionnalité

Disponibilité

Remarque

Canal de paiement

Internet

ü

Canal de paiement obligatoire pour le paiement Web.

VPC (MOTO : commande par courrier ou par téléphone)

û

Modalités de paiement

Paiement immédiat

û

Paiement en fin de journée

ü

Modalité par défaut

Paiement différé

ü

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.

Paiement à l’expédition

ü

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.

Paiement en plusieurs fois

û

Paiement abonnement (recurring)

û

Paiement par lot

û

Paiement « One click »

û


Paiement en devises

Paiement multi-devises

û

Euro uniquement

Encaissement multi-devises

û

Euro uniquement

Gestion de la fraude

  Veuillez-vous reporter à la documentation : guide contrôles anti-fraude  

Reporting commerçant

Journal des transactions

ü

Les informations liées à Paylib sont présentes à partie de la version TAB20_V4.

Journal des opérations

ü

Journal de rapprochement bancaire

ü

Journal de rapprochement des impayés

û

Les transactions effectuées via Paylib sont garanties et ne font pas l’objet d’impayés.

Outil de gestion Mercanet

ü

Opération de caisse

Annulation

ü

Validation

ü

Remboursement

ü

Duplication (disponible selon l’offre Mercanet)

ü

La transaction résultant d’une duplication n’est pas une transaction Paylib mais une transaction carte classique, sans garantie de paiement.

Mode de capture

Mode envoi automatique (annulation)

ü

Mode par défaut

Mode validation

ü

Mode immédiat

û

Cycle de vie

Paylib 8.PNG
Figure 8 - Cycle de vie des transactions Paylib

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 l’internaute. De ce fait, le délai maximum autorisé pour un paiement Paylib est de 6 jours (sauf cas particulier de l’option « paiement à plus de 6 jours Paylib » décrit plus bas). Si le commerçant renseigne un délai de capture supérieur, il sera automatiquement forcé par la plateforme de paiement.

Remise en paiement

La remise en paiement est effectuée vers l’acquéreur en fonction des modalités définies par le commerçant. En standard, la remise est effectuée la nuit (à partir de 22h - heure française) par é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, ceci 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, le commerçant devra souscrire à une option « paiement Paylib à plus de 6 jours ». Si le commerçant a souscrit à l’option « paiement Paylib à plus de 6 jours », il sera dans la capacité de créer des transactions dont le délai de capture pourra aller jusqu’à 20 jours. Si le commerçant indique 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’envoie 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.

Intégration sur Mercanet Essentiel

Requête de paiement

Aucune donnée spécifique n’est nécessaire pour soumettre une requête de paiement Paylib.

Nom du champ 

Remarques/règles

Exemple de valorisation

paymentMeanBrandList

Portefeuilles et moyens de paiement utilisés pour le paiement.

PAYLIB

Cependant, les champs ci-dessous ont un comportement spécifique :

Nom du champ 

Remarques/règles

Exemple de valorisation

captureDay

Si le commerçant ne bénéficie pas de l’option « paiement Paylib à plus de 6 jours », le délai de capture sera forcé à 6 jours si un délai supérieur est indiqué dans la requête. Si le commerçant bénéficie de cette option, le délai de capture sera forcé à 20 jours si un délai supérieur est indiqué dans la requête.

0

Réponses manuelle et automatique

Pour bénéficier de Paylib, il est nécessaire de passer à la version 2.6 (ou supérieur) des réponses automatique et manuelle. A partir de cette version de message, les labels correspondants au statut d’authentification deviennent génériques. Ils ne seront donc, par exemple, plus tagués 3DS pour des transactions bénéficiant d’une authentification 3D-Secure : 3D_SUCCESS devient SUCCESS, 3D_FAILURE devient FAILURE, …

Pour connaitre la liste des nouveaux statuts vous pouvez vous reporter aux annexes de ce document pour ce qui concerne Paylib, et au dictionnaire des données pour la liste exhaustive.

Les champs suivants ont un comportement spécifique :

Nom du champ 

Remarques/règles

Exemple de valorisation

panEntryMode

Mode de saisie des données carte.

WALLET

walletType

Nom du portefeuille électronique utilisé pour la transaction.

PAYLIB

holderAuthentProgram

Programme utilisé pour authentifier le porteur.

PAYLIB

holderAuthentMethod

Méthode d’authentification du porteur.

PASSWORD

holderAuthentStatus

Statut d’authentification du porteur.

SUCCESS

Intégration sur Mercanet Gestion Plus

Requête de paiement

Sur Mercanet Gestion Plus, les méthodes à utiliser pour créer un paiement Paylib sont :

  • paymentProviderInitialize : méthode pour initialiser la session de paiement Paylib
  • paymentProviderFinalize : méthode pour finaliser le paiement PaylibAucune donnée spécifique n’est nécessaire pour soumettre une requête de paiement Paylib.

Nom du champ 

Remarques/règles

Exemple de valorisation

paymentMeanBrand

Portefeuille utilisé pour le paiement.

PAYLIB

Cependant, les champs ci-dessous ont un comportement spécifique :

Nom du champ 

Remarques/règles

Exemple de valorisation

captureDay

Si le commerçant ne bénéficie pas de l’option « paiement Paylib à plus de 6 jours », le délai de capture sera forcé à 6 jours si un délai supérieur est indiqué dans la requête.   Si le commerçant bénéficie de cette option, le délai de capture sera forcé à 20 jours si un délai supérieur est indiqué dans la requête.

0

orderChannel

Si le commerçant souhaite faire un paiement In-App, le mot-clef à envoyer est « INAPP ». La valeur par défaut est « INTERNET » et déclenchera un paiement Web.

INTERNET

Réponse

Les champs suivants en réponse de la requête de finalisation ont un comportement spécifique :

Nom du champ

Remarques/règles

Exemple de valorisation

panEntryMode

Mode de saisie des données carte.

WALLET

walletType

Nom du portefeuille électronique utilisé pour la transaction.

PAYLIB

holderAuthentProgram

Programme utilisé pour authentifier le porteur.

PAYLIB

holderAuthentMethod

Méthode d’authentification du porteur.

PASSWORD

holderAuthentStatus

Statut d’authentification du porteur.

SUCCESS

guaranteeIndicator

Indicateur de la garantie de paiement. L’indicateur sera mis à jour suite à la demande d’autorisation.

Y

Annexes

Codes réponses acquéreurs

Codes réponse renvoyés par les serveurs d’autorisations carte Visa et Mastercard :

Code

Description

00

Transaction approuvée ou traitée avec succès

02

Contacter l'émetteur de carte

03

Accepteur invalide

04

Conserver la carte

05

Ne pas honorer

07

Conserver la carte, conditions spéciales

08

Approuver après identification

12

Transaction invalide

13

Montant invalide

14

Numéro de porteur invalide

15

Emetteur de carte inconnu

30

Erreur de format

31

Identifiant de l'organisme acquéreur inconnu

33

Date de validité de la carte dépassée

34

Suspicion de fraude

41

Carte perdue

43

Carte volée

51

Provision insuffisante ou crédit dépassé

54

Date de validité de la carte dépassée

56

Carte absente du fichier

57

Transaction non permise à ce porteur

58

Transaction interdite au terminal

59

Suspicion de fraude

60

L'accepteur de carte doit contacter l'acquéreur

61

Dépasse la limite du montant de retrait

63

Règles de sécurité non respectées

68

Réponse non parvenue ou reçue trop tard

90

Arrêt momentané du système

91

Emetteur de cartes inaccessible

96

Mauvais fonctionnement du système

97

Échéance de la temporisation de surveillance globale

98

Serveur indisponible routage réseau demandé à nouveau

99

Incident domaine initiateur

Méthodes d’authentification Paylib

Méthode

Description

NOT_SPECIFIED

La méthode d’authentification n’est pas indiquée par la plateforme Paylib.

NO_AUTHENT

Aucune authentification n’a été effectuée.

PASSWORD

L’authentification a été effectuée par mot de passe.

OTP_TELE

L’authentification a été effectuée via un OTP envoyé préalablement par SMS au téléphone mobile de l’internaute.

OTP_SOFTWARE

L’authentification a été effectuée via l’application utilisée par l’internaute.

OTP_HARDWARE

L’authentification a été effectuée via l’appareil utilisé par l’internaute (ordinateur, tablette, téléphone, …).

Statuts d’authentification Paylib

Statut

Description

SUCCESS

L’internaute s’est authentifié avec succès.

FAILURE

L’internaute a échoué lors de son authentification.

CANCEL

L’internaute a annulé son paiement depuis le site Paylib.

NOT_ENROLLED

L’internaute n’a pas de compte Paylib.

NOT_PARTICIPATING

Le commerçant n’est pas reconnu par la plateforme Paylib.

ERROR

Une erreur s’est produite sur la plateforme Paylib.