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

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 reembolso não possui custo e as taxas transacionais iugu também são devolvidas nesse processo.


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

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.