Como estornar uma transação?

Visão Geral

A API de Estorno v2 da Barte oferece capacidade expandida para processar estornos totais e parciais de cobranças já pagas. Esta nova versão substitui a API anterior com maior flexibilidade operacional, permitindo que os Sellers realizem estornos parciais conforme suas necessidades de negócio.

Novidade! A principal diferença em relação à versão anterior é o suporte para estornos parciais, permitindo devolver apenas uma parte do valor da cobrança original.

Especificações dos Endpoints

Tipo de Estorno	Método	URL
Total	PATCH	/v2/charges/{uuid}/refund
Parcial	PATCH	/v2/charges/partial-refund/{uuid}

Cabeçalhos Obrigatórios

Chave	Valor	Descrição
X-Token-Api	API Token	Token de API do Seller
Content-Type	application/json	Tipo de conteúdo da requisição

Parâmetros

Parâmetro	Tipo	Descrição
uuid	string	UUID da cobrança a ser estornada

Corpo

Tipo de Estorno	Propriedade	Tipo	Obrigatório
Total	asFraude	boleano (true ou false)	Sim
Parcial	value	número	Sim
Parcial	reason	texto	Não

Regras de Negócio

Validações Aplicadas

1. Status da Cobrança: Apenas cobranças com status PAID podem ser estornadas

2. Saldo do Seller: O seller deve ter saldo suficiente para cobrir o estorno

3. Valor do Estorno:

   1. Deve ser maior que zero

   2. Não pode exceder o valor total da cobrança menos estornos já processados

   3. Suporta estornos parciais múltiplos até o limite do valor original

4. Estornos Simultâneos: Não é permitido processar um novo estorno enquanto outro está em andamento para a mesma cobrança

Métodos de Pagamento Suportados

Método	Suporte a Reembolso
PIX	✓ Total e Parcial
Cartão de Crédito	✓ Total e Parcial
Apple Pay	✓ Total e Parcial
Google Pay	✓ Total e Parcial
Boleto Bancário	✗ Não suportado