Skip to main content
Hoje a Pagou expõe três famílias públicas de webhook. Pagamentos e assinaturas usam envelope com event. Transferências usam envelope de payout com type.

Comparação de envelopes

Exemplo de webhook de pagamento

data.informations devolve o array informations que você enviou ao criar a transação via API; só aparece quando você enviou entradas customizadas. Veja Eventos de Pagamento.

Exemplo de webhook de transferência

Exemplo de webhook de assinatura

Resposta de ACK

Erro comum de ingestão

Como corrigir: exija o id de topo, faça deduplicação por esse valor, responda 200 OK rapidamente e processe de forma assíncrona.

Guia de mapeamento

  • Dirija o estado de negócio pelo status do recurso, não por suposição no front-end.
  • Roteie mudanças de ciclo de vida de assinatura por data.event_type.
  • Mapeie o evento de transferência payout.transferred para o status liquidado do recurso paid.
  • Reconcilie se seu worker cair depois do ack.

Leia a seguir

Exemplos executáveis

Veja código pronto e testável para este fluxo em Exemplos de Webhooks — executável em sete linguagens no sandbox.