Visão geral · API do Hotel das Lojas

Webhooks

Seu sistema recebe um POST assim que algo acontece na loja.

Como funciona

Cadastre o endereço https do seu sistema no painel ou pelo endpoint Criar Webhook, escolhendo os eventos.
A cada evento, enviamos um POST com JSON em até 1 minuto (o envio é em segundo plano: a compra do cliente não espera).
Responda com qualquer status 2xx em até 8 segundos. Se não responder, tentamos de novo depois de 1 min, 5 min, 30 min, 2 h, 6 h, 12 h e 24 h.
Depois de 50 falhas seguidas o webhook é pausado. Reative no painel ou com PATCH /webhooks/{id} e {"ativo": true}.

Cabeçalhos enviados

cabeçalho	exemplo
`X-HDL-Evento`	`pedido.criado`
`X-HDL-Entrega`	`4` (id da entrega; o mesmo nas novas tentativas)
`X-HDL-Timestamp`	`1793159160`
`X-HDL-Assinatura`	`sha256=5f1c...` (como conferir)
`User-Agent`	`HotelDasLojas-Webhooks/1.0`

Corpo

{
  "id": "evt_3c1f9a7b2d4e6f8a0b1c",
  "evento": "pedido.status_alterado",
  "criado_em": "2026-10-28T00:44:01-03:00",
  "loja_id": 220,
  "dados": {
    "id": 2178,
    "status": "enviado",
    "...": "o objeto Pedido completo"
  }
}

Use o id do evento para ignorar repetições: em caso de falha de rede, o mesmo evento pode chegar mais de uma vez.
Responda rápido (2xx) e processe depois, numa fila do seu lado.