Referência - Upag Documentation

No Billing, o webhook é configurado no dashboard (não há CRUD público na API de gateway). Você informa URL HTTPS, seleciona eventos e obtém a signing secret para validar entregas.

Configuração

Item	Detalhe
URL	HTTPS, rota POST da sua aplicação
Eventos	Assinatura, pagamento e/ou fatura — lista em Webhooks
Secret	Exibida ao criar ou rotacionar o endpoint; use só em variável de ambiente

Separe endpoints ou URLs entre chaves sk_test_... e sk_live_... para não misturar sandbox com produção.

Corpo da entrega

{
  "event": "payment.approved",
  "data": { }
}

Campo	Uso
`event`	Identificador (`payment.approved`, `subscription.active`, …)
`data`	Snapshot do recurso — ver Payloads na sidebar

Headers e algoritmo de assinatura: Verificação e segurança.

Payloads