Reembolsar Faturas por API

📘

O que você irá aprender com esse artigo?

  • O que é um reembolso
  • Como reembolsar Faturas por API
  • Reembolsos parciais
  • Sobre Gatilho de Reembolso de Faturas

O que é um reembolso?

Reembolso é o processo de devolver ao comprador os valores pagos em uma transação. Esta devolução pode ser total, cobrindo o valor completo da compra, ou parcial, quando apenas parte do valor é retornada.

Caso de uso

"O cliente entrou em contato para solicitar o estorno de uma cobrança, expressando insatisfação com o produto ou serviço adquirido."

Diagrama de Sequência para estornos

Regras de reembolso por método de pagamento

Cada método de pagamento segue regras específicas para reembolsos, variando conforme as condições e prazos estabelecidos.

MétodoParcialPossibilidadePrazo para solicitar estornoPrazo para restituição
Cartão de Créditoaté 180 dias após o pagamentoentre 30 e 60 dias
Pixaté 90 dias após o pagamentoinstantâneo
Boleto Bancário
📘

Cartão de Crédito — Restituição

Se mesmo após o prazo de 30 e 60 dias, os valores não forem restituídos, instrua o comprador contatar a administradora do cartão

Boleto Bancário

Não oferecemos a opção de reembolso para pagamentos feitos por boleto. Para esses casos, é necessário que a devolução seja realizada diretamente ao cliente através de uma transferência bancária por parte da empresa.

Cartão de Crédito

Hoje é possível realizar reembolsos tanto integrais quanto parciais para as faturas pagas com Cartão de Crédito. Além disso, se a transação envolver Split de Pagamento, o valor reembolsado será distribuído proporcionalmente entre as contas envolvidas.

Por exemplo, considerando uma fatura dividida entre a conta Mestre e uma Subconta, com a conta mestre recebendo 20% e a subconta 80% do valor, um reembolso parcial de R$ 10,00 resultará em R$ 8,00 sendo devolvidos da Subconta e R$ 2,00 da conta mestre.

Pix

Os reembolsos devem ser realizados dentro de um prazo máximo de 90 dias após o pagamento e o valor do estorno precisa ser integral, ou seja, não são permitidos reembolsos parciais.

📘

Tarifas

O estorno gera cobrança da taxa de MDR.
A taxa é debitada da conta responsável pelo estorno (mestre ou subconta).
Para maiores detalhes sobre MDR, recomendamos consultar a FAQ.


Reembolso de faturas parceladas

No caso de pagamentos parcelados, se algumas parcelas já foram liquidadas, o valor do reembolso será deduzido do saldo disponível da conta. Se ainda existirem parcelas a vencer, o valor será retirado do saldo a receber.

Parcial COM parcelas liquidadas

No caso de reembolsos parciais envolvendo transações parceladas, o processamento do valor depende do status de liquidação das parcelas.

Considerando uma fatura de R$ 1.000,00 parcelada em 10x. Foram liquidadas 4 parcelas, totalizando R$ 400,00. Foi solicitado um estorno parcial de R$ 600,00. A iugu divide esse valor em 10 parcelas de R$ 60,00 cada. Das 10 parcelas, 4 de R$ 60,00 serão retiradas do saldo disponível em conta, esse valor será retirado de uma única vez, ou seja, R$ 240,00. No extrato a receber, durante 6 meses, aparecerá apenas o valor de R$ 40,00, que é a diferença entre a parcela inicial de R$ 100,00 e o estorno de R$ 60,00.

Exemplo do texto no formato de tabela:

DescriçãoValor (R$)ParcelasTotal Pago (R$)Saldo Disponível (R$)Saldo a Receber (R$)Valor no Extrato (R$)
Fatura Original1.000,0010x de 100,00----
Parcelas Liquidadas400,004x de 400,00----
Estorno Solicitado600,00-----
Estorno em Parcelas600,0010x de 60,00----
Estorno Retirado do Saldo Disponível240,004x de 60,00-240,00--
Estorno Retirado do Saldo a Receber360,006x de 60,00--360,00-
Valor no Extrato (6 meses)-----40,00 (100,00 - 60,00)

Parcial SEM parcelas liquidadas

Em outro cenário, para uma transação de R$ 120,00 parcelada em 12 vezes onde nenhuma parcela foi liquidada e ocorre uma solicitação de reembolso parcial de R$ 90,00, esse valor será descontado do total da transação. Este montante sairá do saldo a receber e será reembolsado. O valor remanescente de R$ 30,00 será então dividido igualmente pelas 12 parcelas, definindo o valor de cada uma em R$ 2,50.

Total COM parcelas liquidadas

Quando uma transação parcelada possui parcelas já liquidadas e há um pedido de reembolso total, os valores são ajustados conforme o status de cada parcela.

Por exemplo, em uma transação de R$ 120,00 parcelada em 12 vezes, se duas parcelas totalizando R$ 20,00 já foram liquidadas, esse montante será deduzido do saldo disponível. Os R$ 100,00 restantes, correspondentes às parcelas não liquidadas, serão retirados do saldo a receber.

Total SEM parcelas liquidadas

Quando uma solicitação de reembolso total é feita, o valor completo será deduzido do saldo a receber.

📘

E se a conta não tiver saldo disponível?

Se a conta não possuir saldo disponível e parte ou todo o valor do reembolso precisar ser retirado deste saldo, o reembolso não será realizado.


Como realizar reembolso via API

Utilize o endpoint POST Reembolsar Faturav1/invoices/{id}/refund. Em {id}, insira o invoice_id da Fatura que deseja reembolsar.

Request example

curl --request POST \
     --url 'https://api.iugu.com/v1/invoices/{{invoice_id}}/refund?api_token={{api_token}}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json'

Response example (resumido)

{
  "id": "A123D06C9ADA54FBBA7C427C677886A41",
  "due_date": "2024-05-08",
  "currency": "BRL",
  "discount_cents": null,
  "email": "[email protected]",
  "items_total_cents": 1000,
  "notification_url": null,
  "return_url": null,
  "status": "refunded", /// Reembolsada
  "tax_cents": null,
  "total_cents": 1000,
  ...

Consulte a response example completa em Reembolsar Fatura.

Parcial

Para um reembolso parcial , informe o valor no parâmetro partial_value_refund_cents.

Por exemplo, para estornar apenas R$10,00 de uma fatura de R$80,00, siga o seguinte exemplo:

curl --location --request POST 'https://api.iugu.com/v1/invoices/id/refund' \ 
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{api_token in base64}}' \
--data-raw '{ 
     "partial_value_refund_cents": 1000 
}'

Gatilho — Reembolso de Fatura

A iugu conta com uma série de Gatilhos e, um deles, é acionado sempre que uma Fatura tem o seu status alterado para refunded. Saiba mais.

Caso de uso

"O cliente entrou em contato para solicitar o estorno de uma fatura. De acordo com uma estratégia definida pela empresa, o processo exige que o cliente converse com um atendente. Este atendente acessará o painel da iugu para efetuar o estorno. É importante que a atualização do estorno seja replicada no site para que o status do pedido do cliente seja atualizado para 'estornado'."

Diagrama de Sequência para Reembolsos e acionamento de Gatilho

Quando o status da fatura for alterado para refunded, o Gatilho será acionado retornará para o endereço configurado, avisando, então, que o reembolso foi realizado.


Did this page help you?