Webhooks

Webhooks notify your application in real-time when events occur in your Ikawaari account — payments, refunds, subscription changes, and more.

How Webhooks Work

1. You register a webhook endpoint URL in the dashboard or via API
2. When an event occurs, Ikawaari sends an HTTP POST to your URL
3. Your server processes the event and returns a 200 response
4. If delivery fails, Ikawaari retries with exponential backoff

Set Up a Webhook

From the Dashboard

Go to Developers → Webhooks and click Add endpoint.

Via 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"
    ]
  }'

Webhook Payload

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

Retry Policy

Attempt	Delay
1st retry	5 minutes
2nd retry	30 minutes
3rd retry	2 hours
4th retry	8 hours
5th retry	24 hours

After 5 failed attempts, the endpoint is marked as failing and you'll receive an email notification.

Next Steps

• Event Types — Full list of events
• Signature Verification — Verify webhook authenticity
• Best Practices — Production-ready webhook handling