Skip to main content
POST

Descrição

Solicita o reembolso de um pagamento aprovado. O reembolso é processado na mesma hora, devolvendo o valor ao cliente e deduzindo do seu saldo o valor líquido que você havia recebido. Se o pagamento possuía regras de split, os valores recebidos pelos destinatários do split também serão deduzidos de seus respectivos saldos.
Operação irreversível: Após processar o reembolso, não é possível desfazê-lo.

Headers

string
required
Bearer token com sua API Key
string
required
Deve ser application/json

Body

string
required
ID da transação a ser reembolsada

Pré-requisitos

Apenas pagamentos podem ser reembolsados, não saques
Só é possível reembolsar pagamentos já confirmados
Você deve ter saldo suficiente para cobrir o valor líquido
Cada pagamento só pode ser reembolsado uma vez
Se já houver um reembolso em processamento (refund_pending), aguarde a conclusão
Se a transação possuir uma contestação (MED) pendente ou aceita, não é possível reembolsar

Response

boolean
Indica se a operação foi bem-sucedida
string
Mensagem de confirmação
object
Detalhes do reembolso

Como Funciona

1

Solicitação enviada

O reembolso é solicitado e o status muda para refund_pending
2

Aguarda confirmação

O banco processa a devolução PIX ao pagador original
3

Cliente recebe o valor total

O sistema devolve R$ 49,90 (valor total incluindo a taxa) ao cliente
4

Dedução do seu saldo

Após confirmação, R$ 46,41 (valor líquido) é deduzido do seu saldo disponível
5

Status atualizado

O status da transação muda para refunded
Processamento assíncrono: O tempo de processamento depende do banco e pode levar alguns minutos. Você pode acompanhar o status consultando a transação.

Erros Comuns