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 = AutorAuthor+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 = AutorAuthor+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 = AutorAuthor
• 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.

The following functions are available via the Payline back office and webservice API:

• Total or partial validation of a payment.
• Cancellation of a payment.
• Full or partial refund of a payment.

Paylib One-Click

One-Click Paylib should make it possible to speed up payment stages while maintaining the payment guarantee.

The buyer must request to register the Paylib wallet used during a standard payment, and then secondly, to pay with one click by referencing the registered wallet.

Paylib realizes the payment in one click using the preferred card of the referenced wallet.
The preferential card is defined or modified by the holder of Paylib wallet by connecting to his online banking application.
The management of preferential card is carried out outside of any payment process.

Available functions

• Paylib allows you to renew the authorization using the doReAuthorization web service.
• The validation is performed either from the backoffice, or from the doCapture web service, or from the batch interface.
• The refund / cancellation is made either from the backoffice or from the doRefund or doReset web service.
• The hidden PAN and card expiration date are updated as needed after each Paylib One-Click payment.
• Payment with Paylib allows the tokenized PAN of the card used for payment to be sent to the merchant (getPaymentStatus).
• Recurring or Instant payment is not possible with a Paylib Wallet type card.

The user is identified automatically via an association between a technical Wallet identifier provided by Paylib and a buyer identifier provided by the merchant.

Configuration

To use Paylib one-click payments, the merchant must configure at the level of his points of sale :

• Commercial offer authorizes Paylib payments.
• The reference banking contracts are 3DS.
• Do not activate 3DS in Payline.
• Sharing wallets.
• Registration of payment data in the Payline wallet.
• The conditions for recording payment data.

Integration

The consumer must realize a first payment and register his card in the wallet using the doWebpayment web service and providing an order reference, the OK and KO return URLs, the URL to allow Payline to notify the end of the order, the data related to the order, delivery, holder, payment method, etc.

If the cardholder is authenticated and the card is present, Payline records the data and the identification token of the Paylib wallet.

For the second payment, if the merchant provides the reference of this wallet in a doWebpayment payment request with a wallet containing a Paylib type card, then Payline offers Paylib payment in one click.

As for all payments made with by wallet, the getWebPaymentDetails returns the VAD contract number associated with the Paylib wallet. To retrieve information on the type of wallet used during the transaction, use the "externalWalletType" field and the "externalWalletContractNumber" field at the output of the getWebPaymentDetails serviceComme 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 :

1. Par envoi d’un OTP SMS que le titulaire doit restituer (méthode M1).
2. Par l’intermédiaire de l’application mobile (méthode M2).

Méthode 1: avec le mot de passe pas SMS :

Image Removed Image Removed

authenticates wallet holders in two different ways. The method used is defined by the issuing bank :

1. By sending an OTP SMS that the holder must return (M1 method).
2. Via the mobile application (M2 method).

Method 1: with password not SMS

Image Added Image Added

Méthod 2: with validation on the smartphone in-appMéthode 2: avec validation sur l'in-app du smartphone :

Extrait
hidden true

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

You must contact support and ask them to create a PAYLIB account from your existing banking contracts.

One-click cancellation of a Paylib payment

A buyer who chooses a one-click Paylib payment can abandon this payment method and choose another before the authentication step.
The standard customization of payment pages requires the buyer to cancel the Paylib payment with one click in progress before changing the payment method.
Personalization by Widget allows the change of payment method without explicitly requesting the cancellation of the Paylib one-click payment.

Processing of the brand choice function

The Paylib payment method is not subject to the European regulation known as the choice of brand.
Payline forwards authorization requests to the SAA requesting processing through the CB network.

Return codes 

Payline informs you of the result of a payment via the return code of the getWebPaymentDetails and getTransactionDetails messages.
When the payment is accepted, Payline returns the return code to the value "00000". For a refused payment, the code varies according to the reason for refusal (For example: 04xxx for a suspected fraudPayline 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).

Pages

linked