Lyra
Lyra
S'applique à : Dokos next. L'intégration Lyra n'existe pas en v5.
L'intégration Lyra encaisse des paiements par carte sur une page de paiement hébergée par Lyra. Elle sert aux trois plateformes de Lyra : Lyra Collect, PayZen et Systempay. Seule l'adresse de l'API change.
Ce que l'intégration permet
- Payer une Demande de paiement liée à une commande client ou une facture de vente, par un lien de paiement.
- Enregistrer la carte du client lors du paiement d'un abonnement, puis payer les échéances suivantes sans action du client.
- Rembourser un paiement depuis l'écriture de paiement.
- Comptabiliser chaque virement de Lyra et ses frais à partir du fichier de règlement JRFI.
Aucune donnée de carte n'est enregistrée dans Dokos. Pour un abonnement, Dokos garde seulement l'identifiant de la carte enregistrée chez Lyra, dans la fiche client.
Prérequis
- Un contrat Lyra Collect, PayZen ou Systempay actif.
- Un accès au Back Office Expert de Lyra. Vous l'ouvrez depuis le Back Office Marchand.
- L'identifiant de la boutique et les mots de passe de l'API REST, de test et de production. Dans le Back Office Expert : Paramétrage > Boutique > Clés d'API REST. Si l'onglet n'est pas visible, demandez son activation à Lyra.
- Pour comptabiliser les virements automatiquement : l'application Dokos Data Hub installée sur le site, et l'accès SFTP aux fichiers de règlement, que vous demandez à Lyra.
Configurer Lyra
- Ouvrez la liste Paramètres Lyra et créez un document.
- Renseignez le Nom de la passerelle de paiement, par exemple
Boutique. Dokos crée la passerelle Lyra-Boutique. - Dans la section Plateforme, renseignez l'URL de base de l'API de votre plateforme :
Plateforme URL de base de l'API Lyra Collect https://api.lyra.com(valeur par défaut)PayZen https://api.payzen.euSystempay https://api.systempay.fr - Saisissez l'Identifiant de boutique.
- Dans la section Mode & Identifiants, choisissez le Mode :
TestouProduction. Saisissez le Mot de passe Test et le Mot de passe Production. Le mot de passe du mode choisi est obligatoire. Dokos s'en sert aussi pour vérifier la signature des notifications de Lyra. - Enregistrez. Dokos remplit l'URL de notification (IPN).
- Dans la section Configuration du paiement, ajoutez un compte de paiement et un mode de paiement pour chaque société. Sur la ligne du mode de paiement, renseignez le Compte par défaut (votre banque), le Clearing Account (compte d'attente), le Compte de frais, le Compte de taxes et le Centre de coûts. Voir Configurer une passerelle et Passerelles de paiement.
Pour passer en production, choisissez le mode Production et enregistrez.
Recevoir les notifications de Lyra (IPN)
Les notifications sont recommandées, mais pas obligatoires. Sans elles, Dokos interroge Lyra à intervalles réguliers et finit par connaître le résultat du paiement. Avec elles, la demande de paiement est mise à jour plus vite.
- Dans les Paramètres Lyra, cliquez sur Notifications > Copier l'URL de notification.
- Dans le Back Office Expert, ouvrez Paramétrage > Règles de notifications, puis la règle « URL de notification à la fin du paiement ».
- Collez l'URL dans la section de l'API REST, pour le mode test et pour le mode production. Activez le rejeu automatique.
- Ajoutez la condition « Ordre de paiement ». Pour les liens de paiement, Lyra n'envoie pas la notification par défaut.
- Si votre site filtre le trafic entrant, autorisez la plage d'adresses
194.50.38.0/24de Lyra, en HTTPS.
Le parcours de paiement
- Vous créez une demande de paiement avec la passerelle Lyra. Dokos envoie le lien au client.
- Le client ouvre le lien. Dokos crée un ordre de paiement chez Lyra et redirige le client vers la page de paiement Lyra.
- Le client paie. Lyra le renvoie automatiquement sur votre site.
- Dokos demande le résultat à Lyra. Il ne se fie pas au retour du navigateur. Si le paiement est accepté, la demande de paiement passe à Payé et Dokos crée l'écriture de paiement au montant brut, sur le compte d'attente.
Chaque tentative de paiement est suivie dans le Journal des sessions de paiement.
Abonnements
Si la demande de paiement appartient à un abonnement, le paiement enregistre aussi la carte du client chez Lyra. Les échéances suivantes sont débitées sur cette carte, sans page de paiement. Un refus de la banque sur une échéance est définitif : envoyez une nouvelle demande de paiement au client.
Remboursements
Sur l'écriture de paiement d'un paiement Lyra, cliquez sur Remboursement et confirmez. Dokos crée un avoir et demande le remboursement à Lyra. Si le paiement n'est pas encore remis en banque, Lyra l'annule au lieu de le rembourser.
Comptabiliser les virements de Lyra
Lyra verse les fonds par virement bancaire. Pour chaque virement, Lyra produit un fichier de règlement JRFI. Il donne les paiements réglés et les frais, hors taxes et TVA. Dokos crée un Versement à partir de ce fichier. À sa validation, Dokos passe une écriture de journal : la banque au montant net, les frais et leur TVA, et le solde du compte d'attente.
Vous avez deux façons de charger les fichiers.
Récupération automatique (Dokos Data Hub)
- Demandez à Lyra l'activation de l'accès SFTP aux fichiers de règlement. Lyra vous envoie l'hôte, le nom d'utilisateur et le mot de passe.
- Dans les Paramètres Lyra, dans le tableau de bord Récupération des règlements, cliquez sur Configurer la récupération des règlements.
- Saisissez l'Hôte SFTP, le Nom d’utilisateur et le Mot de passe, puis cliquez sur Tester et enregistrer. Dokos teste la connexion avant d'enregistrer.
Dokos crée une DDH Connection qui récupère les fichiers chaque nuit. Le lendemain, Dokos comptabilise chaque virement.
Le tableau de bord Récupération des règlements montre l'état du flux : connexion activée, dernière récupération, fichiers en attente, comptes prêts et fichiers en échec. Pour changer les identifiants SFTP, cliquez sur Modifier les identifiants. Laissez le mot de passe vide pour garder le mot de passe enregistré.
Ne liez pas de mapping Dokos Data Hub à cette connexion. Sinon, les fichiers ne sont plus comptabilisés.
Import manuel
Sans Dokos Data Hub, ou pour un fichier de plus de 7 jours :
- Téléchargez le fichier JRFI du virement depuis Lyra.
- Dans les Paramètres Lyra, cliquez sur Paiements > Importer le fichier de règlement (JRFI).
- Joignez le Fichier JRFI et cliquez sur Importer.
Dokos crée le Versement et indique le nombre de lignes rapprochées avec un paiement. Un virement déjà importé n'est pas importé une seconde fois.
Exemple
La boutique Atelier Lumière (exemple fictif) utilise PayZen. L'administrateur crée les Paramètres Lyra Boutique, avec l'URL https://api.payzen.eu, l'identifiant de boutique et le mot de passe de test. Il colle l'URL de notification dans le Back Office Expert. Un client paie une facture de 80 € par le lien reçu. Dokos passe 80 € sur le compte d'attente. Trois jours plus tard, PayZen vire le net sur la banque. Le lendemain, Dokos lit le fichier de règlement, crée le Versement et solde le compte d'attente.
Tester
- Choisissez le mode
Testet saisissez le Mot de passe Test. - Créez une commande client ou une facture de vente, puis une demande de paiement avec la passerelle Lyra.
- Ouvrez le lien de paiement dans une fenêtre de navigation privée. Payez avec une carte de test Lyra.
Problèmes fréquents
| Message ou symptôme | Cause |
|---|---|
| « Le mot de passe est requis lorsque la passerelle est en mode {0}. » | Le mot de passe du mode choisi est vide. |
| La demande de paiement reste en attente | Lyra n'a pas encore donné de résultat. Sans notification, Dokos interroge Lyra plus tard. Vérifiez la règle de notification dans le Back Office Expert. |
| Les fichiers de règlement restent en attente | Les comptes du mode de paiement Lyra ne sont pas renseignés, ou un mapping est lié à la DDH Connection. Regardez le tableau de bord Récupération des règlements. |
| Le fichier n'est plus récupéré | Il a plus de 7 jours. Importez-le à la main. |