Skip to main content

Visão Geral

O evento CashInReversal é enviado quando você inicia um estorno de um PIX recebido anteriormente, devolvendo o valor ao pagador original. Este evento ocorre quando você chama a API de Refund-In.
O movementType para CashInReversal é DEBIT, pois você está devolvendo dinheiro que havia entrado na sua conta.

Payload Completo


Campos Específicos do CashInReversal

O CashInReversal inclui o objeto parentTransaction com dados da transação original que está sendo estornada.

parentTransaction

object
obrigatório
Dados da transação PIX In original que está sendo estornada.
string
ID numérico da transação PIX In original (retornado como string).
string
ID externo da transação original.
string
ID End-to-End da transação original.
string
Data de processamento da transação original.
boolean
Indica se o valor total da transação original foi estornado.
  • true: Estorno total (não pode estornar mais)
  • false: Estorno parcial (ainda pode estornar o restante)
number
Valor restante que ainda pode ser estornado (em reais).Exemplo: 0.2 (ainda pode estornar R$ 0,20)
object
Dados do pagador original que receberá o estorno.

Estorno Total vs Parcial

Estorno Total

Quando você devolve 100% do valor recebido:

Estorno Parcial

Quando você devolve apenas parte do valor:
Você pode fazer múltiplos estornos parciais até que wasTotalRefunded seja true.

Casos de Uso

1. Devolução de Pagamento Duplicado

2. Controle de Estornos Parciais


Fluxo Típico


Próximos Passos

PIX Refund-In

Aprenda a estornar recebimentos

CashIn

Entenda o evento de recebimento