Ressources · 94

E-commerce : fiabiliser montants, monnaies et arrondis

Rapprocher prix affiché, commande, paiement et remboursements sans confondre unités.

· 10 min

Laboratoire d’analyse fictif sans personnes : trois blocs en laiton, cadran vierge, feuilles et dossier bordeaux Illustration éditoriale générée par IA

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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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 à provoquerRésultat à vérifierPreuve à 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

  1. Relevez devise et unité attendue par le fournisseur.
  2. Testez JPY et une devise à deux décimales.
  3. Conservez montants stockés, affichés et arrondis comparés.

Stripe — Currency amounts

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.

ChampInformation à consigner
MontantValeur exacte, monnaie et unité
CalculQuantités, remises, taxes et arrondi
PaiementContrat, 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écanismeUtilitéPoint de vigilance
Valeur de calculFaire une opération exactePrécision et arrondi documentés
Montant APIRespecter le contrat du prestataireUnité spécifique à la monnaie
Affichage localiséPrésenter prix et symboleNe constitue pas le calcul comptable

Indicateurs de pilotage

IndicateurCe qu’il mesurePremière action
Écarts de totalDifférences entre systèmesRapprocher avant confirmation
Cas monétairesMonnaies prises en chargeTester chaque contrat distinct
RésidusÉcarts de répartitionAppliquer 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

Neuf profils : monnaie, opération et unité ensemble
ProfilPérimètre documentaireDécimales de représentation eMultiplicateur 10ᵉPas entier requisExemple fictif
Adyen · EURAPI en unités mineures, hors Terminal API2100110.99 → 1099
Adyen · JPYAPI en unités mineures, hors Terminal API011500 → 500
Adyen · KWDAPI en unités mineures, hors Terminal API3100010.123 → 123
Stripe · ISKReprésentation des montants ISK ; fractions d’ISK non permises21001005 → 500 ; 5.25 refusé
Stripe · UGXMontants facturés UGX ; fractions d’UGX non permises21001005 → 500 ; 5.25 refusé
Stripe · HUF · chargeMontants facturés en HUF2100110.45 → 1045
Stripe · HUF · payoutVersements manuels en HUF ; montants entiers requis210010010 → 1000 ; 10.45 refusé
Stripe · TWD · chargeMontants facturés en TWD21001800.45 → 80045
Stripe · TWD · payoutVersements manuels en TWD ; montants entiers requis2100100800 → 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.

Chemin de conversion vérifiable

Chemin de conversion vérifiable
ÉtapeContrôle
1 · Lire la chaîneSé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 eComplé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 pasL’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 exactementTotal 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.

