Calculadora de cupom
Um cupom pode oferecer uma porcentagem de desconto ou retirar um valor fixo, mas nem sempre fica claro quanto você realmente pagará.
Executar grátis
Esta calculadora aceita os dois formatos e informa preço original, economia e preço final com duas casas decimais. Ela também impede que um cupom fixo gere resultado negativo, sendo útil para comparar compras, revisar promoções, testar o checkout e planejar o orçamento antes de comprar.
Escolha o formato do cupom e informe o preço original
Comece pelo preço anterior à aplicação do cupom. Informe um valor não negativo, sem símbolo de moeda e com no máximo duas casas decimais. Selecione percent quando o cupom disser, por exemplo, 15% de desconto, ou fixed quando oferecer, por exemplo, $10 de desconto. A diferença importa: cupons percentuais variam conforme o preço da compra, enquanto cupons fixos retiram o mesmo valor de toda compra elegível. Deixe impostos, frete, créditos de associação e promoções independentes fora do cálculo, a menos que a loja os inclua expressamente no subtotal elegível. Um cupom restrito a mercadorias deve ser aplicado ao subtotal dos produtos, não ao total com entrega. Entradas claras facilitam a comparação com o recibo ou carrinho. Valores zero são aceitos para testar promoções; negativos, valores malformados e tipos incompatíveis são rejeitados sem presumir a intenção de você.
Entenda a economia percentual e a de valor fixo
Para um cupom percentual, a calculadora multiplica o preço original pela porcentagem e arredonda a economia para o centavo mais próximo, com os empates para cima. Assim, $79.99 com 15% produz uma economia exata em centavos antes da subtração. A porcentagem pode ter até duas casas decimais e deve ficar entre zero e cem. Em um cupom fixo, o valor informado já é a economia solicitada, portanto não há multiplicação. Se esse valor superar o preço original, a economia aplicada fica limitada ao preço e o resultado será $0.00. Esse comportamento representa cupons comuns, que reduzem um preço elegível sem gerar dinheiro ou saldo negativo. A saída mantém tanto o valor solicitado quanto a economia aplicada, permitindo que um aplicativo diferencie um cupom de $50 dos $30 realmente aproveitados em um item de $30.
Use o resultado em compras e verificações automatizadas
Leia savings como o valor retirado do preço original elegível e final_price como o restante após o cupom. Todos os valores monetários têm exatamente duas casas decimais, facilitando exibição, armazenamento e comparação em testes automatizados. O cálculo usa centavos inteiros, não aritmética monetária binária de ponto flutuante, evitando frações imprecisas. Essa estabilidade ajuda na garantia de qualidade do comércio eletrônico, no orçamento pessoal, na revisão de campanhas e no atendimento ao cliente. O resultado cobre um cupom aplicado diretamente a um preço elegível; não decide ordem de acúmulo, compra mínima, exclusões, impostos, frete ou validade por conta. Essas regras são do lojista. Ao conferir um checkout real, calcule aqui o subtotal elegível, compare a economia exibida e consulte os termos da loja se houver diferença. Cada chamada de API custa US$ 0,002, e o navegador oferece interativamente o mesmo cálculo determinístico.
Casos de uso
Comparar cupons concorrentes
Calcule uma oferta percentual e outra de valor fixo sobre o mesmo preço para descobrir qual economiza mais.
Revisar uma promoção da loja
Confirme a economia esperada e o preço exibido antes de publicar textos ou artes do cupom.
Testar cálculos do checkout
Crie resultados esperados determinísticos para cenários percentuais e fixos em testes de comércio eletrônico.
Perguntas frequentes
Quais tipos de cupom são aceitos?
Use percent para desconto percentual ou fixed para desconto monetário fixo.
Um cupom pode tornar o preço final negativo?
Não. A economia fixa é limitada ao preço original, então o mínimo é $0.00.
Como a economia percentual é arredondada?
Ela é arredondada ao centavo mais próximo, com empates para cima, usando aritmética inteira.
O cálculo inclui impostos ou frete?
Não. Informe o preço ou subtotal elegível exato definido pelos termos da loja.
Quanto custa calcular pela API?
Cada cálculo pela API custa US$ 0,002.
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/life/coupon-savings \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"price":"79.99","discount_type":"percent","discount_value":"15"}'const res = await fetch("https://api.kit.forhosting.com/life/coupon-savings", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"price": "79.99",
"discount_type": "percent",
"discount_value": "15"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/life/coupon-savings",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"price": "79.99",
"discount_type": "percent",
"discount_value": "15"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/life/coupon-savings", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"price":"79.99","discount_type":"percent","discount_value":"15"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"price":"79.99","discount_type":"percent","discount_value":"15"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/coupon-savings", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"price": "79.99",
"discount_type": "percent",
"discount_value": "15"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "life.coupon_savings",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |