⚠️ Australie : La majoration est interdite en Australie depuis le 1er octobre 2026 sur les paiements par carte eftpos, Visa, Mastercard et American Express (cartes de débit, prépayées et de crédit, pour les particuliers comme pour les entreprises). Ne configurez pas la majoration pour un commerçant, un magasin ou un terminal australien. Si un commerçant australien a encore une majoration en place, retirez-la tout de suite de ses paramètres de terminal et de son paiement en ligne. Pour tous les détails, consultez Directives sur les frais de majoration (surcharge) pour 2026.
Avec Adyen, la majoration peut être configurée pour les paiements en personne (terminaux, Tap to Pay) et, dans certains cas, pour les paiements en ligne, toujours sous réserve de la conformité aux lois et règlements de la région.
🛠 Prérequis et conformité
Avant de commencer :
Assurez-vous d'avoir le bon type d'intégration (Terminal API, Tap to Pay Android/iOS ou API en ligne prise en charge) et que le micrologiciel des terminaux respecte les versions minimales (p. ex. v1.108+ pour le montant maximal de majoration, v1.112+ pour différencier les cartes de particuliers et les cartes d'entreprise).
Vérifiez que vous avez une clé API avec les permissions de gestion nécessaires (p. ex. « Terminal settings read/write ») pour configurer la majoration au niveau de l'entreprise, du compte marchand, du magasin ou du terminal.
Confirmez la conformité légale et réglementaire dans votre région. Certaines régions restreignent ou interdisent la majoration. Par exemple, dans l'EEE, les cartes de particuliers ne peuvent pas faire l'objet d'une majoration. Aux États-Unis, les cartes de débit ne peuvent pas en faire l'objet non plus. En Australie, aucun paiement par carte eftpos, Visa, Mastercard ou Amex ne peut faire l'objet d'une majoration depuis le 1er octobre 2026.
Assurez-vous que l'affichage et la divulgation sont en place (p. ex. affiche à l'extérieur du magasin, au point de vente) et que les reçus indiquent le montant de la majoration. La fonctionnalité d'Adyen ne gère pas la conformité à votre place.
🔧 Étapes de configuration
Définissez la structure de votre majoration, notamment :
Quelles marques de cartes ou quels types de financement seront visés (p. ex. Visa crédit vs débit).
Quelles régions et devises s'appliquent.
Si la majoration est un montant fixe, un pourcentage ou les deux.
Le montant maximal de majoration (si vous voulez un plafond).
Si la majoration doit exclure les pourboires. (Adyen permet de régler ce paramètre.)
Accédez à votre Customer Area Adyen ou à la Management API :
Dans le Customer Area : allez à In-person payments → Terminal settings → Payment features / Surcharge, au niveau voulu (entreprise, compte marchand, magasin ou terminal).
Par API : utilisez l'endpoint GET /terminalSettings pour vérifier les paramètres existants, puis PATCH /terminalSettings pour appliquer votre objet de majoration. Celui-ci contient des champs comme askConfirmation et excludeGratuityFromSurcharge, ainsi qu'un tableau configurations[] qui précise les préréglages par marque, devise et type de financement.
Appliquez les changements et déployez :
Après la configuration, assurez-vous que les terminaux ou appareils de point de vente récupèrent la nouvelle configuration (lors de la maintenance planifiée ou par une mise à jour forcée).
Pour les intégrations Tap to Pay, confirmez avec le soutien Adyen que le mode « single tap » est activé si nécessaire.
Surveillez et rapprochez :
Quand la majoration est active, le terminal ou l'appareil mobile affiche le montant de la majoration (ou l'applique automatiquement dans certains parcours). La réponse de paiement inclut alors un champ comme TotalFeesAmount.
Assurez-vous que vos reçus, vos rapports et vos processus de rapprochement font ressortir le montant de la majoration séparément.
Gardez votre affichage et votre politique à jour pour rester conforme aux règles des réseaux de cartes et aux règlements locaux.
⚠️ Points importants pour Valpay et les partenaires
Assurez-vous d'appliquer la majoration de façon uniforme aux types de cartes visés, selon les exigences de la région. Au Canada, c'est sur les cartes de crédit seulement. Aux États-Unis, il n'y a aucune majoration sur les cartes de débit. En Australie, il n'y a aucune majoration sur les cartes eftpos, Visa, Mastercard ou Amex.
Retrait d'une majoration (p. ex. commerçants australiens) : effacez la configuration de la majoration à chaque niveau où elle a été réglée (entreprise, compte marchand, magasin et terminal). Assurez-vous ensuite que les terminaux récupèrent les nouveaux paramètres. Rappelez aussi au commerçant de retirer toute affiche de majoration et de mettre à jour ses reçus et son paiement en ligne.
La majoration et la conversion dynamique de devises (DCC) ne peuvent pas s'appliquer toutes les deux à la même transaction. Si les deux fonctionnalités sont actives, Adyen peut ignorer la DCC lorsqu'une majoration supérieure à 0 est détectée.
Activer la fonctionnalité ne veut pas dire que vous êtes conforme. Vous devez quand même gérer vous-même l'affichage, la divulgation au commerçant, les reçus et l'avis aux réseaux (si requis).
Si vous intégrez plusieurs commerçants (partenaires ou revendeurs) sous Valpay, documentez clairement le processus pour chacun : vérifiez qu'il est prêt, appliquez les paramètres de majoration, communiquez la politique et surveillez les résultats.
Commencez par un projet pilote : il vaut mieux activer la fonctionnalité pour un seul commerçant ou magasin, valider les parcours et rapprocher les rapports avant de la déployer à plus grande échelle.