Voltar ao site
Webhooks

Configurar endpoints

Cadastro de URLs, escolha de eventos, segredo de assinatura e teste.

Página em construção

Este é um resumo. O conteúdo completo entra nas próximas versões da documentação; o contrato de cada rota já está na Referência da API.

  • POST /v1/webhook-endpoints com url (HTTPS, porta 443 ou 8443) e a lista de events. A resposta traz o secret (whsec_…) uma única vez.
  • Sem X-Merchant-Id, o endpoint recebe os eventos da organização inteira; com ele, só os daquele merchant.
  • PATCH, DELETE, POST .../rotate-secret (troca o segredo com janela de sobreposição) e POST .../test (envia um ping).
  • GET .../deliveries mostra o histórico de entregas.