Referința 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.
Funcționalități
- Subscribe to lifecycle events
- Verify signed payloads
- Automatic retries with backoff
- Replay recent events from the dashboard
Endpoint-uri
POST
/v1/webhook_endpointsRegister a webhook endpoint
GET
/v1/webhook_endpointsList your endpoints
DELETE
/v1/webhook_endpoints/{id}Remove an endpoint
Example event payload
Cerere
// Events you can subscribe to
order.created
order.assigned
order.picked_up
order.delivered
order.cancelled
settlement.paidRăspuns · 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 }
}
}