Eventos de Cobranças

Eventos disponíveis

Quando cada evento dispara

charge.pending

Disparado quando uma cobrança é criada com método de pagamento assíncrono (PIX ou boleto) e aguarda o pagamento do cliente.

charge.authorized

Disparado quando o pagamento com cartão é autorizado pela adquirente, antes da captura.

charge.captured

Disparado quando o pagamento é capturado com sucesso. Para PIX e boleto, isso ocorre quando o pagamento é confirmado. Para cartão, quando a captura é processada.

charge.partially_refunded

Disparado quando um estorno parcial é realizado (valor menor que o total da cobrança).

charge.refunded

Disparado quando um estorno total é realizado.

charge.voided

Disparado quando uma cobrança autorizada é cancelada antes da captura.

charge.failed

Disparado quando o pagamento é recusado pela adquirente ou ocorre um erro no processamento.

charge.expired

Disparado quando uma cobrança com PIX ou boleto expira sem pagamento.

charge.chargeback

Disparado quando uma contestação (chargeback) é registrada pela bandeira do cartão.

Payload de exemplo

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "event": "charge.captured",
  "charge": {
    "id": "f1e2d3c4-b5a6-7890-fedc-ba0987654321",
    "external_id": "ext-abc-123",
    "merchant_id": "m1e2r3c4-h5a6-7890-ntid-000000000001",
    "submerchant_id": null,
    "status": "captured",
    "amount"

Campos do objeto charge