[{"data":1,"prerenderedAt":603},["ShallowReactive",2],{"\u002Fnext\u002Fintegrations\u002Fpayments\u002Flyra":3,"section:\u002Fnext\u002Fintegrations\u002Fpayments\u002Flyra":602},{"id":4,"title":5,"body":6,"description":580,"extension":581,"meta":582,"navigation":584,"path":598,"seo":599,"stem":600,"__hash__":601},"docs\u002F2.next\u002F4.integrations\u002F01.payments\u002F7.lyra.md","Lyra",{"type":7,"value":8,"toc":559},"minimark",[9,13,20,36,41,61,64,68,96,100,254,260,264,267,298,302,320,326,331,334,338,345,349,356,359,363,395,402,412,424,427,431,434,456,462,466,481,485,507,511],[10,11,5],"h1",{"id":12},"lyra",[14,15,16],"blockquote",{},[17,18,19],"p",{},"S'applique à : Dokos next. L'intégration Lyra n'existe pas en v5.",[17,21,22,23,27,28,31,32,35],{},"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 : ",[24,25,26],"strong",{},"Lyra Collect",", ",[24,29,30],{},"PayZen"," et ",[24,33,34],{},"Systempay",". Seule l'adresse de l'API change.",[37,38,40],"h2",{"id":39},"ce-que-lintégration-permet","Ce que l'intégration permet",[42,43,44,52,55,58],"ul",{},[45,46,47,48,51],"li",{},"Payer une ",[24,49,50],{},"Demande de paiement"," liée à une commande client ou une facture de vente, par un lien de paiement.",[45,53,54],{},"Enregistrer la carte du client lors du paiement d'un abonnement, puis payer les échéances suivantes sans action du client.",[45,56,57],{},"Rembourser un paiement depuis l'écriture de paiement.",[45,59,60],{},"Comptabiliser chaque virement de Lyra et ses frais à partir du fichier de règlement JRFI.",[17,62,63],{},"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.",[37,65,67],{"id":66},"prérequis","Prérequis",[42,69,70,73,80,87],{},[45,71,72],{},"Un contrat Lyra Collect, PayZen ou Systempay actif.",[45,74,75,76,79],{},"Un accès au ",[24,77,78],{},"Back Office Expert"," de Lyra. Vous l'ouvrez depuis le Back Office Marchand.",[45,81,82,83,86],{},"L'identifiant de la boutique et les mots de passe de l'API REST, de test et de production. Dans le Back Office Expert : ",[24,84,85],{},"Paramétrage > Boutique > Clés d'API REST",". Si l'onglet n'est pas visible, demandez son activation à Lyra.",[45,88,89,90,95],{},"Pour comptabiliser les virements automatiquement : l'application ",[91,92,94],"a",{"href":93},"\u002Fnext\u002Fapplications\u002Fdokos-data-hub","Dokos Data Hub"," installée sur le site, et l'accès SFTP aux fichiers de règlement, que vous demandez à Lyra.",[37,97,99],{"id":98},"configurer-lyra","Configurer Lyra",[101,102,103,110,126,183,189,215,221],"ol",{},[45,104,105,106,109],{},"Ouvrez la liste ",[24,107,108],{},"Paramètres Lyra"," et créez un document.",[45,111,112,113,116,117,121,122,125],{},"Renseignez le ",[24,114,115],{},"Nom de la passerelle de paiement",", par exemple ",[118,119,120],"code",{},"Boutique",". Dokos crée la passerelle ",[24,123,124],{},"Lyra-Boutique",".",[45,127,128,129,132,133,136,137],{},"Dans la section ",[24,130,131],{},"Plateforme",", renseignez l'",[24,134,135],{},"URL de base de l'API"," de votre plateforme :",[138,139,140,151],"table",{},[141,142,143],"thead",{},[144,145,146,149],"tr",{},[147,148,131],"th",{},[147,150,135],{},[152,153,154,165,174],"tbody",{},[144,155,156,159],{},[157,158,26],"td",{},[157,160,161,164],{},[118,162,163],{},"https:\u002F\u002Fapi.lyra.com"," (valeur par défaut)",[144,166,167,169],{},[157,168,30],{},[157,170,171],{},[118,172,173],{},"https:\u002F\u002Fapi.payzen.eu",[144,175,176,178],{},[157,177,34],{},[157,179,180],{},[118,181,182],{},"https:\u002F\u002Fapi.systempay.fr",[45,184,185,186,125],{},"Saisissez l'",[24,187,188],{},"Identifiant de boutique",[45,190,128,191,194,195,198,199,202,203,206,207,210,211,214],{},[24,192,193],{},"Mode & Identifiants",", choisissez le ",[24,196,197],{},"Mode"," : ",[118,200,201],{},"Test"," ou ",[118,204,205],{},"Production",". Saisissez le ",[24,208,209],{},"Mot de passe Test"," et le ",[24,212,213],{},"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.",[45,216,217,218,125],{},"Enregistrez. Dokos remplit l'",[24,219,220],{},"URL de notification (IPN)",[45,222,128,223,226,227,230,231,234,235,238,239,210,242,245,246,31,250,125],{},[24,224,225],{},"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 ",[24,228,229],{},"Compte par défaut"," (votre banque), le ",[24,232,233],{},"Clearing Account"," (compte d'attente), le ",[24,236,237],{},"Compte de frais",", le ",[24,240,241],{},"Compte de taxes",[24,243,244],{},"Centre de coûts",". Voir ",[91,247,249],{"href":248},"\u002Fnext\u002Fintegrations\u002Fpayments","Configurer une passerelle",[91,251,253],{"href":252},"\u002Fnext\u002Fdokos\u002Fcomptabilite\u002Fpasserelles-paiements#passerelles-v2-compte-dattente","Passerelles de paiement",[17,255,256,257,259],{},"Pour passer en production, choisissez le mode ",[118,258,205],{}," et enregistrez.",[37,261,263],{"id":262},"recevoir-les-notifications-de-lyra-ipn","Recevoir les notifications de Lyra (IPN)",[17,265,266],{},"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.",[101,268,269,278,285,288,291],{},[45,270,271,272,274,275,125],{},"Dans les ",[24,273,108],{},", cliquez sur ",[24,276,277],{},"Notifications > Copier l'URL de notification",[45,279,280,281,284],{},"Dans le Back Office Expert, ouvrez ",[24,282,283],{},"Paramétrage > Règles de notifications",", puis la règle « URL de notification à la fin du paiement ».",[45,286,287],{},"Collez l'URL dans la section de l'API REST, pour le mode test et pour le mode production. Activez le rejeu automatique.",[45,289,290],{},"Ajoutez la condition « Ordre de paiement ». Pour les liens de paiement, Lyra n'envoie pas la notification par défaut.",[45,292,293,294,297],{},"Si votre site filtre le trafic entrant, autorisez la plage d'adresses ",[118,295,296],{},"194.50.38.0\u002F24"," de Lyra, en HTTPS.",[37,299,301],{"id":300},"le-parcours-de-paiement","Le parcours de paiement",[101,303,304,307,310,313],{},[45,305,306],{},"Vous créez une demande de paiement avec la passerelle Lyra. Dokos envoie le lien au client.",[45,308,309],{},"Le client ouvre le lien. Dokos crée un ordre de paiement chez Lyra et redirige le client vers la page de paiement Lyra.",[45,311,312],{},"Le client paie. Lyra le renvoie automatiquement sur votre site.",[45,314,315,316,319],{},"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 à ",[24,317,318],{},"Payé"," et Dokos crée l'écriture de paiement au montant brut, sur le compte d'attente.",[17,321,322,323,125],{},"Chaque tentative de paiement est suivie dans le ",[24,324,325],{},"Journal des sessions de paiement",[327,328,330],"h3",{"id":329},"abonnements","Abonnements",[17,332,333],{},"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.",[327,335,337],{"id":336},"remboursements","Remboursements",[17,339,340,341,344],{},"Sur l'écriture de paiement d'un paiement Lyra, cliquez sur ",[24,342,343],{},"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.",[37,346,348],{"id":347},"comptabiliser-les-virements-de-lyra","Comptabiliser les virements de Lyra",[17,350,351,352,355],{},"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 ",[24,353,354],{},"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.",[17,357,358],{},"Vous avez deux façons de charger les fichiers.",[327,360,362],{"id":361},"récupération-automatique-dokos-data-hub","Récupération automatique (Dokos Data Hub)",[101,364,365,368,379],{},[45,366,367],{},"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.",[45,369,271,370,372,373,274,376,125],{},[24,371,108],{},", dans le tableau de bord ",[24,374,375],{},"Récupération des règlements",[24,377,378],{},"Configurer la récupération des règlements",[45,380,185,381,238,384,210,387,390,391,394],{},[24,382,383],{},"Hôte SFTP",[24,385,386],{},"Nom d’utilisateur",[24,388,389],{},"Mot de passe",", puis cliquez sur ",[24,392,393],{},"Tester et enregistrer",". Dokos teste la connexion avant d'enregistrer.",[17,396,397,398,401],{},"Dokos crée une ",[24,399,400],{},"DDH Connection"," qui récupère les fichiers chaque nuit. Le lendemain, Dokos comptabilise chaque virement.",[17,403,404,405,407,408,411],{},"Le tableau de bord ",[24,406,375],{}," 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 ",[24,409,410],{},"Modifier les identifiants",". Laissez le mot de passe vide pour garder le mot de passe enregistré.",[413,414,417],"callout",{"color":415,"icon":416},"amber","i-heroicons-exclamation-triangle",[17,418,419,420,423],{},"Lyra garde un fichier de règlement non compressé pendant 7 jours. Après ce délai, la récupération automatique ne le trouve plus : importez-le à la main. Si les comptes du mode de paiement ne sont pas renseignés, les fichiers restent en attente. Après deux jours d'attente, Dokos crée un ",[24,421,422],{},"Problème de rapprochement de paiement"," qui nomme les comptes manquants.",[17,425,426],{},"Ne liez pas de mapping Dokos Data Hub à cette connexion. Sinon, les fichiers ne sont plus comptabilisés.",[327,428,430],{"id":429},"import-manuel","Import manuel",[17,432,433],{},"Sans Dokos Data Hub, ou pour un fichier de plus de 7 jours :",[101,435,436,439,446],{},[45,437,438],{},"Téléchargez le fichier JRFI du virement depuis Lyra.",[45,440,271,441,274,443,125],{},[24,442,108],{},[24,444,445],{},"Paiements > Importer le fichier de règlement (JRFI)",[45,447,448,449,452,453,125],{},"Joignez le ",[24,450,451],{},"Fichier JRFI"," et cliquez sur ",[24,454,455],{},"Importer",[17,457,458,459,461],{},"Dokos crée le ",[24,460,354],{}," et indique le nombre de lignes rapprochées avec un paiement. Un virement déjà importé n'est pas importé une seconde fois.",[37,463,465],{"id":464},"exemple","Exemple",[17,467,468,469,471,472,474,475,477,478,480],{},"La boutique Atelier Lumière (exemple fictif) utilise PayZen. L'administrateur crée les ",[24,470,108],{}," ",[118,473,120],{},", avec l'URL ",[118,476,173],{},", 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 ",[24,479,354],{}," et solde le compte d'attente.",[37,482,484],{"id":483},"tester","Tester",[101,486,487,495,498],{},[45,488,489,490,492,493,125],{},"Choisissez le mode ",[118,491,201],{}," et saisissez le ",[24,494,209],{},[45,496,497],{},"Créez une commande client ou une facture de vente, puis une demande de paiement avec la passerelle Lyra.",[45,499,500,501,125],{},"Ouvrez le lien de paiement dans une fenêtre de navigation privée. Payez avec une ",[91,502,506],{"href":503,"rel":504},"https:\u002F\u002Fdocs.lyra.com\u002Ffr\u002Frest\u002FV4.0\u002Fapi\u002Fkb\u002Ftest_cards.html",[505],"nofollow","carte de test Lyra",[37,508,510],{"id":509},"problèmes-fréquents","Problèmes fréquents",[138,512,513,523],{},[141,514,515],{},[144,516,517,520],{},[147,518,519],{},"Message ou symptôme",[147,521,522],{},"Cause",[152,524,525,533,541,551],{},[144,526,527,530],{},[157,528,529],{},"« Le mot de passe est requis lorsque la passerelle est en mode {0}. »",[157,531,532],{},"Le mot de passe du mode choisi est vide.",[144,534,535,538],{},[157,536,537],{},"La demande de paiement reste en attente",[157,539,540],{},"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.",[144,542,543,546],{},[157,544,545],{},"Les fichiers de règlement restent en attente",[157,547,548,549,125],{},"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 ",[24,550,375],{},[144,552,553,556],{},[157,554,555],{},"Le fichier n'est plus récupéré",[157,557,558],{},"Il a plus de 7 jours. Importez-le à la main.",{"title":560,"searchDepth":561,"depth":562,"links":563},"",1,2,[564,565,566,567,568,573,577,578,579],{"id":39,"depth":562,"text":40},{"id":66,"depth":562,"text":67},{"id":98,"depth":562,"text":99},{"id":262,"depth":562,"text":263},{"id":300,"depth":562,"text":301,"children":569},[570,572],{"id":329,"depth":571,"text":330},3,{"id":336,"depth":571,"text":337},{"id":347,"depth":562,"text":348,"children":574},[575,576],{"id":361,"depth":571,"text":362},{"id":429,"depth":571,"text":430},{"id":464,"depth":562,"text":465},{"id":483,"depth":562,"text":484},{"id":509,"depth":562,"text":510},"Encaisser des paiements par carte avec Lyra (Lyra Collect, PayZen, Systempay) par lien de paiement, et comptabiliser les virements de Lyra à partir des fichiers de règlement JRFI.","md",{"icon":583,"reviewed":584,"last_verified":585,"sources":586},"i-lucide-credit-card",true,"2026-11-02",[587,588,589,590,591,592,593,594,595,596,597],"payments@develop:payments\u002Fpayment_gateways\u002Fdoctype\u002Flyra_settings\u002Flyra_settings.json","payments@develop:payments\u002Fpayment_gateways\u002Fdoctype\u002Flyra_settings\u002Flyra_settings.py","payments@develop:payments\u002Fpayment_gateways\u002Fdoctype\u002Flyra_settings\u002Flyra_settings.js","payments@develop:payments\u002Fpayment_gateways\u002Fdoctype\u002Flyra_settings\u002Flyra_controller.py","payments@develop:payments\u002Fpayment_gateways\u002Fdoctype\u002Flyra_settings\u002FREADME.md","payments@develop:payments\u002Futils\u002Futils.py","payments@develop:payments\u002Fhooks.py","payments@develop:payments\u002Fpayouts.py","payments@develop:payments\u002Fpublic\u002Fjs\u002Fpayment_entry.js","payments@develop:payments\u002Flocale\u002Ffr.po","https:\u002F\u002Fdocs.lyra.com\u002Ffr\u002Frest\u002FV4.0\u002Fapi","\u002Fnext\u002Fintegrations\u002Fpayments\u002Flyra",{"title":5,"description":580},"2.next\u002F4.integrations\u002F01.payments\u002F7.lyra","7aLy43RKH9E0J2J0BgFNwLbpTGygAilwN2uJyUQeizY",{},1795274712554]