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.

功能

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

端点

POST/v1/webhook_endpoints

GET/v1/webhook_endpoints

List your endpoints

DELETE/v1/webhook_endpoints/{id}

Remove an endpoint

Example event payload

请求

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

响应 · 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

端点

Example event payload

准备好对接了吗？