Calculateur pourboire et partage

Entrées : addition, pourcentage de pourboire et nombre de personnes

Les additions négatives et les pourcentages de pourboire négatifs échouent à la validation car ils ne décrivent pas une note normale. Tip percent est plafonné à une borne supérieure généreuse pour que des fautes de frappe multipliées par mille échouent bruyamment au lieu d'inventer des totaux absurdes. People doit être un nombre entier : les têtes fractionnaires à table ne sont pas modélisées. Toute la validation a lieu avant tout calcul monétaire, de sorte que les mauvaises requêtes ne produisent jamais de lignes de pourboire à moitié remplies. Envoyez un corps JSON avec trois champs obligatoires. L'addition (bill) est le montant hors pourboire sous forme de nombre fini non négatif ou de chaîne numérique ; les alias amount, bill_amount et subtotal sont acceptés lorsque votre client nomme déjà le champ autrement. Tip percent est le taux de gratuity exprimé en pourcentage de cette addition—par exemple dix-huit signifie dix-huit pour cent—et non une fraction décimale ; les alias tip, percent, gratuity et tip_pct correspondent à la même valeur afin que les constructeurs de formulaires conservent des libellés familiers. People est le nombre entier de convives ou de colocs qui paieront des parts égales ; les alias persons, n, party, party_size et split sont pris en charge. Lorsque people vaut zéro, le moteur lève invalid_input avec un message indiquant qu'au moins une personne est requise—le piège classique de division par zéro des calculateurs de partage. L'absence de l'un des trois champs échoue aussi avec invalid_input en nommant la clé manquante.

Comment le pourboire, le total et la part par personne sont calculés

Le pourboire est bill multiplié par tip percent divisé par cent. La réponse renvoie le bill, tip percent et people normalisés, puis tip, total et per_person, plus currency_decimals égal à deux et method égal à tip_split pour un branchement client stable. Utilisez tip seul lorsque vous n'avez besoin que de la ligne de gratuity ; utilisez total lorsqu'une application de paiement a besoin du montant facturé ; utilisez per_person lorsqu'un chat de groupe a besoin de la contribution de chacun. Des entrées identiques produisent toujours un JSON identique car le chemin est de l'arithmétique pure sans réseau, sans graine aléatoire et sans horloge murale.

Usage de l'API, tarification, flux et limites pratiques

Utilisez l'API prépayée lorsqu'un bot d'hospitalité, un suiveur de dépenses, un planificateur de voyage ou un assistant de point de vente a besoin d'un contrat KIT stable à $0.002 par élément réussi ; les échecs de validation ne consomment jamais le solde après le rejet du moteur. Les auteurs qui livrent des SDK peuvent mapper tip, total et per_person directement dans les interfaces de reçu et les messages de règlement.