Content
More information
How do configure your account ?
You must contact your partner account manager to obtain the necessary information to configure your test and production account on Payline (account login and password).
In order to create the PAYLIB payment method on Payline, in test and in production, go to the backoffice in the "Configuration" tab then "Your payment methods". A search screen appears, click on the "New payment method" button.
Payment method creation screen 1/2:
Select your point of sale then the type of payment method "PAYLIB".
Then click on the "Next" button.
Payment method creation screen 2/2:
Enter a description, a contract number of your choice then select your currency. Click on the “Active” status and fill in the associated VAD contract. You must perform test transactions to validate proper operation in production.
The banking contract must be 3D-Secure but the 3DS option must not be activated on Payline, it is Paylib that triggers the 3D Secure.
View Paylib payment pages
Displaying the PAYLIB payment pages simply requires contacting the doWebPayment web service. This web service returns to your server the url to which you must redirect your customer so that he can make his payment.
So for those of you who use Payline to accept payments by credit card, the display of the PAYLIB payment method is achieved simply by having activated your payment method.
To select the payment methode to be displayed to the consumer, you must add to the value of the “selectedContractNumber” field the number you entered when configuring the payment method.
You must fill in the “contractNumber” field with the value that you entered when configuring the payment method.
Payline informs you of the result of a payment via the return code of the getWebPaymentDetails and getTransactionDetails messages.
How to offer Paylib payment to yours customers ?
Once the payment method is activated, you must implement an integration with PAYLINE web service calls in web mode: doWebpayment and getWebPaymentDetails
The available payment features are described below.
Payment Validation
The transaction is sent automatically the same day. This payment requires the following parameters:
- Payment mode = CPT
- Payment fonction = Autor+Capture
- Payment action = 101
Deferred payment with automatic validation
The transaction is sent for financing with a deferral of n days (maximum D + 6). This payment requires the following parameters:
- Payment mode = DIF
- Payment fonction = Autor+Capture
- Payment action = 101
- Differed action = Date on the wished validation date
Payment with validation
The transaction is sent for financing only if you validate the payment. If the payment is not validated, it changes to expired status and can no longer be funded. You have 30 days to validate. The transaction is not guaranteed until it is validated. This payment requires the following parameters :
- Payment mode = CPT
- Payment fonction = Autor
- Payment action = 100
Other features
Les fonctions de gestion suivantes sont disponibles via le centre d'administration Payline ainsi que l'API webservice :
- Validation totale ou partielle d'un paiement.
- Annulation d'un paiement.
- Remboursement total ou partiel d'un paiement.
One-Click Paylib
Le One-Click Paylib doit permettre d’accélérer les étapes de paiement tout en conservant la garantie de paiement.
L’acheteur doit demander d’enregistrer le portefeuille Paylib utilisé lors d’un paiement standard, puis dans un second temps, de payer en un clic en référençant le portefeuille enregistré.
Paylib effectue le paiement en un clic en utilisant la carte préférentielle du portefeuille référencé.
La carte préférentielle est définie ou modifiée par le titulaire du portefeuille Paylib en se connectant à son application de banque en ligne.
La gestion de la carte préférentielle s’effectue en dehors de tout parcours de paiement.
Les fonctions disponibles
- Paylib permet de renouveler l’autorisation en utilisant le web service doReAuthorization.
- La validation s’effectue soit à partir du centre d’administration, soit à partir du web service doCapture, soit à partir de l’interface batch.
- Le remboursement/annulation s’effectue soit à partir du centre d’administration, soit à partir du web service doRefund ou doReset.
- Le PAN masqué et la date d’expiration de la carte sont mis à jour si nécessaire après chaque paiement Paylib en un clic.
Le paiement avec Paylib permet de remonter au commerçant (getPaymentStatus) le PAN tokenisé de la carte utilisée pour le paiement.
- Le paiement récurrent ou N x fois n’est pas possible avec une carte de type Portefeuille Paylib.
L’utilisateur est identifié automatiquement via une association entre un identifiant technique Wallet fourni par Paylib et un identifiant acheteur fourni par le commerçant.
La configuration
Pour utiliser les paiements Paylib en un clic le commerçant doit configurer au niveau de ses points de vente :
- Offre commerciale autorise les paiements Paylib.
- Les contrats bancaires références sont 3DS.
- Ne pas activer le 3DS dans Payline.
- Le partage des wallets.
- L’enregistrement des données de paiement dans le wallet Payline.
- Les conditions d’enregistrement des données de paiement.
L'intégration
Le consommateur doit réaliser un premier paiement et enregistrer sa carte dans le wallet en utilisant le webservice doWebpayment et en fournissant une référence de commande, les URL de retour OK et KO, l’URL pour permettre à Payline de notifier la fin de commande, les données liées à la commande, à la livraison, au porteur, aux moyens de paiement,...
Si le porteur est authentifié et la carte est présente, Payline enregistre les données et le jeton d’identification du wallet Paylib.
Pour le deuxième paiement, si le commerçant fournit la référence de ce wallet dans une demande de paiement doWebPayment avec un wallet contenant une carte de type Paylib, alors Payline propose le paiement Paylib en un clic.
Comme pour tous les paiements effectués avec par wallet, le getWebPaymentDetails renvoie le numéro de contrat VAD associé au portefeuille Paylib. Pour récupérer l’information du type de wallet utilisé lors de la transaction il faut utiliser le champ « externalWalletType » et le champ « externalWalletContractNumber » en sortie du service getWebPaymentDetails.
Paylib authentifie les titulaires de portefeuille de deux manières différentes. La méthode utilisée est définie par la banque émettrice :
- Par envoi d’un OTP SMS que le titulaire doit restituer (méthode M1).
- Par l’intermédiaire de l’application mobile (méthode M2).
Méthode 1: avec le mot de passe pas SMS :
Méthode 2: avec validation sur l'in-app du smartphone :
Vous devez contacter le support et leur demander de votre créer un compte PAYLIB à partir de vos contrats bancaires existants.
Annulation d’un paiement Paylib un clic
Un acheteur qui choisit un paiement Paylib en un clic peut abandonner ce mode de paiement pour en choisir un autre avant l'étape d'authentification
La personnalisation standard des pages de paiements impose à l’acheteur d’annuler le paiement Paylib un clic en cours avant de changer de moyen de paiement.
La personnalisation par Widget permet le changement de moyen de paiement sans demander explicitement l’annulation du paiement Paylib un clic.
Traitement de la fonction choix de la marque
Le moyen de paiement Paylib n’est pas assujetti à la réglementation européenne dite du choix de la marque.
Payline transmet les demandes d’autorisation au SAA en demandant le traitement par le réseau CB.
Les codes de retour
Payline vous informe du résultat d'un paiement via le code retour des messages « getWebTransactionDetails » et « getTransactionDetails ».
Lorsque le paiement est accepté, Payline renvoie le code retour à la valeur « 00000 ». Pour un paiement refusé, le code varie en fonction du motif de refus (Par exemple : 04xxx pour une suspicion de fraude).