Guide d'implémentation · Renvoyer l'e-mail de confirmation de la transaction au marchand.....26 9.7. Effectuer un remboursement.....27 9.8. Dupliquer une transaction..... 27 9.9

SOLUTION COLLECT

Ajouter le bouton de paiement Paylib

Guide d'implémentation

Version du document 2.5

Sommaire

1. HISTORIQUE DU DOCUMENT........................................................................................................ 3

2. OBTENIR DE L'AIDE.......................................................................................................................... 4

3. PRÉSENTATION...................................................................................................................................5

4. INFORMATIONS TECHNIQUES.......................................................................................................6

5. PRÉREQUIS.......................................................................................................................................... 7

6. INTÉGRATION DANS LE PARCOURS CLIENT............................................................................. 8

7. CINÉMATIQUE DE PAIEMENT........................................................................................................9

8. ÉTABLIR LE DIALOGUE AVEC LA PLATEFORME DE PAIEMENT....................................... 10

9. CONFIGURER LES NOTIFICATIONS............................................................................................119.1. Configurer la notification à la fin du paiement........................................................................................ 129.2. Configurer la notification en cas d'abandon/annulation............................................................................13

10. GÉNÉRER UN FORMULAIRE DE PAIEMENT......................................................................... 1410.1. Créer une demande de paiement Paylib..................................................................................................1610.2. Transmettre les données de l'acheteur.................................................................................................... 1710.3. Transmettre les données de livraison......................................................................................................1810.4. Transmettre les données de la commande.............................................................................................. 19

11. ENVOYER LA DEMANDE DE PAIEMENT................................................................................ 2111.1. Rediriger l'acheteur vers la page de paiement........................................................................................ 2111.2. Gérer les erreurs...................................................................................................................................... 21

12. RÉALISER DES PAIEMENTS DE TEST..................................................................................... 23

13. ANALYSER LE RÉSULTAT DU PAIEMENT............................................................................... 2413.1. Traiter les données de la réponse............................................................................................................2413.2. Analyser le résultat de la demande d'autorisation.................................................................................. 26

14. GÉRER LES TRANSACTIONS DEPUIS LE BACK OFFICE LYRA COLLECT....................... 2714.1. Consulter le détail d'une transaction....................................................................................................... 2714.2. Effectuer un remboursement................................................................................................................... 2914.3. Modifier une transaction......................................................................................................................... 3014.4. Valider une transaction............................................................................................................................3114.5. Annuler une transaction.......................................................................................................................... 32

1. HISTORIQUE DU DOCUMENT

Version Auteur Date Commentaire

2.5 Lyra Collect 30/11/2020 Refonte du document

2.4 Lyra Collect 16/07/2019 Mise à jour de la procédure de création d'un contrat.

2.3 Lyra Collect 01/10/2018 Version initiale

Ce document et son contenu sont strictement confidentiels. Il n’est pas contractuel. Toute reproductionet/ou distribution de tout ou partie de ce document ou de son contenu à une entité tierce sont

strictement interdites ou sujettes à une autorisation écrite préalable de Lyra Collect. Tous droits réservés.

Ajouter le bouton de paiement Paylib - Version du document 2.5

Tous droits réservés - 3 / 32

2. OBTENIR DE L'AIDE

Vous cherchez de l'aide? Consultez notre FAQ sur notre site

https://docs.lyra.com/fr/collect/faq/sitemap.html

Pour toute question technique ou demande d'assistance, nos services sont disponibles

du lundi au vendredi de 9h à 18h

par téléphone au :

par e-mail : [email protected] via votre Back Office Expert, menu Aide > Contacter le support

Pour faciliter le traitement de vos demandes, il vous sera demandé de communiquer votre identifiant deboutique (numéro à 8 chiffres) .



https://docs.lyra.com/fr/collect/faq/sitemap.html

mailto:[email protected]

3. PRÉSENTATION

Disponible sur la plateforme de paiement, PAYLIB est un service innovant de portefeuilleélectronique (« e-Wallet »). Il est le fruit de la collaboration de grandes banques françaises (BNPParibas, La Banque Postale, la Société Générale et Arkea). Son objectif est de simplifier les paiementse&m-commerce.PAYLIB a été conçu dans l’intérêt de l'acheteur et du marchand. Il permet de renforcer la confiancedes clients lorsqu’ils achètent sur Internet, tout en sécurisant leurs paiements.Avantages pour les acheteurs :

• Ils effectuent des paiements en ligne sans avoir à saisir leurs données de carte bancaire.

• Le service est disponible à partir d'un mobile, d'une tablette ou d'un ordinateur.

• L'identifiant et le mot de passe sont personnels. Le parcours d'achat gagne en simplicité et enfluidité.

• Les données bancaires sont conservées par leur banque.

• La traçabilité des transactions est intégrée au relevé de leur compte.

Avantages pour votre site marchand :

• L'intégration est simple. Il suffit d'enrôler le contrat bancaire auprès de PAYLIB afin d'utiliser ceservice.

• L'enrôlement bancaire est le gage de sécurité. La banque de l'acheteur effectue tous les contrôlesde sécurité avant de valider une transaction.

• PAYLIB a le même niveau de garantie que 3D Secure et intègre le transfert de responsabilité.

Devises supportées • EUR

Pays supportés • France

Informationscomplémentaires

• La demande d'autorisation est valide 7 jours. Tout délai de remise supérieur seraramené automatiquement à 7.

