Webhooks

Les webhooks notifient votre application en temps réel lorsque des événements surviennent dans votre compte Ikawaari — paiements, remboursements, changements d’abonnement, etc.

Fonctionnement des webhooks

1. Vous enregistrez une URL d’endpoint webhook dans le dashboard ou via l’API
2. Lorsqu’un événement survient, Ikawaari envoie une requête HTTP POST à votre URL
3. Votre serveur traite l’événement et renvoie une réponse 200
4. Si la livraison échoue, Ikawaari réessaie avec un backoff exponentiel

Configurer un webhook

Depuis le dashboard

Allez dans Developers → Webhooks puis cliquez sur Add endpoint.

Via l’API

curl -X POST https://api.ikawaari.com/v1/webhooks \
  -H "Authorization: Bearer ik_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yoursite.com/webhooks/ikawaari",
    "events": [
      "payment_intent.succeeded",
      "payment_intent.payment_failed",
      "invoice.paid"
    ]
  }'

Payload webhook

{
  "id": "evt_abc123",
  "type": "payment_intent.succeeded",
  "created": 1708300800,
  "data": {
    "id": "pi_xyz789",
    "object": "payment_intent",
    "amount": 10000,
    "currency": "xof",
    "status": "succeeded"
  }
}

Politique de retry

Tentative	Délai
1er retry	5 minutes
2e retry	30 minutes
3e retry	2 heures
4e retry	8 heures
5e retry	24 heures

Après 5 tentatives échouées, l’endpoint est marqué comme défaillant et vous recevez une notification par email.

Étapes suivantes

• Types d’événements — Liste complète des événements
• Vérification de signature — Vérifier l’authenticité des webhooks
• Bonnes pratiques — Gestion des webhooks prête pour la production