Como devolver um Pix

Você pode devolver um Pix recebido, inteiro ou só uma parte, em até 90 dias depois do pagamento. O valor sai do seu saldo e volta para a conta de quem pagou na hora.

Antes de devolver

O saldo disponível precisa cobrir o valor da devolução.
Uma cobrança aceita várias devoluções parciais, até somar o valor pago.
Depois de 90 dias, combine a devolução direto com o cliente.

Pelo painel

Abra Pix › Cobranças e encontre o pagamento.
No detalhe da cobrança, clique em Devolver.
Escolha Valor total ou digite uma parte, e confirme com a sua senha de transação.

O botão Devolver fica no canto do detalhe da cobrança.

Pela API

Envie um POST para /v1/pix/{id}/refunds com o valor em centavos. Sem amount, a devolução é do valor total.

curl -X POST https://api.upag.io/v1/pix/pix_8KdT2m/refunds \
  -H "Authorization: Bearer sk_test_..." \
  -d amount=5000 # R$ 50,00

A resposta volta com o status pending. Quando o banco confirma, chega o webhook pix.refund.succeeded. Veja como configurar webhooks.

Prazos

Situação	Quando o cliente recebe
Devolução pelo painel ou pela API	Na hora
Banco do cliente fora do ar	Em até 24 horas
Conta do cliente encerrada	O valor volta para o seu saldo em até 2 dias

Taxas

A devolução não tem custo. A tarifa da cobrança original não é devolvida.