Aperçu des webhooks

Qu'est-ce qu'un webhook ?

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

Pourquoi recommander l'utilisation de webhooks ?

Les Webhooks sont le meilleur moyen de s'assurer que votre système est à jour en ce qui concerne l'avancement et le statut des paiements. Comme les notifications d'événements se déclenchent automatiquement, votre système n'aura pas besoin d'effectuer des requêtes récurrentes auprès de Yuno. Vous traiterez les informations de paiement à la demande.

Que faut-il savoir avant de commencer à utiliser les webhooks ?

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

Exigences en matière de livraison et de réponse des webhooks

Yuno webhooks s'attend à recevoir un statut HTTP 200 OK comme réponse pour confirmer que le webhook a été reçu avec succès. 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éessaie d'envoyer la notification d'événement jusqu'à sept fois pour 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 de notification et les temps d'attente de confirmation pour chaque nouvelle tentative.