Skip to main content
O reembolso permite desfazer (dar “rollback”) em uma transação Pix já paga. O valor é devolvido à conta de origem, e a conta recebedora devolve o saldo correspondente, gerando um novo E2E (chave de end-to-end do Pix) iniciando com “D” de “devolução”.
  • Saldo suficiente: Só é possível efetuar o reembolso se houver saldo disponível na conta que originalmente recebeu o Pix.
    Se, por exemplo, a conta recebeu 20 reais , mas possui 10 reais no momento, não será possível reembolsar o valor total.
  • Prazo máximo de 90 dias: Para reembolsar, a transação não pode ter mais de 90 dias desde sua data de geração. Caso o limite seja excedido, a API retornará erro.
  • Status PAID: Apenas transações em status PAID podem ser reembolsadas (ou seja, a cobrança já foi confirmada e liquidada).

​
Como funciona o fluxo de reembolso

1

Solicite o reembolso

Envie a solicitação de reembolso para a plataforma, informando o ID da transação Pix.
2

Validações automáticas

A plataforma realiza validações de saldo, prazo e status da transação.
3

Processamento assíncrono

Se tudo estiver conforme, o reembolso é processado de forma assíncrona. Você recebe uma resposta inicial com um ID, e o status da transação pode mudar para REFUND_IN_PROGRESS.
4

Conclusão do reembolso

Uma vez concluído, o valor sai da conta recebedora e retorna à conta pagadora, alterando o status para REFUND_IN.
O valor é devolvido à conta de origem e a transação é marcada como reembolsada.
Para detalhes técnicos, consulte o endpoint: [POST] /payment/refund/:id

​
Considerações finais

Reembolso parcial: Este endpoint suporta valores parciais. Se informado o value, será verificado se o valor é permitido reembolsar.Exemplo: Recebe-se um pagamento (cash-in) de R$50,00. Você pode reembolsar apenas 20 reais, sobrando 30 reais remanescente. Caso tente reembolsar um valor maior do que o permitido após já ter realizado um reembolso parcial, a operação será negada.
  • Prazo: A solicitação deve ser feita até 90 dias após a liquidação do Pix (PAID).
  • Status final: Uma vez reembolsada, a transação será marcada como REFUND_IN.
  • Validação de saldo: Se a conta não tiver saldo suficiente no momento do reembolso, a operação falhará.
  • Fluxo assíncrono: O reembolso pode demandar alguns instantes para ser confirmado, pois depende da liquidação entre as instituições envolvidas.

​
Fluxo de status do reembolso

Quando uma transação enviada (cash out) sofre um reembolso pela conta recebedora.
Quando uma transação recebida (cash in) é reembolsada para a conta de origem que enviou.
Em caso de dúvidas sobre o reembolso ou integração avançada, consulte a documentação completa ou entre em contato com o suporte.