Skip to main content
Pagamentos Pix e cartão compartilham o mesmo evento de domínio: event: "transaction".

​
Payload mínimo que importa

{
  "id": "evt_xxx",
  "event": "transaction",
  "data": {
    "id": "trx_xxx",
    "correlation_id": "corr_xxx",
    "method": "pix",
    "status": "paid",
    "amount": 12590,
    "currency": "BRL"
  }
}

​
Diferenças por método

MétodoCampos úteisObservação
pixdata.pix.qr_code, data.pix.end_to_end_idend_to_end_id geralmente disponível após pagamento
credit_carddata.installmentsStatus tende a evoluir por autorização/captura

​
Status para tratar no produto

StatusAção recomendada
pendingmanter pedido aguardando
paid / capturedliberar produto/serviço
canceled / expiredencerrar tentativa e permitir novo pagamento
refundedatualizar financeiro e pedido
rejected / errorexibir falha e sugerir nova forma de pagamento

​
Reconciliação

  1. Webhook primeiro.
  2. Se houver dúvida operacional, consulte GET /v2/transactions/{id}.
Regras gerais de consumo (idempotência, ack rápido e fila) estão em Webhooks.