Devolução de PIX: quando, quanto e como devolver

Pedido cancelado, produto em falta, cobrança feita em dobro: toda empresa que recebe por PIX um dia precisa devolver. O Banco Central prevê isso: a devolução usa o próprio PIX recebido e o dinheiro volta para a conta de quem pagou.

As regras

• Prazo: até 90 dias depois do pagamento.
• Valor: o todo ou só uma parte. Dá para fazer várias devoluções parciais, desde que a soma não passe do que foi recebido.
• Para quem: sempre para quem pagou. Não é possível devolver para outra conta.

O cuidado que mais importa: não devolver duas vezes

Devolução é dinheiro saindo da conta. Uma conexão que cai no meio do pedido e é repetida pode virar duas devoluções. Na SinapsePay:

• cada devolução tem um identificador próprio, e o pedido ao banco é feito uma única vez; se algo cair no meio, a plataforma pergunta ao banco antes de pedir de novo;
• pela API, a Idempotency-Key garante que repetir a chamada não cria outra devolução;
• no painel, devolver pede a senha de novo e os proprietários são avisados por e-mail.

Acompanhando até o fim

A devolução passa por pedida ao banco, em processamento e termina em devolvida (com o identificador do Banco Central) ou não realizada (com o motivo, como saldo insuficiente). Quando todo o valor é devolvido, a cobrança vira devolvida; em parte, continua paga com a lista das devoluções.

Pelo painel ou pela API

No painel, abra a cobrança paga e use Devolver PIX: o valor vem preenchido com o que resta. Pela API:

POST /v1/cobrancas/{id}/devolver
Idempotency-Key: devolucao-1042-1

{ "valor": 500, "motivo": "Produto em falta" }

Detalhes e respostas em Devoluções de PIX.