• France
lyra.com
Rechercher
Catégories
Tags
France
France
Espagne
Europe (Anglais)
Inde
Implémentation
Formulaire embarqué (cartes)
API REST
API REST PCI-DSS
API REST SEPA
Formulaire en redirection
Échange de fichiers
Paiement mobile
Exemples de code
Modules de paiement
Marketplace
Back Office
Back Office Marchand
Back Office Expert
Guides
Aide
FAQ
Tutoriels vidéos
Support

Utiliser des webhooks

Les webhooks vous permettent d'être automatiquement notifié lors du changement de statut d'un objet (commande, enregistrement, remboursement, etc.). En suivant son cycle de vie, vous êtes ainsi à même de réagir en déclenchant de nouveaux événements, de nouveaux appels, etc.

Typiquement: un webhook vous parvient lorsque les fonds d'une commande sont remisés sur le compte de règlement, à partir de quoi vous pouvez, si cela est convenu ainsi dans votre processus d'affaires, envoyer une information à votre sous-marchand pour valider la livraison.

Pour des raisons de sécurité, le webhook est réduit à sa plus simple expression, inexploitable en l'absence d'un accès authentifié à l'API. Il s'agit d'une requête POST dont le corps s'exprime de la manière suivante :

{"order":"dd5e4c4c-2c07-4af8-ae30-15f4c6d5b5e5"}

Il vous appartient, à la réception de ce webhook, d'interroger l'objet en question depuis la ressource correspondante mise à votre disposition, et de prendre ainsi connaissance du nouveau statut.

Exemple :

GET https://secure.lyra.com/orders/dd5e4c4c-2c07-4af8-ae30-15f4c6d5b5e5)

En temps normal, le webhook parvient au serveur de marketplace quelques secondes après la mutation de l'état. En cas d'erreur à l'envoi (réseau indisponible, par exemple), il peut être réexpédié jusqu'à deux fois supplémentaires, soit, trois fois en tout, à 15 minutes d'intervalle.

Le webhook n'est pas répété en cas d'erreur à la réception (par exemple: si votre serveur renvoie un statut 400, 404, 500, etc.). Pour éviter les erreurs les plus courantes, un contrôle d'envoi et de réception est effectué au moment de l'enregistrement du webhook.

Cette section vous présente donc comment :
  1. définir un (ou plusieurs) point d'accès;
  2. accéder aux webhooks accessibles, et ceux actuellement définis sur votre marketplace;
  3. enregistrer, modifier et supprimer vos webhooks.
  • Définir l'adresse du webhook
  • Accéder aux webhooks définis et accessibles sur votre marketplace
  • Enregistrer, modifier ou supprimer un webhook
Nous recrutons

Head Office :

LYRA NETWORK
109, rue de l’innovation
31670 Labège
FRANCE

2.8.1-doc-1.8