Lista de status do estorno

A consulta da transação pode retornar o nó Payment.Refunds, que registra os pedidos de estorno feitos para a transação. A consulta apenas exibe esses registros e não solicita nem altera um estorno. Cada item mostra o valor solicitado, a situação do pedido e a data em que ele foi recebido.

"Refunds": [
  {
    "Amount": 10000,
    "Status": 4,
    "ReceivedDate": "2025-01-31T16:26:26.743"
  }
]
PROPRIEDADEDESCRIÇÃOTIPO
Payment.Refunds.AmountValor solicitado no pedido de estorno, em centavos. O valor não indica que o estorno foi efetivado. Para saber o resultado do pedido, consulte Payment.Refunds.Status.Número
Payment.Refunds.StatusSituação do pedido de estorno. Consulte a tabela a seguir.Número
Payment.Refunds.ReceivedDateData e hora em que o pedido de estorno foi recebido, no formato AAAA-MM-DDThh:mm:ss.fff.Texto

Lista de status

CÓDIGOSTATUSDESCRIÇÃO
0Falha de comunicaçãoNão foi possível concluir o pedido de estorno por uma falha de comunicação com a adquirente.
1Estorno agendado (Pix)O pedido de estorno foi registrado e agendado para processamento.
2Estorno agendado (Cartão)O pedido de estorno foi registrado e agendado para processamento.
3SucessoO estorno foi processado e efetivado.
4NegadoA adquirente recusou o pedido de estorno.
ℹ️

A lista de Payment.Refunds.Status é diferente da lista de Payment.Status. Os códigos de uma não têm o mesmo significado na outra. Para consultar o status do pagamento, veja Status da Transação.

Como interpretar o retorno

  • O nó Refunds pode aparecer na consulta da transação, mas não é retornado na resposta da solicitação de cancelamento.
  • Quando um pedido é negado (status 4), os campos ProviderReturnCode e ProviderReturnMessage informam o motivo da negativa. Para consultar o significado do código, acesse Códigos de retorno de cancelamento.
  • Para verificar a situação atual da transação, consulte Payment.Status, Payment.VoidedDate e Payment.VoidedAmount. O nó Refunds apresenta o resultado das solicitações de estorno e não substitui essas informações.