{
"id": "evt_9pQ2vX7mKdR4tYb1nZ3sLwCe",
"created_at": "2026-07-28T18:41:03Z",
"type": "delivery.status_changed",
"data": {
"id": "dlv_7hK2mQ9xR4tV6bN1cZ8sLwYe",
"external_id": "order-841",
"origin": "api",
"code": "LS-2048",
"store_id": "<string>",
"test": true,
"payment": {
"url": "<string>",
"cash_to_collect_cents": 123,
"paid_at": "2023-11-07T05:31:56Z"
},
"order_value_cents": 123,
"fee_cents": 123,
"business_fee_cents": 123,
"customer_fee_cents": 123,
"tip_cents": 123,
"currency": "MXN",
"quote_id": "<string>",
"pickup": {
"name": "<string>",
"street": "<string>",
"lat": 123,
"lng": 123,
"notes": "<string>"
},
"dropoff": {
"name": "<string>",
"phone": "+528112345678",
"street": "<string>",
"apt_unit": "<string>",
"lat": 123,
"lng": 123,
"notes": "<string>"
},
"manifest": {
"items": [
{
"name": "<string>",
"quantity": 123
}
]
},
"vehicle": "moto",
"courier": {
"name": "<string>",
"vehicle": "<string>",
"vehicle_type": "<string>",
"plate": "<string>",
"phone": {
"masked": "<string>",
"pin": "<string>"
},
"location": {
"lat": 123,
"lng": 123,
"updated_at": "2023-11-07T05:31:56Z"
},
"imminent": true
},
"pickup_eta_at": "2023-11-07T05:31:56Z",
"dropoff_eta_at": "2023-11-07T05:31:56Z",
"tracking_url": "https://app.listo.delivery/t/abc123",
"verification": {
"pincode": "<string>"
},
"return_verification": {
"pincode": "4821"
},
"proof": {
"picture_url": "<string>",
"signature_image_url": "<string>",
"signature_name": "<string>",
"captured_at": "2023-11-07T05:31:56Z"
},
"proofs": {
"pickup": {
"photo_url": "<string>",
"captured_at": "2023-11-07T05:31:56Z"
},
"dropoff": {
"photo_url": "<string>",
"signature_url": "<string>",
"signer_name": "<string>",
"captured_at": "2023-11-07T05:31:56Z",
"delivered": true
},
"return": {
"photo_url": "<string>",
"signature_url": "<string>",
"signer_name": "<string>",
"captured_at": "2023-11-07T05:31:56Z",
"meters_from_store": 123
}
},
"cancellation": {
"description": "<string>"
},
"charges": [
{
"amount_cents": 123,
"charged_at": "2023-11-07T05:31:56Z"
}
],
"refunds": [
{
"id": "rfn_4bQ7wS2xK9mT6vN3cZ8pLdYe",
"amount_cents": 123,
"reason": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"succeeded_at": "2023-11-07T05:31:56Z"
}
],
"refunded_cents": 123,
"refundable_cents": 123,
"support_reference": "2080F",
"pickup_ready_at": "2023-11-07T05:31:56Z",
"requested_at": "2023-11-07T05:31:56Z",
"courier_assigned_at": "2023-11-07T05:31:56Z",
"picked_up_at": "2023-11-07T05:31:56Z",
"delivered_at": "2023-11-07T05:31:56Z",
"canceled_at": "2023-11-07T05:31:56Z",
"returned_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
},
"test": true
}A delivery reached a new status
Se envía en cada transición de estado, incluidas las que tú no causaste: un repartidor que acepta el pedido, un pago con tarjeta que se acredita, un despacho que falla, o un repartidor o nuestra plataforma que cancela el viaje.
data es el objeto de envío completo, con la misma forma que devuelven los endpoints REST, así que una integración que guardó una respuesta de creación puede compararla con este campo por campo.
{
"id": "evt_9pQ2vX7mKdR4tYb1nZ3sLwCe",
"created_at": "2026-07-28T18:41:03Z",
"type": "delivery.status_changed",
"data": {
"id": "dlv_7hK2mQ9xR4tV6bN1cZ8sLwYe",
"external_id": "order-841",
"origin": "api",
"code": "LS-2048",
"store_id": "<string>",
"test": true,
"payment": {
"url": "<string>",
"cash_to_collect_cents": 123,
"paid_at": "2023-11-07T05:31:56Z"
},
"order_value_cents": 123,
"fee_cents": 123,
"business_fee_cents": 123,
"customer_fee_cents": 123,
"tip_cents": 123,
"currency": "MXN",
"quote_id": "<string>",
"pickup": {
"name": "<string>",
"street": "<string>",
"lat": 123,
"lng": 123,
"notes": "<string>"
},
"dropoff": {
"name": "<string>",
"phone": "+528112345678",
"street": "<string>",
"apt_unit": "<string>",
"lat": 123,
"lng": 123,
"notes": "<string>"
},
"manifest": {
"items": [
{
"name": "<string>",
"quantity": 123
}
]
},
"vehicle": "moto",
"courier": {
"name": "<string>",
"vehicle": "<string>",
"vehicle_type": "<string>",
"plate": "<string>",
"phone": {
"masked": "<string>",
"pin": "<string>"
},
"location": {
"lat": 123,
"lng": 123,
"updated_at": "2023-11-07T05:31:56Z"
},
"imminent": true
},
"pickup_eta_at": "2023-11-07T05:31:56Z",
"dropoff_eta_at": "2023-11-07T05:31:56Z",
"tracking_url": "https://app.listo.delivery/t/abc123",
"verification": {
"pincode": "<string>"
},
"return_verification": {
"pincode": "4821"
},
"proof": {
"picture_url": "<string>",
"signature_image_url": "<string>",
"signature_name": "<string>",
"captured_at": "2023-11-07T05:31:56Z"
},
"proofs": {
"pickup": {
"photo_url": "<string>",
"captured_at": "2023-11-07T05:31:56Z"
},
"dropoff": {
"photo_url": "<string>",
"signature_url": "<string>",
"signer_name": "<string>",
"captured_at": "2023-11-07T05:31:56Z",
"delivered": true
},
"return": {
"photo_url": "<string>",
"signature_url": "<string>",
"signer_name": "<string>",
"captured_at": "2023-11-07T05:31:56Z",
"meters_from_store": 123
}
},
"cancellation": {
"description": "<string>"
},
"charges": [
{
"amount_cents": 123,
"charged_at": "2023-11-07T05:31:56Z"
}
],
"refunds": [
{
"id": "rfn_4bQ7wS2xK9mT6vN3cZ8pLdYe",
"amount_cents": 123,
"reason": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"succeeded_at": "2023-11-07T05:31:56Z"
}
],
"refunded_cents": 123,
"refundable_cents": 123,
"support_reference": "2080F",
"pickup_ready_at": "2023-11-07T05:31:56Z",
"requested_at": "2023-11-07T05:31:56Z",
"courier_assigned_at": "2023-11-07T05:31:56Z",
"picked_up_at": "2023-11-07T05:31:56Z",
"delivered_at": "2023-11-07T05:31:56Z",
"canceled_at": "2023-11-07T05:31:56Z",
"returned_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
},
"test": true
}Encabezados
Comprueba que el evento vino de nosotros. El valor es t=<unix seconds>,v1=<hex>,
donde el hex es un HMAC-SHA256, con tu secreto de firma como llave, sobre la
cadena "<t>.<raw request body>".
Para verificarlo: separa el encabezado por la coma, reconstruye "<t>.<body>" a
partir de los bytes CRUDOS que recibiste (nunca un objeto parseado y vuelto a serializar,
porque los espacios en blanco y las secuencias de escape cambiarían la firma), calcula el
HMAC y compáralo con v1 en tiempo constante. Rechaza todo lo que no coincida.
Después revisa el reloj. Rechaza un evento cuyo t esté a más de 5 minutos de distancia de ahora en CUALQUIERA de las dos direcciones: un t muy en el pasado es el replay que este esquema existe para detener, y uno muy en el futuro es el mismo ataque con un reloj que nadie revisó.
Pueden estar activos dos secretos a la vez para que puedas rotar sin tiempo de inactividad: agrega el nuevo, acepta cualquiera de los dos, promuévelo y luego elimina el anterior. Siempre firmamos con el primario.
"t=1753728063,v1=8d2f4a1b6c7e9f0a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f607182"
Cuerpo
Los campos que comparten todos los eventos. La entrega es al menos una vez y sin orden
por diseño: deduplica por id, y ordena por created_at o por las marcas de tiempo
propias del objeto, no por orden de llegada. type y data los agrega
cada evento, porque sus valores dependen de cuál evento sea.
El id del evento, con prefijo evt_. Deduplica por este.
"evt_9pQ2vX7mKdR4tYb1nZ3sLwCe"
Cuándo se registró el evento, ISO-8601 en UTC.
"2026-07-28T18:41:03Z"
Qué evento es este.
delivery.status_changed La forma de un envío: cada campo que puede llevar el objeto, con la
nulabilidad que realmente tiene cada uno. Es la respuesta de cada operación
que responde un envío (la creación, la consulta, una fila de lista, la
reprogramación, la cancelación, el reintento y el reembolso) y el data de
cada evento completo de envío, así que UN tipo sostiene todos ellos.
Cada operación devuelve el objeto completo. Un campo que una llamada dada
todavía no puede tener está presente y es null en lugar de faltar: una respuesta
de creación tiene courier en null, porque todavía no se asigna ningún repartidor,
y una reprogramación solo responde con un pedido que sigue programado,
así que su delivered_at es null.
El dinero va en centavos enteros, las marcas de tiempo son ISO-8601 en UTC, y cada enumeración de abajo es nuestra y no una copia de la de un tercero.
Show child attributes
Show child attributes
Presente, y en true, solo en un evento de prueba que pediste con
POST /v1/test_webhooks. Un evento real no trae el campo en absoluto. El data de un evento de prueba es una muestra cuyos ids no corresponden a nada.
true
Respuesta
Responde con cualquier 2xx, lo más rápido que puedas, para confirmar el evento. Haz el trabajo después. Cualquier otra respuesta se reintenta.