Présentation des webhooks

Qu'est-ce qu'un webhook ?

Les webhooks permettent aux applications de fournir des informations en temps réel dès qu'un événement se produit, sans avoir besoin d'envoyer des requêtes constantes. Il s'agit d'une méthode passive pour recevoir des données entre deux systèmes via une requête HTTP POST. Après avoir configuré les webhooks Yuno, vous recevrez des notifications d'événement chaque fois qu'une activité ou une fonction est générée dans le flux Yuno.

Pourquoi recommandons-nous l'utilisation des webhooks ?

Les webhooks sont le meilleur moyen de garantir que votre système est à jour en ce qui concerne la progression et le statut des paiements. Étant donné que les notifications d'événements se déclenchent automatiquement, votre système n'aura pas besoin d'effectuer des requêtes récurrentes à Yuno. Vous traiterez les informations de paiement à la demande.

Que devez-vous savoir avant de commencer à utiliser les webhooks ?

Pour commencer à utiliser les webhooks de Yuno, vous devez créer une API REST publique afin de recevoir les notifications d'événements (requête POST). Cela signifie que l'API REST que vous allez créer ne doit nécessiter aucune authentification ni restriction d'accès via un en-tête. Bien qu'il s'agisse d'une API publique, le système de communication est très sûr, car les notifications d'événements Yuno ne seront pas accessibles au public et utiliseront une URL unique pour communiquer uniquement avec votre API REST.

Exigences relatives à la livraison et à la réponse des webhooks

Yuno Webhooks attend un statut HTTP 200 OK en réponse pour confirmer que le webhook a bien été reçu. Le système marchand n'a pas besoin d'inclure d'informations dans le corps de la réponse. Seul le statut HTTP 200 est requis.

Si aucune réponse n'est reçue dans le délai spécifié, Yuno réessaiera d'envoyer la notification d'événement jusqu'à sept fois afin de s'assurer qu'aucune information n'est perdue. Reportez-vous à la section Processus de confirmation de réception pour plus de détails sur le calendrier des notifications et les délais d'attente pour la confirmation à chaque nouvelle tentative.