Ressources · 94
E-commerce : fiabiliser montants, monnaies et arrondis
Rapprocher prix affiché, commande, paiement et remboursements sans confondre unités.
· 3 min
Ce que ce guide permet
- Attacher une monnaie au montant
- Respecter l’unité du prestataire
- Séparer calcul et présentation
- Fixer les règles d’arrondi
- Réconcilier les sorties
Contrôle express
- Toutes les monnaies ont-elles deux décimales ?
- Intl.NumberFormat calcule-t-il le prix ?
- Comment répartir un centime restant ?
Méthode pas à pas
- 01
Attacher une monnaie au montant
Stockez valeur et code monétaire ensemble. Distinguez monnaie présentée et monnaie de règlement. Ne sommez pas euros et yens ; une conversion exige taux, date et règle explicites.
Livrable : Montants associés à leur monnaie.
- 02
Respecter l’unité du prestataire
Stripe attend les montants dans l’unité définie pour la monnaie. Vérifiez ses exceptions. Pour 10,99 USD, l’exemple documenté utilise 1099 ; pour 10 JPY, 10. Ne multipliez donc pas systématiquement par 100.
Livrable : Contrat d’unité par opération.
- 03
Séparer calcul et présentation
Employez une représentation décimale exacte ou des entiers adaptés au contrat. Le formatage localisé n’établit pas la valeur de référence. N’interprétez pas une chaîne affichée avec séparateurs comme un montant technique fiable.
Livrable : Valeurs exactes et affichage séparés.
- 04
Fixer les règles d’arrondi
Documentez arrondi par ligne ou au total, allocation des remises et résidus. Faites valider taxes et documents selon le contexte applicable. Rejouez quantités multiples, remboursements partiels et valeurs limites sans changer discrètement de règle.
Livrable : Règle d’arrondi et cas limites.
- 05
Réconcilier les sorties
Comparez monnaie, unités, total et identifiant entre panier, commande, notification, facture et remboursement. Contrôlez le montant côté serveur. Un écran correctement formaté peut masquer une demande de paiement incorrecte.
Livrable : Rapprochement entre les systèmes.
Scénarios fictifs de recette
Ces cas proposés ne sont pas des observations de clients. Adaptez les données, permissions et critères à votre environnement autorisé.
| Situation à provoquer | Résultat à vérifier | Preuve à conserver |
|---|---|---|
| Trois lignes ont chacune un montant avant arrondi de 0,335 dans un exemple fictif. | Définir la précision et la règle applicable avant de comparer somme des lignes arrondies et arrondi du total ; ne pas choisir selon le résultat souhaité. | Montants exacts, ordre des opérations et règle documentée. |
| Une API reçoit un montant dans une autre monnaie. | Vérifier monnaie, unité attendue et exceptions du fournisseur ; ne pas multiplier universellement par 100. | Contrat du moyen de paiement et payload sans données sensibles. |
| Deux remboursements partiels concernent la même capture. | Rapprocher montants confirmés, monnaie et historique pour éviter un dépassement ou un doublon. | Identifiants stables, états et total remboursé confirmé. |
Fiche de travail à réutiliser
À compléter avec vos observations autorisées. Ces champs constituent une trame de travail, pas des résultats observés.
| Champ | Information à consigner |
|---|---|
| Montant | Valeur exacte, monnaie et unité |
| Calcul | Quantités, remises, taxes et arrondi |
| Paiement | Contrat, montant envoyé et reçu |
| Recette | Écarts, cas limites et remboursements |
Exemple d’application
Situation illustrative
Exemple fictif en EUR : partager 10,00 € en trois lignes de 3,33 € laisse un centime non réparti.
Décision et preuve attendue
La règle retenue attribue ce centime à une ligne déterminée et conserve un total de 10,00 €. Ce cas n’est pas une règle fiscale universelle.
Distinguer les mécanismes
| Mécanisme | Utilité | Point de vigilance |
|---|---|---|
| Valeur de calcul | Faire une opération exacte | Précision et arrondi documentés |
| Montant API | Respecter le contrat du prestataire | Unité spécifique à la monnaie |
| Affichage localisé | Présenter prix et symbole | Ne constitue pas le calcul comptable |
Indicateurs de pilotage
| Indicateur | Ce qu’il mesure | Première action |
|---|---|---|
| Écarts de total | Différences entre systèmes | Rapprocher avant confirmation |
| Cas monétaires | Monnaies prises en charge | Tester chaque contrat distinct |
| Résidus | Écarts de répartition | Appliquer la règle documentée |
Erreurs fréquentes
- Précision et arrondi documentés
- Unité spécifique à la monnaie
- Ne constitue pas le calcul comptable
Questions fréquentes
Toutes les monnaies ont-elles deux décimales ?
Non. Consultez le contrat actuel du prestataire et les règles de la monnaie, y compris les exceptions par opération.
Intl.NumberFormat calcule-t-il le prix ?
Il produit un affichage localisé ; définissez auparavant valeur, taxes, remises et règles de calcul.
Comment répartir un centime restant ?
Utilisez une règle d’allocation validée et reproductible. Conservez total de référence et détail des lignes.
Références officielles
Date de consultation des références : . La méthode et la fiche de travail proposent des contrôles à adapter à votre contexte ; elles ne constituent pas une certification.
Pour aller plus loin
Analyses associées
