
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.
Aucun contrôle marqué comme examiné.
Marquez seulement les points dont vous avez examiné la preuve. Ce repère de lecture reste dans cet onglet ; il ne certifie pas le dossier et disparaît au rechargement.
| Champ | À collecter | Test ou rapprochement |
|---|---|---|
| Devise | Code 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écision | Nombre 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 frais | Montants inclus, exclus ou payables sur place. | Distinguer somme à encaisser et coût total annoncé au voyageur. |
| Change | Montants 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é. |
| Remboursement | Montant et règle applicables à l’opération. | Tester plusieurs remboursements partiels et leur cumul. |
| Rapprochement | Offre, 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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Exceptions | CLP, 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. |
| ISK | Pour 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ètre | Les 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.
Approfondir ce contrôle
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.

Paiement
Rapprocher le paiement et la réservation de voyage
Un paiement accepté, une prestation confirmée et un remboursement exécuté sont trois faits distincts. Cette fiche aide les équipes produit, finance et service client à garder leurs références et leurs états cohérents.
8 contrôles, un cas pratique et 3 questions fréquentes : Rapprocher le paiement et la réservation de voyage →
Paiement
Suivre une annulation jusqu’au résultat du remboursement
Annuler une prestation, calculer ce qui est dû et rembourser un paiement sont des opérations distinctes. Le suivi doit rendre visibles les étapes qui restent en attente.
8 contrôles, un cas pratique et 3 questions fréquentes : Suivre une annulation jusqu’au résultat du remboursement →
Paiements
Contrôler une préautorisation et son règlement final
La garantie financière doit rester distincte du prix du séjour, du règlement final et de la réservation. Vérifiez les preuves avant une capture ou une nouvelle tentative.
8 contrôles, un cas pratique et 3 questions fréquentes : Contrôler une préautorisation et son règlement final →