ForHosting KIT · Ferramentas para dev

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.

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

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.

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.

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.

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/gift-card-split

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/gift-card-split \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"purchase_amount":86.4,"gift_card_balance":50}'
{
  "purchase_amount": 86.4,
  "gift_card_balance": 50
}
{
  "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.

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 →