Pular para o conteúdo principal

Devolver um Pix

Você pode devolver todo ou parte de um Pix aprovado. O dinheiro volta para quem pagou, nunca para outra conta.
  • Sem amount, a Valora devolve tudo o que ainda resta.
  • Com amount, devolve só esse valor (em reais). Você pode fazer várias devoluções parciais até o total pago.
  • O valor devolvido sai do seu saldo disponível. Sem saldo suficiente, a resposta é 409 insufficient_balance.
A resposta (201) traz a devolução e o pagamento atualizado:
Depois de cada devolução, você recebe o evento payment.refunded. O pagamento fica partially_refunded enquanto sobrar valor e refunded quando tudo foi devolvido.
Se o banco do pagador demorar a responder, a API pode devolver 202 provider_pending. A devolução continua em andamento e o evento payment.refunded chega quando ela concluir.

Cartão e boleto

Devoluções de cartão e de boleto não são feitas pela API. Para devolver um desses pagamentos, fale com o suporte da Valora.

Contestações no cartão

Uma contestação (chargeback) acontece quando o comprador pede ao banco o cancelamento de uma compra no cartão. O campo dispute do pagamento mostra o estado (open, won, lost) e as datas de abertura e encerramento.
Ao receber payment.disputed, junte comprovantes de entrega e de contato com o cliente. Eles ajudam a ganhar a disputa.