POST HTTP a su servidor cuando ocurre algo en su tienda, para que no tenga que consultar periódicamente.
Cree endpoints en Desarrolladores › Webhooks o con POST /webhooks.
Eventos
GET /events/types devuelve la misma lista.
Carga
Los importes de los webhooks están en unidades mayores (
34.99), a diferencia de la API, que usa unidades menores (3499).Verificar la firma
Cada solicitud incluye estos encabezados:
La firma es
HMAC-SHA256(secret, "<t>.<raw body>") en hexadecimal. El secreto (whsec_...) se muestra al crear el endpoint. Calcúlela sobre el cuerpo sin procesar, antes de analizar el JSON, y rechace las marcas de tiempo antiguas.
Respuesta y reintentos
- Responda con cualquier estado
2xxen un plazo de 10 segundos. Realice el trabajo lento después de responder. - Las entregas fallidas se reintentan después de 1 minuto, 5 minutos, 30 minutos, 2 horas, 6 horas y 12 horas (7 intentos en unas 21 horas).
- Un endpoint se desactiva tras 40 fallos seguidos sin ningún éxito en 3 días. Reactívelo en el panel o con
PATCH /webhooks/{id}yenabled: true. - El mismo evento puede llegar más de una vez. Use
PapelShip-Event-Idpara procesarlo una sola vez.
Gestionar endpoints con la API
secret de firma. Se muestra una sola vez; guárdelo en el entorno de su servidor.
La rotación del secreto se sigue haciendo en el panel.