Skip to main content
Webhooks de pagamento sempre usam o envelope de transaction. O event de topo permanece transaction; o nome concreto do evento fica em data.event_type.

Exemplo de payload entregue

data.informations devolve o array informations que você enviou ao criar a transação via API — use-o para reconciliar o evento com os seus próprios registros. Só aparece quando você enviou entradas customizadas na criação; transações sem elas (ou criadas por checkout links) omitem o campo.

Resposta de ACK

Eventos emitidos hoje

  • transaction.created
  • transaction.pending
  • transaction.paid
  • transaction.cancelled
  • transaction.refunded
  • transaction.partially_refunded
  • transaction.chargedback
  • transaction.three_ds_required

Erro comum de ingestão

Como corrigir: faça deduplicação pelo id do evento no topo, não pelo ID da transaction, porque a mesma transaction pode emitir mais de um evento ao longo do tempo.

Guia de mapeamento

  • Use transaction.paid para liberar bens ou serviços.
  • Mantenha o pedido aberto em transaction.pending.
  • Para method: "voucher", transaction.pending também pode carregar instruções de pagamento em data.voucher. Exiba url, digitable_line, barcode ou instructions e continue aguardando transaction.paid.
  • Use eventos de reembolso e chargeback para fluxos de financeiro e suporte.
  • Encaminhe transaction.three_ds_required de volta para o seu fluxo de challenge de cartão.