Trois expériences d’arrondi distinctes de la conversion exacte
Montant exact × quantitéSomme des lignes arrondiesArrondi du total exactÉcart lignes − total
0.335 × 30.34 × 3 = 1.021.005 → 1.01+0.01
0.005 × 20.01 × 2 = 0.020.010 → 0.01+0.01
0.3333 × 30.33 × 3 = 0.990.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
Deux décimales, trois unités
Profil / montant / quantitéLecture attendue
adyen-eur / 10.99 / 31099 unités mineures par article ; total 3297, soit 32.97 EUR.
M02 · JPY sans multiplication par 100
JPY sans multiplication par 100
Profil / montant / quantitéLecture attendue
adyen-jpy / 500 / 2500 unités de représentation par article ; total 1000, soit 1000 JPY.
M03 · Trois décimales en KWD
Trois décimales en KWD
Profil / montant / quantitéLecture attendue
adyen-kwd / 0.123 / 3123 unités mineures par article ; total 369, soit 0.369 KWD.
M04 · Fraction non représentable en JPY
Fraction non représentable en JPY
Profil / montant / quantitéLecture attendue
adyen-jpy / 10.5 / 1Refus de précision : 10.5 ne devient pas 10 ou 11 silencieusement. Aucun montant entier n’est produit.
M05 · Aucun arrondi implicite
Aucun arrondi implicite
Profil / montant / quantitéLecture attendue
adyen-eur / 10.995 / 1Refus de précision : ce lecteur exact ne choisit aucune règle pour la troisième décimale.
M06 · ISK : échelle et pas distincts
ISK : échelle et pas distincts
Profil / montant / quantitéLecture attendue
stripe-isk / 5 / 25 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
ISK : deux décimales ne suffisent pas
Profil / montant / quantitéLecture attendue
stripe-isk / 5.25 / 1Refus du pas : la représentation serait fractionnaire en ISK. Le contrat exige un entier divisible par 100.
M08 · Virgule de présentation refusée
Virgule de présentation refusée
Profil / montant / quantitéLecture attendue
adyen-eur / 10,99 / 1Saisie technique refusée. Le séparateur accepté est le point ASCII ; le lecteur ne devine pas une locale.
M09 · Grand entier conservé exactement
Grand entier conservé exactement
Profil / montant / quantitéLecture attendue
adyen-kwd / 999999999999.999 / 99Total 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
Zéro exact, aucune éligibilité déduite
Profil / montant / quantitéLecture attendue
adyen-eur / 0.000 / 1Conversion 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
Zéros supplémentaires sans perte
Profil / montant / quantitéLecture attendue
adyen-jpy / 10.000 / 3Les décimales supplémentaires sont toutes nulles : conversion exacte 10 ; total 30 JPY.
M12 · Quantité non canonique refusée
Quantité non canonique refusée
Profil / montant / quantitéLecture attendue
adyen-eur / 10.99 / 03Le 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
UGX : représentation par cent
Profil / montant / quantitéLecture attendue
stripe-ugx / 5 / 15 UGX se représente par 500, avec un pas de 100.
M14 · UGX fractionnaire refusé
UGX fractionnaire refusé
Profil / montant / quantitéLecture attendue
stripe-ugx / 5.25 / 1525 respecte l’échelle mais ne se divise pas par 100 ; la fraction d’UGX est refusée.
M15 · HUF : montant facturé à deux décimales
HUF : montant facturé à deux décimales
Profil / montant / quantitéLecture attendue
stripe-huf-charge / 10.45 / 110.45 HUF donne 1045 pour une opération de facturation.
M16 · Même HUF, versement manuel différent
Même HUF, versement manuel différent
Profil / montant / quantitéLecture attendue
stripe-huf-payout / 10.45 / 11045 n’est pas divisible par 100 ; cette valeur est refusée pour le versement manuel.
M17 · Versement manuel entier en HUF
Versement manuel entier en HUF
Profil / montant / quantitéLecture attendue
stripe-huf-payout / 10 / 110 HUF donne 1000, divisible par 100.
M18 · TWD : montant facturé à deux décimales
TWD : montant facturé à deux décimales
Profil / montant / quantitéLecture attendue
stripe-twd-charge / 800.45 / 1800.45 TWD donne 80045 pour une opération de facturation.
M19 · Même TWD, versement manuel différent
Même TWD, versement manuel différent
Profil / montant / quantitéLecture attendue
stripe-twd-payout / 800.45 / 180045 n’est pas divisible par 100 ; cette valeur est refusée pour le versement manuel.
M20 · Versement manuel entier en TWD
Versement manuel entier en TWD
Profil / montant / quantitéLecture attendue
stripe-twd-payout / 800 / 1800 TWD donne 80000, divisible par 100.

Recetter le contrat monétaire de bout en bout

Recetter le contrat monétaire de bout en bout
Contrôle proposéTrace utile
PérimètrePrestataire, API, opération, version documentaire et monnaie. Ne pas étendre une règle d’encaissement à tous les versements.
Valeur de référenceMontant exact et code monétaire liés ; distinguer unité de calcul, entier technique et présentation.
PrécisionCas aux limites, fractions non représentables, zéros et nombres dépassant la précision entière d’un flottant.
ArrondiRègle et moment d’application ; comparer ligne, total et allocation sans changer de convention après observation.
RapprochementValeurs 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.