Skip to main content
Estornar devolve o dinheiro ao comprador, no todo ou em parte.
Estorno parcial de 4000 centavos
Omitir amount devolve o que ainda cabe estornar, e não o valor cheio da venda. É o padrão seguro: numa cobrança já devolvida pela metade, ele evita que o dinheiro saia duas vezes do vendedor.

Três números, três perguntas

Esta é a parte que gera chamado no suporte: você estorna R$ 100,00 e vê R$ 93,01 saírem do vendedor. Não é erro. Os campos vêm separados justamente para responder isso sem precisar perguntar.
Estorno integral de uma venda de 10000 centavos
Sempre amount = seller_debit + fee_returned. Do ponto de vista do comprador o estorno é sempre integral: a política de taxa decide quem financia, nunca quanto ele recebe.
seller_debit pode ser maior que o líquido que o vendedor recebeu na venda, quando a política retém o custo que o provedor não devolve. Nesse caso o vendedor paga a diferença — o dinheiro do comprador volta inteiro de qualquer forma.

Estorno não é barrado por falta de saldo

O dinheiro é do comprador e precisa voltar. Não checamos o saldo do vendedor antes. Se ele já sacou, o saldo fica negativo e as vendas seguintes cobrem automaticamente. Enquanto isso, só o saque fica bloqueado — nada mais para. Ver Saldo do vendedor.

Estornos parciais somam

refunded_amount na cobrança acumula entre estornos. O que ainda cabe estornar é amount - refunded_amount, e pedir mais que isso devolve 422 exceeds_remaining. Depois do primeiro estorno parcial a cobrança fica partially_refunded. Ela só vira refunded quando o total devolvido alcança o valor da venda.

Quando o estorno é recusado

O prazo conta do pagamento, não da criação. Uma cobrança que ficou dias pendente antes de ser paga não chega com o prazo já gasto.

status: failed não é lixo

failed significa que a devolução não aconteceu e o saldo do vendedor foi reposto. O motivo está em failed_reason. A linha permanece de propósito: uma tentativa de devolver dinheiro que não deu certo é exatamente o que alguém vai procurar depois — no atendimento ao comprador que ligou perguntando pelo estorno.

Veja também

Estorno parcial

A receita completa, com o webhook que chega depois.

Saldo do vendedor

O que acontece com o saldo quando ele fica negativo.

Ficou algo de fora? Escreva para suporte@usevext.com. Se o assunto for uma chamada específica, informe o horário dela; se for uma entrega de webhook, informe o X-Vext-Delivery — é por ele que localizamos a tentativa, a resposta do seu servidor e o horário.