Professionnelle relisant des pièces de facturation fictives

Standards et continuité · Fiche de contrôle

Contrôler un montant entre offre et API de paiement

Le même montant traverse plusieurs systèmes. Chaque passage doit conserver sa devise et sa convention pour que la finance puisse expliquer les écarts.

Publié le . Mise à jour éditoriale le . Méthode éditoriale à adapter à votre produit et à votre organisation. Source de référence : Adyen : codes monétaires et unités mineures, consultée le .

Définir ce que la fiche doit permettre de vérifier

Identifiez le champ et l’opération qui reçoivent la valeur. Un catalogue peut fournir un décimal tandis que le prestataire de paiement attend un entier en unité mineure. La documentation de ce prestataire prime pour son interface ; ne généralisez pas une règle d’une API à une autre.

Adyen publie une table de précisions et signale des divergences avec ISO 4217. Les exemples de cette fiche servent à préparer une recette arithmétique ; ils ne sont ni des taux de change ni des tarifs de voyage. La conversion et les frais doivent faire l’objet de règles séparées.

Mise en pratique · situation fictive

Quel résultat cette fiche doit-elle permettre de vérifier ?

Les données et conditions de cet exercice sont inventées. Rejouez le cas dans un environnement autorisé en utilisant les huit contrôles de la fiche, puis comparez votre lecture au résultat proposé.

Situation de départ

Prix de 12,34 EUR dans une interface fictive dont le contrat exige des unités de centime. Tester aussi un montant égal à zéro et un champ absent.

Comparer avec le résultat attendu

Transmettre 1234 pour ce contrat. Zéro et absence gardent des sens distincts ; la convention doit être relue avant d’utiliser une autre devise ou une autre opération.

Huit champs à rapprocher de leurs preuves

Gardez la source et la date de vérification à côté des informations collectées. Sur téléphone, les contrôles se lisent en cartes.

Contrôler un montant entre offre et API de paiement : données et contrôles
ChampÀ collecterTest ou rapprochement
DeviseCode transmis avec chaque montant.Rejeter une devise absente ou inconnue au lieu de choisir EUR par défaut.
UnitéEntier ou décimal, unité principale ou mineure.Relire le contrat d’interface pour cette opération précise.
PrécisionNombre de décimales autorisé.Tester EUR, JPY et KWD selon la convention du prestataire.
ArrondiÉtape, sens et règle de calcul.Comparer somme des lignes et total ; expliquer tout écart.
Taxes et fraisMontants inclus, exclus ou payables sur place.Distinguer somme à encaisser et coût total annoncé au voyageur.
ChangeMontants source et cible, sens du taux, date, frais et règle d’arrondi.Reconstituer le calcul sans remplacer le taux retenu ; distinguer hypothèse, proposition et débit constaté.
RemboursementMontant et règle applicables à l’opération.Tester plusieurs remboursements partiels et leur cumul.
RapprochementOffre, transaction et écriture de règlement.Relier les valeurs par références ; conserver les écarts qualifiés.

Trois erreurs qui fragilisent le dossier

  • Multiplier chaque montant par 100.
  • Arrondir plusieurs fois sans conserver la règle.
  • Comparer des valeurs sans leur devise.

Transmettre un résultat exploitable

Remettez un dictionnaire par champ, prestataire et opération. Joignez les conversions testées, la source de la règle et les écarts de rapprochement encore ouverts.

Choisir un registre de contenus, médias ou recette · Préciser les responsabilités du parcours

Questions fréquentes

Pourquoi le montant 1234 ne suffit-il pas ?

Sa signification dépend de la devise et de la convention de l’API. Il doit être accompagné de ces informations.

ISO 4217 suffit-il pour configurer le paiement ?

Vérifiez aussi la documentation de l’opération, qui peut imposer une convention particulière.

Un remboursement doit-il suivre le taux du jour ?

La règle dépend du contrat et de l’opération. Conservez le calcul retenu et sa source plutôt que de choisir silencieusement un taux.

Documentation et application

Les précisions utiles des sources

Adyen : les décimales de l’API peuvent différer de la devise ISO

Adyen demande généralement un montant entier en unités mineures. Sa documentation exclut explicitement Terminal API de cette règle générale.

Adyen : les décimales de l’API peuvent différer de la devise ISO
Point documentéCe que la source préciseConséquence pour votre contrôle
ExceptionsCLP, CVE, IDR et ISK ont un nombre de décimales Adyen différent de la référence ISO 4217.Appliquer la table de l’API et conserver aussi le code monétaire.
ISKPour l’ISK, la référence ISO indique zéro décimale, tandis qu’Adyen en demande deux pour le montant transmis.Un montant de 10 ISK s’écrit 1000 selon cette convention Adyen ; ce calcul n’est pas un taux de change.
PérimètreLes règles présentées concernent les API soumises à la convention en unités mineures, hors Terminal API.Relire le contrat de l’opération avant de transposer un encodage utilisé ailleurs.

La table technique ne confirme ni l’activation d’une devise sur le compte ni les conditions de règlement, les frais ou un taux de change.

Adyen — Currency codes and minor units · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.

Approfondir ce contrôle

Toutes les fiches de contrôle · Méthode des sources

Approfondir la méthode

Modèles et champs associés

Ces modèles sont reliés à cette fiche ou à ses guides. Choisissez le périmètre qui correspond à votre contrôle. Consultez les informations à rapprocher et les contrôles proposés.

Passer à la vérification

Des fiches de contrôle pour ce sujet

Champs à collecter, tests, erreurs fréquentes et consignes de transmission pour travailler sur un dossier concret.

Vignettes illustratives générées par IA.

Toutes les fiches de contrôle →