Événements
| Événement | Envoyé lorsque |
|---|---|
| client.created | Un client est ajouté. |
| order.submitted | Une commande est passée. |
| order.approved | Une commande est approuvée. |
| order.settled | Une commande est réglée et les fractions sont émises. |
| distribution.approved | Une distribution est approuvée. |
| transfer.completed | Un transfert entre investisseurs est terminé. |
| message.received | Un client envoie un message. |
Les charges utiles contiennent des identifiants, des nombres et des montants, mais aucune donnée personnelle. Votre système récupère les détails avec une clé API.
Ajouter un point de terminaison
- Ouvrez Paramètres, puis Webhooks, et choisissez Ajouter un point de terminaison.
- Saisissez une adresse
httpsqui répond avec un statut 2xx en quelques secondes. Choisissez les événements. - Copiez le secret de signature. Il n’est affiché qu’une seule fois.
- Choisissez Envoyer un événement de test pour vérifier qu’il arrive bien.
- Seules les adresses
httpssur des hôtes publics sont acceptées. Les adresses pointant vers des réseaux privés ou internes sont refusées. - Les redirections ne sont pas suivies.
Vérifier la signature
Chaque livraison est une requête JSON POST avec les en-têtes EasyHaus-Event, EasyHaus-Delivery et EasyHaus-Signature. La signature se présente sous la forme t=<unix time>,v1=<hex>. Calculez un HMAC-SHA256 du texte <t>.<raw body> avec votre secret, comparez-le à v1 et rejetez les horodatages anciens.
Le corps est {id, type, created_at, organization_id, data}.
Nouvelles tentatives et désactivation
- Répondez dans un délai de 10 secondes. Une livraison échouée est retentée avec des délais croissants, jusqu’à 10 tentatives.
- Après 20 échecs consécutifs, le point de terminaison est désactivé et les propriétaires et administrateurs sont prévenus par e-mail. Corrigez-le, puis réactivez-le, ce qui remet le compteur à zéro.
- Le journal des livraisons affiche chaque livraison, son statut et son code HTTP, et vous permet de relivrer.
- Vous pouvez modifier les événements, désactiver un point de terminaison, renouveler le secret (l’ancien cesse immédiatement de fonctionner) ou le supprimer.