• La boutique doit obligatoirement être associée à un contrat CB VADS.

• Il est nécessaire d'avoir un contrat Paylib pour le mode TEST et un autre contrat Paylibpour le mode PRODUCTION.



4. INFORMATIONS TECHNIQUES

Valeurs du champvads_card_brand

Devises supportées Pays supportésDurée de validitéde l'autorisation

Cinématiquede paiement

PAYLIB EUR FR 7 jours Capture différée

Canaux de vente

e-commerce

m-commerce

Paiement manuel

Serveur Vocal Interactif

Ordre de paiement par e-mail/SMS

Ordre de paiement par WhatsApp

Opération sur les transactions

Annulation

Remboursement

Modification

Validation

Duplication

Rapprochement manuel

Type d'intégration

Redirection

Iframe

Client JavaScript

Formulaire de collecte de données

MarketPlace

API Web Services

SDK Mobile

Back Office

WhatsApp

Typologie de paiement

Paiement immédiat

Paiement différé

Paiement en plusieurs fois

Paiement par abonnement

Paiement par fichier (alias ou par lot)

Paiement 1 clic

Paiement par wallet

Divers

Restitution dans les journaux

Rapprochement des transactions

Rapprochement des impayés

Tentatives de paiement supplémentaires



5. PRÉREQUIS

Côté marchand

Pour proposer le paiement via Paylib sur votre site marchand, vous devez :

• souscrire à l'option "Paiement via Paylib" dans votre offre Lyra Collect.

Côté acheteur

L'adhésion au service PAYLIB s'effectue directement auprès de la banque. L'acheteur peut l'activer depuisle site internet ou depuis l’application mobile de sa banque en quelques clics :

• création d'un compte PAYLIB en enregistrant une adresse e-mail et un mot de passe.

• sélection d'une carte bancaire à associer à PAYLIB sans mentionner son numéro.

• création d'un second mot de passe qui servira à valider les transactions.

Remarque

Un acheteur multibancarisé dans les 4 banques partenaires devra ouvrir un compte PAYLIB dans chacunedes 4 banques.



6. INTÉGRATION DANS LE PARCOURS CLIENT

Afin de simplifier le parcours client, d'augmenter le taux de transformation et donc de réduire le nombred'abandon de commande, il est préconisé :

• de réaliser le choix du moyen de paiement sur le site marchand,

• de générer un bouton de paiement pour chaque type de moyen de paiement.

Exemple de sélection du moyen de paiement :



7. CINÉMATIQUE DE PAIEMENT

Le diagramme ci-dessous présente la cinématique des échanges du point de vue de l'acheteur.

ACHETEUR

SERVEURMARCHAND

PLATEFORMEDE PAIEMENT

Valide le panier

Propose le choixdu moyen de paiement

Sélectionne Paylib

Redirige vers l'interfaced'identification Paylib

Se connecteà son compte Paylib

Réalise une demanded'autorisation puisenvoie la réponse

Affiche la page deconfirmation puis redirige

vers le site marchand

Affiche la pagede confirmationde commande

Redirige versla plateforme

Affiche lapage de connexion

Valide son paiement

1. L’acheteur valide son panier et choisit de régler via Paylib sur le site marchand.

2. Le site marchand redirige l’acheteur vers la plateforme de paiement.

3. La plateforme de paiement redirige l'acheteur vers l'interface d'identification Paylib.

4. L'acheteur renseigne l'identifiant et le mot de passe de son compte Paylib.

5. Il confirme sa saisie en cliquant sur Valider.

6. Il sélectionne sa carte.

