Referensi API

Webhook Events

React to network events as they happen.

Subscribe to webhook events to keep your systems in sync without polling. FOODS signs every payload so you can verify authenticity. Events fire across the order and settlement lifecycle.

Kemampuan

Subscribe to lifecycle events
Verify signed payloads
Automatic retries with backoff
Replay recent events from the dashboard

Endpoint

POST/v1/webhook_endpoints

GET/v1/webhook_endpoints

List your endpoints

DELETE/v1/webhook_endpoints/{id}

Remove an endpoint

Example event payload

Permintaan

// Events you can subscribe to
order.created
order.assigned
order.picked_up
order.delivered
order.cancelled
settlement.paid

Respons · 200 OK

{
  "id": "evt_5Tg9",
  "type": "order.delivered",
  "created": "2026-06-13T11:02:55Z",
  "data": {
    "order_id": "ord_8Kd2",
    "rider_id": "rdr_19f3",
    "delivered_at": "2026-06-13T11:02:50Z",
    "payout": { "currency": "NGN", "amount": 850 }
  }
}

Webhook Events

Endpoint

Example event payload

Siap berintegrasi?