Webhooks

Les événements

• Partenaires : créé, mis à jour, supprimé, statut changé, niveau changé, responsable changé.
• Moyens de paiement : créé, mis à jour.
• Demandes de formulaire : créée, mise à jour, supprimée.
• Conversions : créée, mise à jour, statut changé.
• Règlements et paiements : règlement créé, statut de paiement changé.
• Offres : créée, mise à jour, supprimée ; accès accordé, accès retiré.
• Postbacks : échoué.
• Marques blanches : créée, mise à jour, supprimée.

En créer un

1. Paramètres › Développeurs › Webhooks › Nouveau webhook : l’URL de votre point d’accès et les événements.
2. Envoyer seulement si (facultatif) : des règles sur les champs de l’enregistrement, toutes ou l’une d’elles, comparées à une valeur, une liste ou un autre champ.
3. Quoi envoyer : Compatible (formes courtes qu’attend une intégration existante) ou Enregistrement complet (chaque champ, avec valeurs avant et après pour les changements). L’exemple se met à jour selon votre choix.
4. Des en-têtes supplémentaires, si votre point d’accès en a besoin.

Vérifier la signature

Chaque appel a un en-tête Signature : le HMAC-SHA256 du corps avec le secret de signature de votre webhook. Le secret est affiché une fois à la création du webhook ; Nouveau secret le remplace.

Envois

• Un appel auquel votre serveur ne répond pas bien est retenté.
• Le journal d’envoi montre chaque appel, ses tentatives et ce qui a été envoyé ; Renvoyer en répète un.
• Envoyer un test envoie un événement avec votre dernier enregistrement réel (ou un exemple).
• Après 20 échecs d’affilée, le webhook se met en pause et vous recevez une alerte. Réparez le point d’accès, puis Reprendre.