7. Une demande d'autorisation est effectuée auprès de l'émetteur (banque de l'acheteur), en plus ducontrôle de fraudes interne effectué par la plateforme de paiement.

8. En cas de succès, une page de résumé est présentée à l’acheteur récapitulant les informations de latransaction.



8. ÉTABLIR LE DIALOGUE AVEC LA PLATEFORME DE PAIEMENT

Le dialogue avec la plateforme de paiement est décrit dans le Guide d'implémentation API Formulairedisponible sur le site documentaire.

Le dialogue entre le site marchand et la plateforme de paiement s’effectue par un échange de données.

Pour créer un paiement, ces données sont envoyées au moyen d'un formulaire HTML via le navigateur del’acheteur.

A la fin du paiement, le résultat est transmis au site marchand de deux manières :

• automatiquement au moyen de notifications appelées URL de notification instantanée (égalementappelée IPN pour Instant Payment Notification).

• par le navigateur lorsque l’acheteur clique sur le bouton pour revenir au site marchand.

Pour assurer la sécurité des échanges, les données sont signées au moyen d’une clé connue uniquementdu marchand et de la plateforme de paiement.



9. CONFIGURER LES NOTIFICATIONS

Plusieurs types de notifications sont mises à disposition dans le Back Office Expert.

• Appel URL de notification

• E-mail envoyé au marchand

• E-mail envoyé à l'acheteur

• SMS envoyé au marchand

• SMS envoyé à l'acheteur

Elles permettent de gérer les événements (paiement accepté, abandon par l'acheteur, annulation par lemarchand, validation par le marchand...) qui généreront l'envoi d'une notification à destination du sitemarchand, du marchand ou de l'acheteur.

Les notifications de type Appel URL de notification sont les plus importantes car elles représentent l'unique moyen fiable pourle site marchand d'obtenir le résultat d'un paiement.

Si la plateforme n'arrive pas à joindre l'URL de votre page, alors un e-mail est envoyé à l'adresse e-mailspécifiée.

Il contient :

• Le code HTTP de l'erreur rencontrée

• Des éléments d'analyse en fonction de l'erreur

• Ses conséquences

• La procédure à suivre depuis le Back Office Expert pour renvoyer la requête vers l’URL déjà définie.

Pour accéder à la gestion des règles de notification :

1. Connectez-vous à votre Back Office Lyra Collect disponible à cette adresse :

https://secure.lyra.com/portal/

2. Cliquez sur le bouton Autres actions pour accéder au Back Office Expert.

3. Allez dans le menu Paramétrage > Règles de notifications.




9.1. Configurer la notification à la fin du paiement

Cette règle permet de notifier le site marchand dans les cas suivants :

• Paiement accepté

• Paiement refusé

Cette notification est indispensable pour communiquer le résultat d'une demande de paiement.

Elle informera le site marchand du résultat du paiement même si l'acheteur ne clique pas sur le boutonRetour à la boutique.

1. Effectuez un clic droit sur la ligne URL de notification à la fin du paiement.

2. Sélectionnez Gérer la règle.

3. Dans la section Paramétrage général, renseignez le champ Adresse(s) e-mail(s) à avertir en casd’échec.

Pour spécifier plusieurs adresses e-mails, séparez-les par un point-virgule.

4. Cochez la case Rejeu automatique en cas d’échec si vous souhaitez autoriser la plateforme à renvoyerautomatiquement la notification en cas d'échec, et ce, jusqu'à 4 fois.

5. Dans la section URL de notification de l'API formulaire V1, V2, renseignez l’URL de votre page dansles champs URL à appeler en mode TEST et URL à appeler en mode PRODUCTION si vous souhaitezrecevoir les notifications au format API Formulaire.

6. Sauvegardez vos modifications.



9.2. Configurer la notification en cas d'abandon/annulation

Cette règle permet de notifier le site marchand dans les cas suivants :

• En cas d’abandon/annulation de la part de l’acheteur, via le bouton Annuler et retourner à la boutique.

• Lorsque l'acheteur n'a pas terminé son paiement avant l'expiration de sa session de paiement.

La durée maximale d'une session de paiement est de 10 minutes.

Cette règle est désactivée par défaut.

1. Effectuez un clic droit sur la ligne URL de notification sur annulation.

2. Sélectionnez Gérer la règle.

3. Dans la section Paramétrage général, renseignez le champ Adresse(s) e-mail(s) à avertir en casd’échec.

Pour spécifier plusieurs adresses e-mails, séparez-les par un point-virgule.

4. Cochez la case Rejeu automatique en cas d’échec si vous souhaitez autoriser la plateforme à renvoyerautomatiquement la notification en cas d'échec, et ce, jusqu'à 4 fois.

5. Dans la section URL de notification de l'API formulaire V1, V2, renseignez l’URL de votre page dansles champs URL à appeler en mode TEST et URL à appeler en mode PRODUCTION si vous souhaitezrecevoir les notifications au format API Formulaire.

6. Sauvegardez vos modifications.

7. Activez la règle, en effectuant un clic droit sur URL de notification sur annulation et en sélectionnantActiver la règle.



10. GÉNÉRER UN FORMULAIRE DE PAIEMENT

Pour générer une demande de paiement, vous devez construire un formulaire HTML comme suit :

<form method="POST" action="https://secure.lyra.com/vads-payment/"> <input type="hidden" name="parametre1" value="valeur1" /> <input type="hidden" name="parametre2" value="valeur2" /> <input type="hidden" name="parametre3" value="valeur3" /> <input type="hidden" name="signature" value="signature"/> <input type="submit" name="payer" value="Payer"/></form>

Il contient :

• Les éléments techniques suivants :

• Les balises <form> et </form> qui permettent de créer un formulaire HTML.

• L’attribut method="POST" qui spécifie la méthode utilisée pour envoyer les données.

• L’attribut action="https://secure.lyra.com/vads-payment/" qui spécifie où envoyer les données duformulaire.

• Les données du formulaire :

• L’identifiant de la boutique.

• Les caractéristiques du paiement en fonction du cas d’utilisation.

• Les informations complémentaires en fonction de vos besoins.

• La signature qui assure l'intégrité du formulaire.

Ces données sont ajoutées au formulaire en utilisant la balise <input> :

<input type="hidden" name="parametre1" value="valeur1" />

Pour valoriser les attributs name et value, référez-vous au Dictionnaire de données disponible égalementsur le site documentaire.

Toutes les données du formulaire doivent être encodées en UTF-8.

Les caractères spéciaux (accents, ponctuation, etc.) seront ainsi correctement interprétés par laplateforme de paiement. Dans le cas contraire, le calcul de signature sera erroné et le formulaire serarejeté.

• Le bouton Payer pour envoyer des données :

<input type="submit" name="payer" value="Payer"/>



https://secure.lyra.com/vads-payment/


Des cas d’utilisation sont présentés dans les chapitres suivants. Ils vous permettront de construire votreformulaire de paiement en fonction de vos besoins.

Le tableau suivant vous donne des indications sur les différents formats que vous pourrez rencontrer lorsde la construction de votre formulaire.

Notation Description

a Caractères alphabétiques (de ‘A’ à ‘Z’ et de ‘a’ à ‘z’)

n Caractères numériques

s Caractères spéciaux

an Caractères alphanumériques

ans Caractères alphanumériques et spéciaux (à l'exception de "<" et ">")

3 Longueur fixe de 3 caractères

..12 Longueur variable jusqu’à 12 caractères

json JavaScript Object Notation.Objet contenant des paires de clé/valeur séparées par une virgule.Il commence par une accolade gauche " { " et se termine par une accolade droite " } ".Chaque paire clé/valeur contient le nom de la clé entre double-quotes suivi par " : ", suivi par une valeur.Le nom de la clé doit être alphanumérique.La valeur peut être :

• une chaîne de caractères (dans ce cas elle doit être encadrée par des doubles-quotes)

• un nombre

• un objet

• un tableau

• un booléen

• vide

Exemple : {"name1":45,"name2":"value2", "name3":false}

enum Caractérise un champ possédant un nombre fini de valeurs.La liste des valeurs possibles est donnée dans la définition du champ.

liste d'enum Liste de valeurs séparées par un " ; ".La liste des valeurs possibles est donnée dans la définition du champ.Exemple : vads_payment_cards=VISA;MASTERCARD

map Liste de paires clé/valeur séparées par un " ; ".Chaque paire clé/valeur contient le nom de la clé suivi par " = ", suivi par une valeur.La valeur peut être :

• une chaîne de caractères

• un booléen

• un objet json

• un objet xml

La liste des valeurs possibles pour chaque paire de clé/valeur est donnée dans la définition du champ.Exemple : vads_theme_config=SIMPLIFIED_DISPLAY=true;RESPONSIVE_MODEL=Model_1



10.1. Créer une demande de paiement Paylib

1. Utilisez l'ensemble des champs présents dans le tableau ci-après pour construire votre formulaire depaiement.

Nom du champ Description Format Valeur

vads_payment_cards Permet de forcer le type de carteà utiliser.Il est recommandé de proposersur le site marchand un boutonde paiement différent pourchaque moyen de paiement.Il est déconseillé de laisser lechamp vide.

enum PAYLIB pour appeler le bouton depaiement Paylib.

vads_site_id Identifiant de la boutique n8 Ex : 12345678

vads_ctx_mode Mode de communication avec laplateforme de paiement

enumTEST ou PRODUCTION

vads_trans_id Numéro de la transaction.Attention : ce champ n'est passensible à la casse.

an6Ex : xrT15p

vads_trans_date Date et heure du formulaire depaiement dans le fuseau horaireUTC

n14Respectez le formatAAAAMMJJHHMMSSEx : 20200101130025

vads_capture_delay Délai avant remise en banque.Toute valeur supérieure à 7 jourssera automatiquement ramenéeà 7.

n..3 0

vads_amount Montant du paiement dans saplus petite unité monétaire (lecentime pour l'euro)

n..12Ex : 3000 pour 30,00 EUR

vads_currency Code numérique de la monnaieà utiliser pour le paiement,selon la norme ISO 4217 (codenumérique)

n3 Valeurs possibles :

• 978 (EUR)

vads_action_mode Mode d’acquisition des donnéesdu moyen de paiement

enumINTERACTIVE

vads_page_action Action à réaliser enum PAYMENT

vads_version Version du protocole d’échangeavec la plateforme de paiement

enumV2

vads_payment_config Type de paiement enum SINGLE

2. Ajoutez les champs optionnels décrits dans les chapitres suivants en fonction de vos besoins.

3. Calculez la valeur du champ signature en utilisant l’ensemble des champs de votre formulaire, dontle nom commence par vads_ (voir chapitre Calculer la signature du Guide d'implémentation APIFormulaire disponible sur notre site documentaire).



10.2. Transmettre les données de l'acheteur

Le marchand peut transmettre des informations concernant l’acheteur (adresse e-mail, civilité, numéro detéléphone etc.). Ces données constitueront les informations de facturation.

Toutes les données qui seront transmises via le formulaire de paiement seront affichées dans le Back OfficeLyra Collect en consultant le détail de la transaction (onglet Client).

Utilisez les champs facultatifs ci-dessous en fonction de vos besoins. Ces champs seront renvoyés dans laréponse avec la valeur transmise dans le formulaire.


vads_cust_email Adresse e-mail de l’acheteur ans..150 Ex : [email protected]

vads_cust_id Référence de l’acheteur sur le sitemarchand

an..63Ex : C2383333540

vads_cust_national_id Identifiant national ans..255 Ex : 940992310285

vads_cust_title Civilité de l’acheteur an..63 Ex : M

vads_cust_status Statutenum

PRIVATE : pour un particulierCOMPANY : pour une entreprise

vads_cust_first_name Prénom ans..63 Ex : Laurent

vads_cust_last_name Nom ans..63 Ex : Durant

vads_cust_legal_name Raison sociale de l'acheteur an..100 Ex : D. & Cie

vads_cust_cell_phone Numéro de téléphone mobile an..32 Ex : 06 12 34 56 78

vads_cust_address_number Numéro de voie ans..64 Ex : 109

vads_cust_address Adresse postale ans..255 Ex : Rue de l'innovation

vads_cust_address2 Deuxième ligne d'adresse ans..255 Ex :

vads_cust_district Quartier ans..127 Ex : Centre ville

vads_cust_zip Code postal an..64 Ex : 31670

vads_cust_city Ville an..128 Ex : Labège

vads_cust_state Etat / Région ans..127 Ex : Occitanie

vads_cust_country Code pays suivant la norme ISO3166 alpha-2

a2

Ex : "FR" pour la France, "PF" pourla Polynésie Française, "NC" pour laNouvelle Calédonie, "US" pour lesEtats-Unis.

Remarque

Les champs vads_cust_phone et vads_cust_cell_phone acceptent tous les formats :

Exemples :

• 0123456789

• +33123456789

• 0033123456789

• (00.571) 638.14.00

• 40 41 42 42



10.3. Transmettre les données de livraison

Le marchand peut transmettre les données de livraison de l'acheteur (adresse, civilité, numéro detéléphone, etc.).

Ces données seront affichées dans le Back Office Lyra Collect en consultant le détail de la transaction (ongletClient).

Utilisez les champs facultatifs ci-dessous en fonction de vos besoins. Ces champs seront renvoyés dans laréponse avec la valeur transmise dans le formulaire.


vads_ship_to_city Ville an..128 Ex : Bordeaux

vads_ship_to_country Code pays suivant la norme ISO3166 (obligatoire pour déclencherune ou plusieurs actions si le profilContrôle du pays de la livraisonest activé).

a2

Ex : FR

vads_ship_to_district Quartier ans..127 Ex : La Bastide

vads_ship_to_first_name Prénom ans..63 Ex : Albert

vads_ship_to_last_name Nom ans..63 Ex : Durant

vads_ship_to_legal_name Raison sociale an..100 Ex : D. & Cie

vads_ship_to_phone_num Numéro de téléphone ans..32 Ex : 0460030288

vads_ship_to_state Etat / Région ans..127 Ex : Nouvelle aquitaine

vads_ship_to_status Définit le type d'adresse delivraison

enum

PRIVATE : pour une livraison chez unparticulierCOMPANY : pour une livraison enentreprise

vads_ship_to_street_number Numéro de voie ans..64 Ex : 2

vads_ship_to_street Adresse postale ans..255 Ex : Rue Sainte Catherine

vads_ship_to_street2 Deuxième ligne d’adresse ans..255

vads_ship_to_zip Code postal an..64 Ex : 33000



10.4. Transmettre les données de la commande

Le marchand peut indiquer dans son formulaire de paiement s’il souhaite transmettre les informations dela commande (numéro de la commande, description, contenu du panier etc.).

1. Utilisez les champs facultatifs ci-dessous en fonction de vos besoins. Ces champs seront renvoyésdans la réponse avec la valeur transmise dans le formulaire.


vads_order_info Informations supplémentairessur la commande

an..255Ex : Code interphone 3125

vads_order_info2 Informations supplémentairessur la commande

an..255Ex : Sans ascenseur

vads_order_info3 Informations supplémentairessur la commande

an..255Ex : Express

vads_nb_products Nombre d’articles présents dansle panier

n..12Ex : 2

vads_product_ext_idN Code barre du produit dansle site web du marchand. Ncorrespond à l'indice de l'article(0 pour le premier, 1 pour lesecond...)

Ex :vads_product_ext_id0 ="0123654789123654789"vads_product_ext_id1 ="0223654789123654789"

vads_product_labelN Libellé de l’article. N correspondà l'indice de l'article (0 pour lepremier, 1 pour le second...).

ans..255 Ex:vads_product_label0 = "Séjour 3jours datés"vads_product_label1 = "Concertprivé"

vads_product_amountN Montant de l’article exprimédans la plus petite unité de ladevise. N correspond à l'indicede l'article (0 pour le premier, 1pour le second...).

n..12 Ex:vads_product_amount0 = "32150"vads_product_amount1 = "10700"

vads_product_typeN Type de l’article. N correspondà l'indice de l'article (0 pour lepremier, 1 pour le second...).

enum Ex :vads_product_type0 = "TRAVEL"vads_product_type1 ="ENTERTAINMENT"

vads_product_refN Référence de l’article. Ncorrespond à l'indice de l'article(0 pour le premier, 1 pour lesecond...).

an..64 Ex :vads_product_ref0 = "1002127784"vads_product_ref1 = "1002127693"

vads_product_qtyN Quantité d’article. N correspondà l'indice de l'article (0 pour lepremier, 1 pour le second...).

n..12 Ex :vads_product_qty0 = "1"vads_product_qty1 = "1"

2. Valorisez le champ vads_nb_products avec le nombre d'articles contenu dans le panier.

Remarque :

Ce champ devient obligatoire pour que le panier soit pris en compte.

3. Valorisez le champ vads_product_amountN avec le montant des différents articles contenus dans lepanier dans l'unité la plus petite de la devise.

N correspond à l'indice de l'article (0 pour le premier, 1 pour le second...).

4. Valorisez le champ vads_product_typeN avec la valeur correspondant au type de l'article.


Valeur Description

FOOD_AND_GROCERY Produits alimentaires et d'épicerie

AUTOMOTIVE Automobile / Moto

ENTERTAINMENT Divertissement / Culture



Valeur Description

HOME_AND_GARDEN Maison / Jardin

HOME_APPLIANCE Equipement de la maison

AUCTION_AND_GROUP_BUYING Ventes aux enchères / Achats groupés

FLOWERS_AND_GIFTS Fleurs / Cadeaux

COMPUTER_AND_SOFTWARE Ordinateurs / Logiciels

HEALTH_AND_BEAUTY Santé / Beauté

SERVICE_FOR_INDIVIDUAL Services à la personne

SERVICE_FOR_BUSINESS Services aux entreprises

SPORTS Sports

CLOTHING_AND_ACCESSORIES Vêtements / Accessoires

TRAVEL Voyage

HOME_AUDIO_PHOTO_VIDEO Son / Image / Vidéo

TELEPHONY Téléphonie

5. Valorisez le champ vads_product_labelN avec le libellé de chacun des articles contenus dans lepanier.


6. Valorisez le champ vads_product_qtyN avec la quantité de chacun des articles contenus dans lepanier.


7. Valorisez le champ vads_product_refN avec la référence de chacun des articles contenus dans lepanier.


8. Contrôlez la valeur du champ vads_amount. Elle doit correspondre au montant total de lacommande.



11. ENVOYER LA DEMANDE DE PAIEMENT

Pour chaque transaction, l’acheteur doit être redirigé vers la page de paiement afin de finaliser son achat.

Son navigateur doit transmettre les données du formulaire de paiement.

11.1. Rediriger l'acheteur vers la page de paiement

L’URL de la plateforme de paiement est la suivante :


Exemple de paramètres envoyés à la plateforme de paiement:

<form method="POST" action="https://secure.lyra.com/vads-payment/"><input type="hidden" name="vads_action_mode" value="INTERACTIVE" /> <input type="hidden" name="vads_amount" value="2990" /> <input type="hidden" name="vads_ctx_mode" value="TEST" /> <input type="hidden" name="vads_currency" value="978" /><input type="hidden" name="vads_cust_country" value="FR" /><input type="hidden" name="vads_cust_email" value="[email protected]" /><input type="hidden" name="vads_cust_first_name" value="John" /><input type="hidden" name="vads_cust_last_name" value="Doe" /><input type="hidden" name="vads_cust_phone" value="+33102030405" /><input type="hidden" name="vads_page_action" value="PAYMENT" /><input type="hidden" name="vads_payment_cards" value="PAYLIB" /> <input type="hidden" name="vads_payment_config" value="SINGLE" /> <input type="hidden" name="vads_site_id" value="12345678" /> <input type="hidden" name="vads_trans_date" value="20190710101407" /> <input type="hidden" name="vads_trans_id" value="362812" /> <input type="hidden" name="vads_version" value="V2" /><input type="hidden" name="signature" value="NM25DPLKEbtGEHCDHn8MBT4ki6aJI/ODaWhCzCnAfvY="/><input type="submit" name="payer" value="Payer"/></form>

11.2. Gérer les erreurs

Si la plateforme détecte une anomalie lors de la réception du formulaire, un message d’erreur sera affichéet l’acheteur ne pourra pas procéder au paiement.

En mode TEST

Le message indique l’origine de l’erreur et propose un lien vers la description du code erreur pour vousaider à identifier les causes possibles.

En mode PRODUCTION

Le message indique simplement à l’acheteur qu’un problème technique est survenu.

Dans les deux cas, le marchand reçoit un e-mail d'avertissement.

Il contient :

• l’origine de l’erreur,

• un lien vers les causes possibles pour ce code d'erreur pour faciliter le diagnostic,

• l’ensemble des champs contenus dans le formulaire.

Une description des codes d'erreur avec leurs causes possibles est disponible sur notre site.

https://docs.lyra.com/collect/error-code/error-00.html





https://docs.lyra.com/collect/error-code/error-00.html

Codes d'erreur spécifiques au moyen de paiement PAYLIB :

Code Message Description de l'erreur

10133 MID_NOT_ENROLLED Le contrat Paylib n'est pas enrôlé.Pour corriger le problème :

• Contactez le Middle Office.

10134 PAYLIB_MISSING_CB_MID Paylib nécessite qu'un contrat CB soit associé à la boutique pourfonctionner.Pour corriger ce problème :

• Contactez le Middle Office.



12. RÉALISER DES PAIEMENTS DE TEST

En mode TEST, vous devez utiliser les informations suivantes :

e-mail du compte Paylib Mot de passe du compte Paylib Résultat du paiement

[email protected] P@ssword1! Paiement accepté

[email protected] Aucun de mot de passe nécessaire Paiement refusé



13. ANALYSER LE RÉSULTAT DU PAIEMENT

L'analyse du résultat du paiement est décrite dans le Guide d'implémentation API Formulaire disponiblesur notre site documentaire (https://docs.lyra.com/fr/).

Dans ce document, seul le traitement des données spécifiques à la réponse d'un paiement Paylib estabordé.

13.1. Traiter les données de la réponse

Ci-dessous un exemple d'analyse pour vous guider pas à pas lors du traitement des données de laréponse.

1. Identifiez la commande en récupérant la valeur du champ vads_order_id si vous l'avez transmise dansle formulaire de paiement.

Vérifiez que le statut de la commande n'a pas déjà été mis à jour.

2. Récupérez le résultat du paiement transmis dans le champ vads_trans_status.

Sa valeur vous permet de définir le statut de la commande.

VALEUR DESCRIPTION

AUTHORISED ValidéLa transaction est acceptée et sera remise en banqueautomatiquement à la date prévue.

AUTHORISED_TO_VALIDATE Revue manuelleLa transaction, créée en validation manuelle, est autorisée.Le marchand doit valider manuellement la transaction afinqu'elle soit remise en banque.La transaction peut être validée tant que la dated'expiration de la demande d'autorisation n’est pasdépassée. Si cette date est dépassée alors le paiementprend le statut EXPIRED. Le statut Expiré est définitif.

CANCELLED AnnuléLe paiement a été annulé par le marchand.

EXPIRED ExpiréLa date d'expiration de la demande d'autorisation estatteinte et le marchand n’a pas validé la transaction. Leporteur ne sera donc pas débité.

REFUSED RefuséLa transaction est refusée.Consultez le chapitre suivant pour obtenir plus de détail surle refus du paiement.

3. Récupérez la référence du paiement transmise dans le champ vads_trans_id.

4. Récupérez la référence unique de la transaction transmis dans le champ vads_trans_uuid.

5. Récupérez la référence de la transaction Paylib transmise dans le champ vads_ext_trans_id.

6. Récupérez la valeur du champ vads_trans_date pour identifier la date du paiement.

7. Récupérez le montant et la devise utilisée. Pour cela, récupérez les valeurs des champs suivants :

Nom du champ Description

vads_amount Montant du paiement dans sa plus petite unité monétaire.

vads_currency Code de la devise utilisée pour le paiement.



https://docs.lyra.com/fr/

8. Récupérez le moyen de paiement utilisé dans le wallet en analysant le champ vads_card_brand.

9. Vous pouvez enregistrer le type de wallet qui a servi pour le paiement en récupérant la valeur duchamp vads_wallet.

Valeur Type de wallet

PAYLIB Paylib

10.Récupérez toutes les informations concernant le détail de la commande, le détail de l'acheteur et ledétail de la livraison.

Ces données sont présentes dans la réponse que si elles ont été envoyées dans le formulaire depaiement.

Leur valeur est identique à celle soumise dans le formulaire.

11.Récupérez le détail de l'authentification Paylib :

Nom du champ Description

vads_threeds_cavv Identifiant unique généré par le serveur d'authentificationet prouvant que la transaction a bien été authentifiée.Ex : E6KUE9AF08ngABUBNAADcwAAAAA=

vads_threeds_cavvAlgorithm Méthode d'authentification du porteur de carte.Valeurs possibles :

• 00 : Aucune authentification

• 01 : Mot de passe rejouable (Date de naissance, mot depasse, code postal, ...)

• 02 : OTP Téléphone (SMS, SVI, Token, ...)

• 03 : OTP sur élément sécurisé Software (SEA, ...)

• 04 : OTP sur élément sécurisé Hardware (CAP, SIM, ...)

vads_threeds_exit_status Motif de la demande d'authentification.Valeurs possibles:

• 01: Pas d'authentification supplémentaire demandée(1ère utilisation)

• 02 : Le moteur de gestion des risques demande uneauthentification supplémentaire (1ère utilisation)

• 03 : Le moteur de gestion des risques est indisponible(1ère utilisation)

• 11 : Pas d'authentification supplémentaire demandée

• 12 : Le moteur de gestion des risques demande uneauthentification supplémentaire

• 13 : Le moteur de gestion des risques est indisponible

vads_threeds_xid Identifiant de transaction généré par le serveurd'authentification.Ex : MDM4MzIgICAgICAgICAgICAgICA=

12.Le statut de la garantie de paiement est transmis dans le champ vads_warranty_result.

13.Procédez à la mise à jour de la commande.



13.2. Analyser le résultat de la demande d'autorisation

Le résultat de l'autorisation est transmis dans le champ vads_auth_result.

Ci-dessous les valeurs pouvant être retournées lors d'un paiement Paylib :

Valeur Description Valeur Description

00 Transaction approuvée ou traitée avec succès 43 Carte volée

02 Contacter l’émetteur de carte 51 Provision insuffisante ou crédit dépassé

03 Accepteur invalide 54 Date de validité de la carte dépassée

04 Conserver la carte 55 Code confidentiel erroné

05 Ne pas honorer 56 Carte absente du fichier

07 Conserver la carte, conditions spéciales 57 Transaction non permise à ce porteur

08 Approuver après identification 58 Transaction non permise à ce porteur

12 Transaction invalide 59 Suspicion de fraude

13 Montant invalide 60 L’accepteur de carte doit contacter l’acquéreur

14 Numéro de porteur invalide 61 Montant de retrait hors limite

15 Emetteur de carte inconnu 63 Règles de sécurité non respectées

17 Annulation acheteur 68 Réponse non parvenue ou reçue trop tard

19 Répéter la transaction ultérieurement 75 Nombre d’essais code confidentiel dépassé

20 Réponse erronée (erreur dans le domaine serveur) 76 Porteur déjà en opposition, ancien enregistrementconservé

24 Mise à jour de fichier non supportée 80 Le paiement sans contact n'est pas admis parl'émetteur

25 Impossible de localiser l’enregistrement dans lefichier

81 Le paiement non sécurisé n'est pas admis parl'émetteur

26 Enregistrement dupliqué, ancien enregistrementremplacé

82 Révocation paiement récurrent pour la carte chezle commerçant ou pour le MCC et la carte

27 Erreur en « edit » sur champ de liste à jour fichier 83 Révocation tous paiements récurrents pour lacarte

28 Accès interdit au fichier 90 Arrêt momentané du système

29 Mise à jour impossible 91 Émetteur de cartes inaccessible

30 Erreur de format 94 Transaction dupliquée

31 Identifiant de l’organisme acquéreur inconnu 96 Mauvais fonctionnement du système

33 Date de validité de la carte dépassée 97 Échéance de la temporisation de surveillanceglobale

34 Suspicion de fraude 98 Serveur indisponible routage réseau demandé ànouveau

38 Date de validité de la carte dépassée 99 Incident domaine initiateur

41 Carte perdue



14. GÉRER LES TRANSACTIONS DEPUIS LE BACK OFFICE LYRACOLLECT

Les opérations sur les transactions doivent être réalisées depuis le Back Office Lyra Collect disponible àcette adresse : https://secure.lyra.com/portal/.

Cependant, si vous avez souscrit à une offre MarketPlace auprès de LyraCollect, vous devez utiliser l'APIMarketPlace.

14.1. Consulter le détail d'une transaction

Les transactions sont visibles dans le Back Office Lyra Collect depuis le menu Transactions.

Pour consulter le détail d'une transaction :

1. Recherchez la transaction Paylib concernée.

Vous pouvez affiner la recherche en :

• utilisant un filtre étendu sur le moyen de paiement,

• spécifiant la date du paiement ou le numéro de commande.

2. Cliquez sur le lien présent dans la colonne Numéro de commande.

L'onglet Transaction s'affiche par défaut. Parmi les informations présentées, vous trouverez :

• Le statut du paiement :

Statut Description

Annulé Le paiement a été annulé par le marchand.

Expiré Le paiement n'a pas été validé par le marchand dans les délais impartis.

Refusé Le paiement a été refusé.

Revue manuelle Le paiement est en attente de validation de la part du marchand.Sans validation de la part du marchand, le paiement expire une fois la datede remise atteinte.

Validé Le paiement a été accepté.




https://docs.lyra.com/fr/collect/marketplace/marketplace-webservices-REST/sitemap.html


• Le type de paiement :

• Unitaire dans le cadre d'un paiement.

• Remboursement dans le cadre d'un remboursement.

• Le montant de la transaction.

• Le numéro de transaction Lyra Collect.

L'onglet Client présente les données relatives à l'acheteur (adresse de facturation et de livraison)transmises dans votre requête de paiement.

L'onglet Commission vous indique le montant de la commission ainsi que le taux de TVA appliqués.



14.2. Effectuer un remboursement

Si vous avez souscrit à une offre MarketPlace auprès de LyraCollect, vous devez utiliser l'API MarketPlacepour rembourser vos transactions.

Pour initier une demande de remboursement depuis le Back Office Lyra Collect :

1. Affichez l'onglet Transactions.

2. Sélectionnez la transaction.

Cliquez sur l'icône Filtres ( ) pour rechercher la transaction concernée si elle ne figure pas sur la listedes transactions.

3. Affichez le menu contextuel.

Cliquez sur l'icône .

4. Cliquez sur le bouton Rembourser. La boîte de dialogue Demander le remboursement de cettetransaction s'affiche.

5. Renseignez le montant à rembourser. Le montant à rembourser ne peut être supérieur au montant dela transaction initiale.

6. Cliquez sur OK pour enregistrer la demande.



https://docs.lyra.com/fr/collect/marketplace/marketplace-webservices-REST/rembourser-un-paiement.html

14.3. Modifier une transaction

Si vous avez souscrit à une offre MarketPlace auprès de LyraCollect, vous devez utiliser l'API MarketPlacepour modifier vos transactions.

L'option Modifier est uniquement disponible pour les paiements ayant un statut :

• Revue manuelle

• Revue manuelle, autorisation en attente

• Autorisation en attente

• Validé, tant que la date de remise n'est pas atteinte.

Pour modifier une transaction Back Office Lyra Collect :






4. Cliquez sur le bouton Modifier.

5. Renseignez le nouveau montant.

Le nouveau montant doit être inférieur au montant initial.

6. Renseignez la nouvelle date de remise.




https://docs.lyra.com/fr/collect/marketplace/marketplace-webservices-REST/modifier-une-commande.html

14.4. Valider une transaction

Si vous avez souscrit à une offre MarketPlace auprès de LyraCollect, vous devez utiliser l'API MarketPlacepour valider vos transactions.

Le mode de validation est automatique pour les paiements immédiats.

En ce qui concerne les paiements différés, le marchand a la possibilité de choisir entre une validationmanuelle et automatique.

Si le marchand a opté pour une validation manuelle, il devra valider le paiement ultérieurement dans sonBack Office Lyra Collect.

Dans ce cas, la transaction aura comme statut :

• Revue manuelle si le délai de remise initial est inférieur à la durée de validation de l'autorisation,

• Revue manuelle, autorisation en attente si le délai de remise initial est supérieur à la durée devalidation de l'autorisation.

Pour valider une transaction depuis le Back Office Lyra Collect :

1. Affichez l'onglet Revue manuelle.





4. Cliquez sur le bouton Valider.


Après validation,

• le statut d’un paiement avec un délai de remise supérieur à la durée de validation de l'autorisation, estAutorisation en attente.

• le statut d’un paiement avec un délai de remise inférieur ou égal à la durée de validation de l'autorisationest Validé.




14.5. Annuler une transaction

Si vous avez souscrit à une offre MarketPlace auprès de LyraCollect, vous devez utiliser l'API MarketPlacepour annuler vos transactions.

L'opération Annuler est uniquement disponible pour les transactions n'ayant pas été remisées.

Pour annuler une transaction Back Office Lyra Collect :






4. Cliquez sur le bouton Annuler.


Après annulation, le statut du paiement devient Annulé




Documents

Guide d'implémentation · Renvoyer l'e-mail de confirmation de la transaction au marchand.....26 9.7. Effectuer un remboursement.....27 9.8. Dupliquer une transaction..... 27 9.9