Calculadora de gorjeta e divisão

Entradas: conta, percentual de gorjeta e contagem de pessoas

Contas negativas e percentuais de gorjeta negativos falham na validação porque não descrevem uma conta normal. Tip percent tem um teto superior generoso para que erros de digitação de mil vezes falhem de forma ruidosa em vez de inventar totais absurdos. People deve ser um número inteiro: cabeças fracionárias na mesa não são modeladas. Toda a validação ocorre antes de qualquer matemática monetária, de modo que pedidos ruins nunca produzem linhas de gorjeta pela metade. Envie um corpo JSON com três campos obrigatórios. A conta (bill) é o valor pré-gorjeta como número finito não negativo ou string numérica; os aliases amount, bill_amount e subtotal são aceitos quando o seu cliente já nomeia o campo de outra forma. Tip percent é a taxa de gratificação expressa como percentual dessa conta—por exemplo dezoito significa dezoito por cento—não uma fração decimal; os aliases tip, percent, gratuity e tip_pct mapeiam para o mesmo valor para que construtores de formulário mantenham rótulos familiares. People é a contagem inteira de comensais ou colegas de casa que pagarão partes iguais; os aliases persons, n, party, party_size e split são suportados. Quando people é zero, o motor lança invalid_input com a mensagem de que pelo menos uma pessoa é necessária—a clássica armadilha de divisão por zero das calculadoras de divisão. Faltar qualquer um dos três campos também falha com invalid_input nomeando a chave ausente.

Como gorjeta, total e parte por pessoa são calculados

A gorjeta é bill vezes tip percent dividido por cem. A resposta ecoa o bill, tip percent e people normalizados e depois devolve tip, total e per_person, mais currency_decimals igual a dois e method igual a tip_split para ramificação estável do cliente. Use tip sozinho quando só precisar da linha de gratificação; use total quando um app de pagamento precisar do valor cobrado; use per_person quando um chat em grupo precisar da contribuição de cada pessoa. Entradas idênticas sempre produzem JSON idêntico porque o caminho é aritmética pura sem rede, sem semente aleatória e sem relógio de parede.

Uso da API, preços, fluxos e limites práticos

Chame a calculadora gratuita de gorjeta e divisão no navegador para jantares, caronas, aluguéis de férias e pedidos de almoço do escritório sem instalar outro app. Mantenha os tamanhos de conta dentro de faixas comerciais ordinárias; valores extremamente grandes são rejeitados para que a matemática isolada permaneça limitada. A promessa do produto é divisão igual com um percentual de gorjeta explícito, não imposto itemizado, taxas de serviço nem costumes locais automáticos de gorjeta—isso pertence a ferramentas especializadas com outra intenção de SEO. Use a API pré-paga quando um bot de hospitalidade, rastreador de despesas, planejador de viagens ou auxiliar de ponto de venda precisar de um contrato KIT estável a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo após o motor rejeitar o pedido. Combine este endpoint com conversores de moeda só se você já souber os valores em uma única moeda—esta capacidade não converte FX nem aplica linhas de imposto. Autores que publicam SDKs podem mapear tip, total e per_person diretamente em interfaces de recibo e mensagens de acerto.