ForHosting KIT · Ferramentas para dev

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á.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

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.

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.

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.

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.

POSThttps://api.kit.forhosting.com/life/coupon-savings

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

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"}'
{
  "price": "79.99",
  "discount_type": "percent",
  "discount_value": "15"
}
{
  "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.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →