{
"id": "evt_9pQ2vX7mKdR4tYb1nZ3sLwCe",
"created_at": "2026-07-28T18:41:03Z",
"type": "store.updated",
"data": {
"id": "st_4bR8kM2wQ7xT1nV5cZ9pLdYe",
"external_id": "pos-store-41",
"name": "<string>",
"phone": "<string>",
"street": "<string>",
"apt_unit": "<string>",
"lat": 123,
"lng": 123,
"pickup_notes": "<string>",
"timezone": "America/Mexico_City",
"default_business_fee_share": 50,
"default_fee_split_amount_cents": 1,
"markup_cents": 1,
"test": true,
"created_at": "2023-11-07T05:31:56Z",
"plan": {
"price_cents": 199000,
"currency": "MXN",
"interval": "month",
"current_period_ends_on": "2023-12-25",
"next_charge_on": "2023-12-25",
"canceled_at": "2023-11-07T05:31:56Z",
"ends_on": "2023-12-25",
"pending_paid_by": "<string>",
"pending_paid_by_on": "2023-12-25",
"courtesy": true
}
},
"test": true
}A store changed
Se envía cuando cambia una de tus tiendas, incluidos los cambios que nadie pidió. El caso principal es que cambie la disponibilidad para cobrar con tarjeta una vez que se revisa el alta alojada. Un cambio en el Plan Listo de una tienda real también envía uno, con el plan: un plan que inicia, se renueva, falla o limpia un cobro, se cancela o se deshace esa cancelación, termina, se reinicia, cambia de precio, o pasa a ti desde un restaurante que se conectó. Una acción envía un evento, que lleva el estado en que terminó el plan, y los cambios que caen muy juntos pueden llegar como un solo evento con el estado más reciente. Un evento cuyo objeto de tienda sería exactamente el que te enviamos por última vez para esa tienda no se envía.
data es el objeto de tienda, que NO trae ningún campo de disponibilidad: este evento es la señal, y GET /v1/stores/{id}/stripe_status es la respuesta.
{
"id": "evt_9pQ2vX7mKdR4tYb1nZ3sLwCe",
"created_at": "2026-07-28T18:41:03Z",
"type": "store.updated",
"data": {
"id": "st_4bR8kM2wQ7xT1nV5cZ9pLdYe",
"external_id": "pos-store-41",
"name": "<string>",
"phone": "<string>",
"street": "<string>",
"apt_unit": "<string>",
"lat": 123,
"lng": 123,
"pickup_notes": "<string>",
"timezone": "America/Mexico_City",
"default_business_fee_share": 50,
"default_fee_split_amount_cents": 1,
"markup_cents": 1,
"test": true,
"created_at": "2023-11-07T05:31:56Z",
"plan": {
"price_cents": 199000,
"currency": "MXN",
"interval": "month",
"current_period_ends_on": "2023-12-25",
"next_charge_on": "2023-12-25",
"canceled_at": "2023-11-07T05:31:56Z",
"ends_on": "2023-12-25",
"pending_paid_by": "<string>",
"pending_paid_by_on": "2023-12-25",
"courtesy": true
}
},
"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.
store.updated Un punto de recolección. La disponibilidad para cobrar con tarjeta NO es un campo aquí a propósito: tiene endpoint propio, con detalle propio de requisitos pendientes.
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 para confirmar el evento.