> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fooddelivery.cl/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Próximamente: recibe eventos de pedidos en tu servidor

<Warning>
  **Aún no disponible.** Los webhooks están en el roadmap de la API pública;
  esta página describe el diseño propuesto y puede cambiar. Mientras tanto,
  consulta pedidos nuevos con polling a `GET /orders` (pestaña **API Pedidos
  y Menú**) usando el parámetro `from`.
</Warning>

Podrás configurar una URL y FoodDelivery enviará un `POST` JSON cada vez que
ocurra un evento suscrito.

## Eventos propuestos

| Evento                 | Cuándo se dispararía                                                                           |
| ---------------------- | ---------------------------------------------------------------------------------------------- |
| `order.created`        | Entra un pedido nuevo (pagado o por pagar en local)                                            |
| `order.status_changed` | El pedido cambia de estado (recibido, en preparación, listo, en reparto, entregado, cancelado) |
| `delivery.updated`     | Cambia el estado del despacho o los datos del repartidor                                       |

## Formato del payload (propuesto)

```json theme={null}
{
  "event": "order.created",
  "created_at": "2026-07-15T13:05:22+00:00",
  "data": {
    "order": {
      "id": "a1b2c3d4-...",
      "number": "#0041-150726",
      "status": "recibido",
      "total": 15990
    }
  }
}
```

## Firma (propuesta)

Cada request incluiría el header `X-FoodDelivery-Signature`: HMAC-SHA256 del
cuerpo crudo, usando un webhook secret que se mostrará al configurar la URL.

¿Necesitas webhooks para tu integración? Escríbenos y priorizamos según
demanda.