Calculadora de pagamento com vale-presente e dinheiro
Esta calculadora de vale-presente e dinheiro mostra exatamente como uma compra é dividida quando o vale cobre uma parte, o total ou mais do que o total.
Executar grátis
Informe o valor da compra e o saldo disponível no vale. A calculadora aplica o máximo possível desse saldo, indica o restante a pagar em dinheiro e mostra quanto ainda ficará disponível no vale-presente. Ela é útil no caixa, no planejamento de uma compra ou ao explicar um pagamento dividido para outra pessoa.
Informe a compra e o saldo disponível
Comece pelo valor total da compra antes de aplicar qualquer crédito do vale-presente. Em seguida, informe o saldo que está realmente disponível para essa transação. Os dois valores precisam estar na mesma moeda, pois a calculadora divide quantias, mas não faz conversão cambial. Digite valores monetários comuns com no máximo duas casas decimais, como 42, 42.50 ou 19.99. O valor da compra deve ser maior que zero, enquanto um saldo zero no vale é válido e significa apenas que toda a compra será paga em dinheiro. Se o vale já tiver sido utilizado, use o saldo disponível atual, e não o valor nominal original. Impostos, frete, descontos e gorjetas devem estar incluídos no valor da compra sempre que fizerem parte do total no caixa. O cálculo não determina se uma loja aceita pagamentos combinados nem se determinada taxa pode ser paga com vale-presente. Ele responde à questão matemática depois que o total a pagar e o saldo utilizável são conhecidos.
Entenda como a divisão é calculada
A calculadora usa o vale-presente primeiro, até o menor valor entre o total da compra e o saldo disponível. Se uma compra custa 80 e o vale tem 30, a parte paga com o vale é 30 e a parte em dinheiro é 50. Se a mesma compra for combinada com um saldo de 100, o vale cobre os 80 por completo, nenhum dinheiro é necessário e restam 20 no vale. Essa regra impede que o uso do vale ou o pagamento restante fique negativo. Os resultados são calculados em centavos inteiros para evitar artefatos conhecidos de ponto flutuante, como a exibição de 0.30000000000000004. O valor retornado da compra também serve como referência ao lado das três quantias calculadas. Para conferir, o valor usado do vale somado ao dinheiro sempre corresponde ao valor da compra. O valor utilizado mais o saldo restante também corresponde sempre ao saldo inicial. Essas duas relações facilitam verificar o resultado ou incorporá-lo a uma prévia de checkout.
Use o resultado no caixa ou em um fluxo de trabalho
Considere o resultado como um plano de pagamento, e não como uma autorização da loja. O valor usado do vale-presente é a quantia a ser solicitada do vale. O valor em dinheiro é a parte que precisará vir de dinheiro, cartão de débito, cartão de crédito ou outro meio aceito. O saldo restante é o que deve continuar disponível após uma transação bem-sucedida, desde que não haja bloqueios, taxas ou restrições específicas do estabelecimento. Antes de pagar, confirme se a loja permite combinar um vale-presente com outro método e se o checkout aplica o vale na ordem esperada. Para uso automatizado, envie os mesmos dois campos numéricos à API e armazene os quatro valores retornados com um orçamento, carrinho ou resposta de atendimento. Cada solicitação custa US$ 0,002; a versão no navegador pode ser usada sem cobrança. Como o cálculo é determinístico e não usa serviços de rede, entradas idênticas geram resultados idênticos, algo útil no planejamento de compras e em testes reproduzíveis.
Casos de uso
Planejar uma compra antes do caixa
Veja quanto ainda será necessário em dinheiro ou cartão depois de utilizar o saldo disponível do vale-presente.
Explicar um pagamento dividido
Apresente a um cliente ou familiar uma divisão clara entre o vale-presente, o dinheiro e o saldo que restará.
Visualizar a lógica do checkout
Use o resultado da API ao testar um carrinho, orçamento, ferramenta de reembolso ou fluxo de atendimento que aplica vales primeiro.
Perguntas frequentes
Como a calculadora decide quanto usar do vale-presente?
Ela usa o menor valor entre a compra e o saldo disponível, sem aplicar mais do que a compra custa nem mais do que o vale contém.
O que acontece se o saldo for maior que a compra?
O vale-presente cobre toda a compra, o valor em dinheiro fica em zero e o crédito não utilizado aparece como saldo restante.
O que acontece se o vale-presente estiver sem saldo?
Um saldo zero é aceito. O valor usado do vale fica em zero e toda a compra é atribuída ao dinheiro.
Posso informar moedas diferentes nos dois valores?
Não. Ambos os valores devem estar na mesma moeda. Esta calculadora divide um pagamento e não realiza conversão cambial.
Isso garante que a loja aceitará um pagamento dividido?
Não. As regras variam. Confirme se a loja permite combinar um vale-presente com dinheiro ou outro meio de pagamento.
Quanto custa usar a API?
Cada solicitação à API custa US$ 0,002. A calculadora também pode ser usada gratuitamente no navegador.
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/gift-card-split \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"purchase_amount":86.4,"gift_card_balance":50}'const res = await fetch("https://api.kit.forhosting.com/life/gift-card-split", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"purchase_amount": 86.4,
"gift_card_balance": 50
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/life/gift-card-split",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"purchase_amount": 86.4,
"gift_card_balance": 50
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/life/gift-card-split", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"purchase_amount":86.4,"gift_card_balance":50}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"purchase_amount":86.4,"gift_card_balance":50}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/gift-card-split", 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
{
"purchase_amount": 86.4,
"gift_card_balance": 50
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "life.gift_card_split",
"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. |