Ressources · 94
E-commerce : fiabiliser montants, monnaies et arrondis
Rapprocher prix affiché, commande, paiement et remboursements sans confondre unités.
· 10 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é. |
Cas de recette à reproduire
Exemple fictif : ces données ne décrivent aucun client ni résultat réel.
Voir les données du cas
{
"currency": "JPY",
"display_amount": 1000,
"stripe_amount": 1000,
"incorrect_times_100": 100000
}Décision attendue
Pour 1 000 JPY, le montant Stripe est 1000. Ne pas multiplier automatiquement toutes les devises par 100.
Procédure de vérification
- Relevez devise et unité attendue par le fournisseur.
- Testez JPY et une devise à deux décimales.
- Conservez montants stockés, affichés et arrondis comparés.
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.
Précision des montants API et unités exactes
Une valeur affichée, un montant de calcul et l’entier envoyé à une API remplissent des rôles différents. Ce complément rend explicites l’échelle décimale, le multiplicateur et le pas autorisé. Le lecteur ci-dessous vérifie une représentation exacte avant de multiplier par une quantité : il ne corrige pas une précision excessive par un arrondi caché.
Documentation Adyen et Stripe consultée le 6 novembre 2026. Neuf profils limités expliquent les contrats d’unité ; ce tableau n’est ni un répertoire complet des monnaies ni une liste de moyens de paiement disponibles. Les montants et scénarios sont des exemples fictifs CIE.
Neuf profils : monnaie, opération et unité ensemble
| Profil | Périmètre documentaire | Décimales de représentation e | Multiplicateur 10ᵉ | Pas entier requis | Exemple fictif |
|---|---|---|---|---|---|
| Adyen · EUR | API en unités mineures, hors Terminal API | 2 | 100 | 1 | 10.99 → 1099 |
| Adyen · JPY | API en unités mineures, hors Terminal API | 0 | 1 | 1 | 500 → 500 |
| Adyen · KWD | API en unités mineures, hors Terminal API | 3 | 1000 | 1 | 0.123 → 123 |
| Stripe · ISK | Représentation des montants ISK ; fractions d’ISK non permises | 2 | 100 | 100 | 5 → 500 ; 5.25 refusé |
| Stripe · UGX | Montants facturés UGX ; fractions d’UGX non permises | 2 | 100 | 100 | 5 → 500 ; 5.25 refusé |
| Stripe · HUF · charge | Montants facturés en HUF | 2 | 100 | 1 | 10.45 → 1045 |
| Stripe · HUF · payout | Versements manuels en HUF ; montants entiers requis | 2 | 100 | 100 | 10 → 1000 ; 10.45 refusé |
| Stripe · TWD · charge | Montants facturés en TWD | 2 | 100 | 1 | 800.45 → 80045 |
| Stripe · TWD · payout | Versements manuels en TWD ; montants entiers requis | 2 | 100 | 100 | 800 → 80000 ; 800.45 refusé |
Les trois profils Adyen suivent sa table des décimales pour les API en unités mineures, hors Terminal API. Stripe conserve deux décimales de représentation pour ISK et UGX tout en interdisant leurs fractions : l’entier doit être divisible par 100. Pour HUF et TWD, Stripe distingue les montants facturés à deux décimales des versements manuels, qui imposent un entier divisible par 100. Choisissez toujours le profil de l’opération ; le nombre de décimales de la monnaie ne suffit pas. Aucun taux de change n’est décrit.
Adyen · Currency codes and minor units · Provider documentation · reviewed 2026-11-06
Stripe · Supported currencies and special cases · Provider documentation · reviewed 2026-11-06
Atelier de représentation exacte des montants
Choisissez un profil, un montant unitaire et une quantité. Le résultat montre le multiplicateur, le pas, l’entier unitaire, l’entier total et leur représentation décimale fixe. Les opérations utilisent des entiers exacts ; aucune somme de nombres flottants ne détermine le résultat. Les zéros décimaux supplémentaires sont acceptés uniquement lorsqu’ils ne changent pas la valeur.
Profil de saisie propre à cet atelier : montant positif ou nul, de 1 à 12 chiffres avant le point et de 0 à 6 après ; point ASCII, sans espaces, signe, séparateur de milliers, exposant ni zéro initial superflu. Quantité entière de 1 à 99 sans zéro initial. Ces bornes sont pédagogiques et ne sont pas des limites Adyen ou Stripe.
Aucun paiement, appel API, conversion de devise, import, stockage ni export n’est réalisé. Un résultat exact ne prouve ni disponibilité du moyen de paiement, ni respect des minima ou maxima, ni autorisation d’un montant, ni conformité d’une facture. Le lecteur n’évalue pas taxes, remises, remboursements négatifs, change, frais, règlement ou règles d’arrondi applicables.
Saisie technique avec point ASCII, jusqu’à 12 chiffres entiers et 6 décimales, sans séparateur de milliers ni espaces. Quantité : 1–99. Aucun arrondi implicite.
Résultat de représentation exacte
Chemin de conversion vérifiable
| Étape | Contrôle |
|---|---|
| 1 · Lire la chaîne | Séparer partie entière et fraction sans convertir la valeur en flottant. Une chaîne affichée selon une locale doit être traitée en amont par un parseur explicite. |
| 2 · Appliquer l’échelle e | Compléter la fraction jusqu’à e. Au-delà, n’accepter que des zéros ; une décimale non nulle supplémentaire entraîne un refus de précision. |
| 3 · Vérifier le pas | L’entier obtenu doit être divisible par le pas du profil. Une échelle correcte peut encore produire une valeur interdite, comme une fraction d’ISK dans le profil Stripe. |
| 4 · Multiplier exactement | Total entier = entier unitaire × quantité. Réinsérer le point à e positions pour la représentation technique ; cela n’est pas un affichage client localisé. |
Trois expériences d’arrondi distinctes de la conversion exacte
Ces calculs fictifs CIE choisissent explicitement l’arrondi au plus proche avec demi vers le haut, uniquement sur des valeurs non négatives et à deux décimales. Cette convention est choisie pour l’exercice ; les deux prestataires ne sont pas présentés comme l’imposant. Dans un profil à deux décimales, le lecteur interactif refuse ces fractions au lieu de leur appliquer cette convention.
| Montant exact × quantité | Somme des lignes arrondies | Arrondi du total exact | Écart lignes − total |
|---|---|---|---|
| 0.335 × 3 | 0.34 × 3 = 1.02 | 1.005 → 1.01 | +0.01 |
| 0.005 × 2 | 0.01 × 2 = 0.02 | 0.010 → 0.01 | +0.01 |
| 0.3333 × 3 | 0.33 × 3 = 0.99 | 0.9999 → 1.00 | −0.01 |
Une différence d’arrondi signale un ordre d’opérations différent ; elle ne désigne pas à elle seule le résultat légal ou commercial correct. Définissez la règle avant le calcul et conservez le total de référence ainsi que toute allocation de résidu.
Douze scénarios expliqués, lisibles sans JavaScript
M01 · Deux décimales, trois unités
| Profil / montant / quantité | Lecture attendue |
|---|---|
| adyen-eur / 10.99 / 3 | 1099 unités mineures par article ; total 3297, soit 32.97 EUR. |
M02 · JPY sans multiplication par 100
| Profil / montant / quantité | Lecture attendue |
|---|---|
| adyen-jpy / 500 / 2 | 500 unités de représentation par article ; total 1000, soit 1000 JPY. |
M03 · Trois décimales en KWD
| Profil / montant / quantité | Lecture attendue |
|---|---|
| adyen-kwd / 0.123 / 3 | 123 unités mineures par article ; total 369, soit 0.369 KWD. |
M04 · Fraction non représentable en JPY
| Profil / montant / quantité | Lecture attendue |
|---|---|
| adyen-jpy / 10.5 / 1 | Refus de précision : 10.5 ne devient pas 10 ou 11 silencieusement. Aucun montant entier n’est produit. |
M05 · Aucun arrondi implicite
| Profil / montant / quantité | Lecture attendue |
|---|---|
| adyen-eur / 10.995 / 1 | Refus de précision : ce lecteur exact ne choisit aucune règle pour la troisième décimale. |
M06 · ISK : échelle et pas distincts
| Profil / montant / quantité | Lecture attendue |
|---|---|
| stripe-isk / 5 / 2 | 5 ISK est représenté par 500 ; deux unités donnent 1000, soit 10.00 dans la représentation technique à deux décimales. |
M07 · ISK : deux décimales ne suffisent pas
| Profil / montant / quantité | Lecture attendue |
|---|---|
| stripe-isk / 5.25 / 1 | Refus du pas : la représentation serait fractionnaire en ISK. Le contrat exige un entier divisible par 100. |
M08 · Virgule de présentation refusée
| Profil / montant / quantité | Lecture attendue |
|---|---|
| adyen-eur / 10,99 / 1 | Saisie technique refusée. Le séparateur accepté est le point ASCII ; le lecteur ne devine pas une locale. |
M09 · Grand entier conservé exactement
| Profil / montant / quantité | Lecture attendue |
|---|---|
| adyen-kwd / 999999999999.999 / 99 | Total entier 98999999999999901, soit 98999999999999.901 KWD. Démonstration arithmétique : ce montant dépasse la précision entière sûre d’un Number JavaScript et ne démontre aucune limite API autorisée. |
M10 · Zéro exact, aucune éligibilité déduite
| Profil / montant / quantité | Lecture attendue |
|---|---|
| adyen-eur / 0.000 / 1 | Conversion arithmétique 0, représentation 0.00. Cela ne démontre pas qu’un paiement nul est accepté. |
M11 · Zéros supplémentaires sans perte
| Profil / montant / quantité | Lecture attendue |
|---|---|
| adyen-jpy / 10.000 / 3 | Les décimales supplémentaires sont toutes nulles : conversion exacte 10 ; total 30 JPY. |
M12 · Quantité non canonique refusée
| Profil / montant / quantité | Lecture attendue |
|---|---|
| adyen-eur / 10.99 / 03 | Le profil de saisie CIE exige un entier ASCII de 1 à 99 sans zéro initial. Ce refus de syntaxe n’est pas une règle de paiement du prestataire. |
M13 · UGX : représentation par cent
| Profil / montant / quantité | Lecture attendue |
|---|---|
| stripe-ugx / 5 / 1 | 5 UGX se représente par 500, avec un pas de 100. |
M14 · UGX fractionnaire refusé
| Profil / montant / quantité | Lecture attendue |
|---|---|
| stripe-ugx / 5.25 / 1 | 525 respecte l’échelle mais ne se divise pas par 100 ; la fraction d’UGX est refusée. |
M15 · HUF : montant facturé à deux décimales
| Profil / montant / quantité | Lecture attendue |
|---|---|
| stripe-huf-charge / 10.45 / 1 | 10.45 HUF donne 1045 pour une opération de facturation. |
M16 · Même HUF, versement manuel différent
| Profil / montant / quantité | Lecture attendue |
|---|---|
| stripe-huf-payout / 10.45 / 1 | 1045 n’est pas divisible par 100 ; cette valeur est refusée pour le versement manuel. |
M17 · Versement manuel entier en HUF
| Profil / montant / quantité | Lecture attendue |
|---|---|
| stripe-huf-payout / 10 / 1 | 10 HUF donne 1000, divisible par 100. |
M18 · TWD : montant facturé à deux décimales
| Profil / montant / quantité | Lecture attendue |
|---|---|
| stripe-twd-charge / 800.45 / 1 | 800.45 TWD donne 80045 pour une opération de facturation. |
M19 · Même TWD, versement manuel différent
| Profil / montant / quantité | Lecture attendue |
|---|---|
| stripe-twd-payout / 800.45 / 1 | 80045 n’est pas divisible par 100 ; cette valeur est refusée pour le versement manuel. |
M20 · Versement manuel entier en TWD
| Profil / montant / quantité | Lecture attendue |
|---|---|
| stripe-twd-payout / 800 / 1 | 800 TWD donne 80000, divisible par 100. |
Recetter le contrat monétaire de bout en bout
| Contrôle proposé | Trace utile |
|---|---|
| Périmètre | Prestataire, API, opération, version documentaire et monnaie. Ne pas étendre une règle d’encaissement à tous les versements. |
| Valeur de référence | Montant exact et code monétaire liés ; distinguer unité de calcul, entier technique et présentation. |
| Précision | Cas aux limites, fractions non représentables, zéros et nombres dépassant la précision entière d’un flottant. |
| Arrondi | Règle et moment d’application ; comparer ligne, total et allocation sans changer de convention après observation. |
| Rapprochement | Valeurs et identifiants entre commande, demande, confirmation et remboursement ; vérifier aussi côté serveur. |
| Éligibilité | Vérifier séparément les contraintes actuelles du compte, du moyen de paiement et de l’opération avant toute transaction réelle. |
Pour diagnostiquer un écart, conservez d’abord le triplet monnaie, unité et opération. Un symbole correct à l’écran ne suffit pas : 500 peut représenter 500 JPY dans un profil et 5 ISK dans un autre. La représentation exacte et la règle d’acceptation du prestataire sont deux contrôles complémentaires.
Sources et crédits
Synthèse et calculs pédagogiques originaux CIE. Adyen et Stripe restent les éditeurs de leurs documentations ; aucune affiliation, certification ou garantie de transaction n’est indiquée. Les montants fictifs ne sont pas des statistiques ni des résultats clients. Réexaminer le contrat courant avant une intégration réelle.
Adyen · Currency codes and minor units · Provider documentation · reviewed 2026-11-06
SHA-256 : 558887aab2082ea9c937bdd1ec67eb27a3fd30098eda21107dea40a0d7f4beb0
Stripe · Supported currencies and special cases · Provider documentation · reviewed 2026-11-06
SHA-256 : e64bb9ab65e88a94c94fcc7bd8df1c1426d879e8020e7b2cc044b26bb6672929
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.
