Saltar al contenido principal
Los webhooks envían un 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 2xx en 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} y enabled: true.
  • El mismo evento puede llegar más de una vez. Use PapelShip-Event-Id para procesarlo una sola vez.

Gestionar endpoints con la API

La respuesta contiene el 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.