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."
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étodo | Parcial | Possibilidade | Prazo para solicitar estorno | Prazo para restituição |
---|---|---|---|---|
Cartão de Crédito | ✅ | ✅ | até 180 dias após o pagamento | entre 30 e 60 dias |
Pix | ❌ | ✅ | até 90 dias após o pagamento | instantâ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ção | Valor (R$) | Parcelas | Total Pago (R$) | Saldo Disponível (R$) | Saldo a Receber (R$) | Valor no Extrato (R$) |
---|---|---|---|---|---|---|
Fatura Original | 1.000,00 | 10x de 100,00 | - | - | - | - |
Parcelas Liquidadas | 400,00 | 4x de 400,00 | - | - | - | - |
Estorno Solicitado | 600,00 | - | - | - | - | - |
Estorno em Parcelas | 600,00 | 10x de 60,00 | - | - | - | - |
Estorno Retirado do Saldo Disponível | 240,00 | 4x de 60,00 | - | 240,00 | - | - |
Estorno Retirado do Saldo a Receber | 360,00 | 6x 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 Fatura — v1/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'."
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.
Updated 7 months ago
Assuntos relacionados