Skip to main content

​
O que é

Após um envio com status CONFIRMED, o destinatário ou a rede podem devolver os fundos. O parceiro envia evento interno CashOutReversal. O cash-out migra a REVERSED; é criado o registro de reversão e um lançamento de crédito no ledger (retorno de saldo à sua conta, conforme regras do produto).

​
Webhook ao comerciante: pix_cash_out_reversal

No evento pix_cash_out_reversal:
  • O campo event.id no objeto event é o UUID do cash-out original.
  • value_cents reflete o valor revertido informado pelo parceiro; há fallback documentado no código quando metadados vêm incompletos — monitore divergências e concilie com o que você espera.
Exemplo (trecho) conforme a documentação de origem: 
{
  "event_type": "pix_cash_out_reversal",
  "event": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "status": "REVERSED",
    "value_cents": 50000,
    "end_to_end_id": "D07136847202504021600O9999ABCD99"
  }
}

​
O que fazer no integrador

  1. Reconhecer REVERSED como término de negócio distinto de “erro de envio” (o envio estava CONFIRMED antes).
  2. Ajustar o saldo/ERP conforme o crédito de ledger e a sua regra (ex.: estornar pagamento a fornecedor, marcar inadimplência, etc.).
  3. Deduplicar eventos: mesma reentrega de webhook deve ser idempotente.
  4. Conferir valor e end-to-end com extratos/parceiro em divergência.

​
Relação com cash-out “normal”

  • Falha de envio (antes de confirmação) mapeia para fluxo de failed.
  • Reversão ocorre após confirmação, via CashOutReversal.

​
Leitura adicional