ForHosting KIT · Outils pour développeurs

Calculateur de monnaie à rendre

Le calculateur de monnaie à rendre détermine exactement la somme qu’un client doit récupérer après son achat.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Indiquez le total final et le montant en espèces remis, dans la même devise. L’outil effectue une soustraction exacte à deux décimales et évite les surprises liées aux nombres flottants. Il convient aux caisses, marchés, événements scolaires, guichets et à toute transaction exigeant un résultat rapide et vérifiable.

Saisissez les deux montants de la transaction

Commencez par le total final de l’achat, après application des taxes, remises, coupons, acomptes et autres ajustements. Indiquez ensuite la somme en espèces réellement remise par le client. Les deux valeurs doivent être exprimées dans la même devise et comporter au maximum deux décimales. Par exemple, si un achat coûte 13.47 et que le client remet 20.00, saisissez ces valeurs comme total de l’achat et somme remise. N’indiquez pas une autorisation de carte, le solde d’une carte-cadeau ou la valeur d’un paiement mixte, sauf si les espèces doivent à elles seules couvrir la totalité affichée. Le calculateur accepte zéro, ce qui est utile pour une transaction entièrement remisée, mais aucun montant négatif. L’API reconnaît également des alias explicites, même si amount_tendered et purchase_total facilitent la compréhension ultérieure des enregistrements. Vérifiez le reçu avant le calcul : une soustraction exacte ne peut pas corriger un total sans taxe ou comprenant un mauvais article. Des entrées distinctes permettent au caissier, au client ou à un auditeur de reproduire facilement le résultat.

Comprenez le calcul de la monnaie

La règle est la suivante : la monnaie à rendre est égale à la somme remise moins le total de l’achat. Malgré la simplicité de cette formule, les montants exigent un traitement décimal rigoureux. Le calculateur convertit chaque valeur en un nombre entier de centièmes avant la soustraction, puis reconvertit le résultat pour l’affichage. Ainsi, 20.00 moins 13.47 donne 6.53 sans imprécision binaire. La réponse contient la somme remise normalisée, le total normalisé, la valeur numérique change_due, la chaîne change_due_formatted toujours affichée avec deux décimales et la formule appliquée. Un résultat de 0.00 signifie que le client a payé le montant exact et qu’aucune espèce ne doit être rendue. Si la somme remise est inférieure au total, il s’agit d’un manque et non de monnaie ; l’outil refuse alors l’entrée et indique la somme manquante. Cette distinction évite de confondre un nombre négatif avec de l’argent à rendre. L’outil ne choisit ni pièces ni billets, car les coupures dépendent de la devise, du pays et du contenu de la caisse. Il fournit uniquement le montant arithmétique dû au client.

Utilisez le résultat en toute sécurité à la caisse

Annoncez la monnaie formatée, gardez les espèces reçues bien visibles et recomptez l’argent rendu devant le client avant de ranger son paiement. Une méthode courante part du total de l’achat et ajoute pièces et billets jusqu’à atteindre la somme remise ; le résultat calculé constitue une cible indépendante. Pour un achat de 13.47 payé avec 20.00, cette cible est 6.53, quelles que soient les coupures disponibles. Si vous intégrez l’API à un système de point de vente, conservez les deux entrées avec la réponse afin qu’un rapprochement ultérieur montre précisément le calcul effectué. Chaque requête coûte $0.002 ; le calculateur du navigateur permet un contrôle manuel immédiat. Le calcul est déterministe, n’interroge aucun réseau et ne déduit ni symbole monétaire ni taux de change. Respectez toujours les règles locales d’arrondi des espèces lorsque la plus petite pièce en circulation vaut plus d’un centième d’unité. Dans ce cas, appliquez d’abord au total l’arrondi imposé par la loi, puis utilisez le résultat comme objectif de monnaie.

Vérifier la monnaie à une caisse

Confirmez la somme à rendre lorsqu’un client règle en espèces le total final de son reçu.

Tenir une caisse temporaire

Donnez aux bénévoles d’une collecte, d’un marché ou d’une fête scolaire une méthode fiable de calcul.

Automatiser un calcul de point de vente

Envoyez à l’API les espèces remises et le total, puis conservez le résultat déterministe pour le rapprochement.

Quelle formule le calculateur utilise-t-il ?

Il applique change_due = amount_tendered - purchase_total après conversion des deux montants en centièmes entiers.

Que se passe-t-il si le client ne remet pas assez d’espèces ?

La requête renvoie une erreur de saisie précisant la somme manquante, car un paiement insuffisant ne constitue pas de la monnaie.

Puis-je utiliser n’importe quelle devise ?

Oui, si les deux valeurs utilisent la même devise et si celle-ci s’exprime avec deux décimales. Aucun symbole monétaire n’est ajouté au résultat.

L’outil indique-t-il les pièces et billets à rendre ?

Non. Il calcule la monnaie totale ; le choix des coupures dépend de la devise et du contenu de la caisse.

Quel est le prix d’un calcul par API ?

Chaque requête API coûte $0.002. Vous pouvez aussi utiliser le calculateur dans le navigateur pour un contrôle manuel.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

POSThttps://api.kit.forhosting.com/life/change-due

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

curl -X POST https://api.kit.forhosting.com/life/change-due \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount_tendered":20,"purchase_total":13.47}'
{
  "amount_tendered": 20,
  "purchase_total": 13.47
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "life.change_due",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →