Merchant Advice Codes (MAC)

Lorsqu'une transaction est refusée, les codes d'avis du commerçant (MAC) fournissent des indications claires sur l'opportunité d'une nouvelle tentative. Pour favoriser la transparence et la prise de décision éclairée, les API publiques de Yuno incluent à la fois des codes de réponse normalisés et bruts. En comprenant les MAC, les commerçants peuvent rapidement identifier la raison d'un refus et déterminer les meilleures actions à entreprendre, telles que la mise à jour du routage ou des informations sur le client avant de tenter une nouvelle tentative.

Liste des MAC

Ce tableau met en correspondance les codes d'avis de marchands normalisés de Yuno (merchant_advice_code  et  merchant_advice_code_message) à leurs équivalents chez Mastercard, Visa et Elo. Utilisez-le comme référence pour interpréter les motifs de refus, définir des règles de relance et appliquer des stratégies de routage cohérentes sur l'ensemble des réseaux.

Champs MAC dans les transactions

L'API publique de Yuno comprend des champs dédiés pour faciliter l'utilisation des codes d'avis du commerçant.

MAC normalisés

Yuno fournit un ensemble standardisé de codes d'avis aux commerçants qui simplifient les réponses des fournisseurs. Ces codes vous permettent d'élaborer une logique de relance et des règles de routage sans avoir à gérer les variations uniques de chaque fournisseur.

• transactions.merchant_advice_code: MAC normalisé par Yuno renvoyé lorsqu'une transaction est refusée. Ce code vous aide à comprendre la raison du refus, à savoir si une nouvelle tentative est possible et quelles sont les actions à entreprendre avant de retenter le paiement.
• transactions.merchant_advice_code_message: Ces champs complètent le merchant_advice_code Ce message vous permettra d'agir en fonction de l'information sans avoir à mémoriser la signification de chaque code. Ce message vous permettra d'agir en fonction de l'information sans avoir à mémoriser la signification de chaque code.

MAC bruts

Outre les valeurs normalisées, Yuno expose également les codes et messages originaux renvoyés par les fournisseurs. Ces champs bruts garantissent une transparence totale et vous permettent de résoudre les problèmes ou de suivre les conseils spécifiques du fournisseur en cas de besoin.

• transactions.provider_data.merchant_advice_code: Le code d'avis du commerçant original renvoyé directement par le prestataire de paiement. Ce champ vous permet d'accéder au code brut pour une transparence et un dépannage complets.
• transactions.provider_data.merchant_advice_code_message: Un message du prestataire, lisible par l'homme, qui explique la signification du MAC brut. Utilisez ce message pour comprendre les conseils spécifiques du fournisseur sans avoir à interpréter les valeurs des codes.

📘

Veuillez noter que ces champs sont situés à l'intérieur dutransactions dans les réponses de l'API.

À propos des nouvelles tentatives

Lorsqu'un achat par carte est refusé, toute tentative ultérieure d'effectuer l'achat avec la même carte est une nouvelle tentative. Les frais et les seuils pour les nouvelles tentatives sont définis par chaque réseau de cartes. Le nombre de tentatives possibles avant l'application de frais varie selon la marque. Les commerçants qui ne respectent pas ces règles peuvent se voir facturer des frais pour les transactions dépassées.

Le secteur des paiements, en collaboration avec l'ABECS, a normalisé les codes de réponse pour les refus de transactions par carte. Ces tentatives sont classées en deux catégories :

• Réversible: Un refus potentiellement temporaire qui peut changer avec le temps. L'émetteur peut refuser la transaction en raison d'une insuffisance de fonds, de problèmes de système ou d'un trop grand nombre de tentatives infructueuses de saisie du code PIN.
• Irréversible: toute autorisation après un refus irréversible qui ne modifie pas les champs du message échouera. Cela peut signifier que la carte a été annulée ou qu'une fraude a été confirmée.

Visa, Mastercard et Elo ont mis à jour leurs politiques pour limiter les tentatives de réessai d'autorisation après un refus, et ils facturent des frais pour les tentatives dépassant ces limites. Voir les règles de chaque marque ci-dessous.

• Mastercard
• Visa
• Elo
• Autres marques

Mastercard

Mastercard traite les MAC dans le cadre de son programme Transaction Processing Excellence (TPE), qui comporte deux volets principaux :

Tentatives d'autorisation excessives

Tentatives d'autorisation excessives de Mastercard La TPE vise à surveiller en permanence l'utilisation du réseau afin de détecter et d'éviter un trop grand nombre de demandes d'autorisation. Mastercard surveille également les transactions approuvées pour de très petits montants (moins d'une unité monétaire) qui sont ensuite remboursés, car cela peut indiquer une activité de test de la carte.

Ce contrôle s'applique aussi bien aux achats refusés qu'aux achats approuvés. Une nouvelle tentative est définie comme toute nouvelle tentative d'autorisation d'un paiement en utilisant la même carte et le même commerçant. Les règles de Mastercard fixent des seuils quotidiens et mensuels en fonction de la région (par exemple, pas plus de 10 tentatives par jour ou 35 tentatives par mois). Le dépassement de l'une ou l'autre de ces limites peut entraîner des frais supplémentaires.

Codes d'avis de marché Mastercard (MAC)

Mastercard utilise les MAC pour aider les commerçants à comprendre quand il convient de réessayer une transaction. Certains refus sont irréversibles, ce qui signifie que la transaction ne doit pas être retentée, souvent parce que la carte est fermée ou que la fraude est confirmée.

Le programme TPE suit spécifiquement les tentatives de réessai après ces déclins irréversibles, en se concentrant sur deux codes : MAC 03 ("Do not try again") et MAC 21 ("No retry life cycle"). Si vous essayez de traiter à nouveau la même carte et le même montant après avoir reçu l'un de ces codes, Mastercard peut vous facturer des frais.

D'autres MAC, comme celles indiquant un problème temporaire ou une insuffisance de fonds, n'entraînent pas de frais d'excellence pour les transactions MAC, mais vous pouvez toujours être facturé dans le cadre du programme de tentatives d'autorisation excessives si vous dépassez les limites de tentatives.

Dans certains cas, les MAC recommandent d'attendre un certain temps avant de réessayer (par exemple, "Réessayer après 24 heures"). Ces recommandations vous aident à choisir le meilleur moment pour réessayer.

Voir tous les MAC de Mastercard et leurs équivalents normalisés par Yuno dans la liste des MAC.

Visa

Les MAC de Visa sont organisés en quatre catégories. L'objectif est de maintenir l'équilibre de l'écosystème, de réduire les tentatives inutiles et d'obliger les émetteurs à utiliser des codes de refus précis et non génériques.

📘

Frais de visa

Étant donné qu'ils sont irréversibles, les codes de catégorie 1 sont facturés à partir de la deuxième tentative. Les catégories 2, 3 et 4 permettent jusqu'à 20 tentatives dans un délai de 30 jours, avec des frais à partir de la 21e tentative. Après 30 jours à compter de la première tentative, toute nouvelle tentative est facturée. Les frais de Visa sont les suivants :

• National: 0,10 USD + 13,83% de taxe
• Transfrontalier: 0,25 USD + 13,83 % de taxe

Catégorie 1 (l'émetteur n'approuvera jamais)

Irréversible, signale que la carte a été annulée ou n'a jamais existé, ou que le refus est le résultat d'une restriction ou d'une erreur permanente qui bloquera toute approbation future. Frais de la deuxième tentative.

• Les codes courants de la catégorie 1 peuvent être les suivants 04, 07, 12, 15, 41, 43, 46, 57, R0, R1, R3

Catégorie 2 (l'émetteur ne peut pas approuver pour le moment)

Réversible, signifie que le refus résulte d'une condition temporaire telle qu'un risque de crédit ou d'autres restrictions liées à la carte, qui peuvent permettre d'approuver une nouvelle tentative de transaction. Dans certains cas, le titulaire de la carte ou l'émetteur doit prendre des mesures pour lever la restriction avant que la transaction ne soit approuvée.

• Les codes courants de la catégorie 2 peuvent être les suivants 03, 19, 39, 51, 52, 53, 59, 61, 62, 65, 75, 78, 86, 91, 93, 96, N3, N4, Z5, 5C, 9G

Catégorie 3 (qualité des données)

Réversible, est déclenché par une erreur de données identifiée par l'émetteur. Les commerçants doivent revalider les données de paiement avant de réessayer. Ces codes de refus peuvent signaler aux commerçants des risques de fraude potentiels.

• Les codes courants de la catégorie 3 peuvent être les suivants 14, 54, 55, 70, 82, 1A, 6P, N7

🚧

Frais de la catégorie 3

Les commerçants peuvent avoir jusqu'à 25 000 transactions refusées avec des erreurs de qualité des données (catégorie 3) au cours d'une période de 30 jours. Si vous dépassez cette limite, Visa facturera des frais pour chaque transaction supplémentaire refusée dans cette catégorie.

Catégorie 4 (codes de réponse génériques)

Réversible, comprend tous les autres codes de réponse de refus qui ne font pas partie des catégories 1, 2 et 3, car il peut arriver qu'il n'y ait pas de valeur de code de réponse pour un refus spécifique. Les émetteurs peuvent utiliser d'autres valeurs de code de réponse définies dans les spécifications techniques de VisaNet. Toutefois, il est conseillé d'en faire un usage minimal.

Tous les MAC de Visa et leurs équivalents normalisés par Yuno sont disponibles dans la liste des MAC.

Elo

Elo a mis en place des règles en janvier 2025, visant à réduire les tentatives inutiles de la part des commerçants et des acquéreurs. Les transactions sont comptabilisées du 1er au dernier jour du mois.

📘

Frais Elo

0,80 BRL par tentative dépassant la limite du groupe.

Groupes Elo et règles de relance

Elo classe les codes réversibles et irréversibles en trois groupes distincts :

📘

"CNPJ" désigne le numéro d'identification du contribuable brésilien de l'établissement (CNPJ racine au niveau du groupe).

Voir la liste des MACElo et leséquivalents normalisés Yuno.

Autres marques

• Codes réversibles: Les tentatives de réitération sont autorisées pour le même client et la même carte. Il n'y a pas de limite ou de délai préétabli.

🚧

Attention

Avant de réessayer, suivez les conseils donnés dans la réponse à la transaction refusée.

• Codes irréversibles: Les autorisations pour la même carte ou le même établissement ne seront pas autorisées après la réception de la première réponse de refus de l'émetteur.

Routage avec MAC

Le comportement de réessai doit être mis en œuvre par le biais de conditions de routage. Mettre à jour les itinéraires pour inclure les nouvelles conditions MAC.

Lorsque vous créez un groupe de refus dans le tableau de bord Yuno, vous pouvez choisir d'ajouter des conditions par code de réponse ou par code MAC.

🚧

Période de transition

Jusqu'à ce que toutes les intégrations émettent les MAC séparément, certaines valeurs MAC apparaîtront à la fois sous les codes de réponse et les codes MAC. Cette situation est prévisible pendant la phase de déploiement de la fonctionnalité.