Merchant Advice Codes (MAC)

当交易被拒绝时，商户通知代码（MAC）会提供明确的指导，说明是否以及何时适合重试。为了支持透明度和知情决策，Yuno 的公共 API 包括标准化和原始响应代码。通过了解 MAC，商家可以快速确定拒绝的原因，并确定采取的最佳行动，例如在尝试重试之前更新路由或客户信息。

MAC 列表

本表映射了 Yuno 的规范化商户建议代码（......）。merchant_advice_code 和 merchant_advice_code_message)与万事达卡、维萨卡和 Elo 卡的对应卡号进行比较。将其作为解释拒绝原因、设置重试规则和跨网络应用一致路由策略的参考。

交易中的 MAC 字段

Yuno 的公共 API 包含专用字段，便于使用商家通知代码。

正常化的 MAC

Yuno 提供一套标准化的商家建议代码，可简化提供商的响应。通过这些代码，您可以建立重试逻辑和路由规则，而无需管理每个提供商的独特变化。

• transactions.merchant_advice_code:交易被拒绝时返回的 Yuno-normalized MAC。该代码可帮助您了解拒绝的原因、是否可以重试以及重试付款前应采取的措施。
• transactions.merchant_advice_code_message:该字段补充了 merchant_advice_code 如上图所示，用人类可读的语言对代码进行了解释。通过这条信息，您可以根据信息采取行动，而不必记住每个代码的含义。

原始 MAC

除了规范化值，Yuno 还公开了提供商返回的原始代码和信息。这些原始字段可确保完全透明，让您在需要时排除故障或遵循提供商的特定指导。

• transactions.provider_data.merchant_advice_code:从支付提供商直接返回的原始商户通知代码。您可以通过此字段查看原始代码，以便完全透明地排除故障。
• transactions.provider_data.merchant_advice_code_message:来自提供方的人可读信息，解释原始 MAC 的含义。使用此信息可了解提供方的具体指导，而无需解释代码值。

📘

请注意，这些字段位于transactions 对象。

关于重试

如果刷卡消费被拒，随后使用同一张卡完成消费的任何尝试都属于重试。每个银行卡网络都规定了重试的费用和门槛。重试多少次才收费因品牌而异。不遵守规定的商家可能会被收取超额交易费。

支付行业与 ABECS 一起，对银行卡交易拒绝的响应代码进行了标准化。这些尝试分为两类：

• 可逆性：可能是暂时性拒绝，随着时间的推移可能会发生变化。发卡机构可能因资金不足、系统问题或尝试密码失败次数过多而拒绝交易。
• 不可逆转：在不可逆转的拒绝后，任何不更改信息字段的授权都将失败。这可能意味着银行卡已被注销或欺诈已被确认。

威士卡、万事达卡和 Elo 更新了它们的政策，限制拒绝后的授权重试尝试，并对超出这些限制的尝试收取费用。请参见以下各品牌的规定。

• 万事达卡
• 签证
• Elo
• 其他品牌

万事达卡

万事达卡将处理 MAC 作为其 "卓越交易处理（TPE）"计划的一部分，该计划有两个主要组成部分：

过多的授权尝试

万事达卡的 "过多授权尝试 TPE "旨在持续监控网络使用情况，以检测和防止过多的授权请求。万事达卡还监控经批准的小额交易（少于一个货币单位），这些交易后来被退还，因为这些交易可能表明存在卡片测试活动。

这种监控适用于被拒绝和已批准的消费。重试的定义是使用同一张卡和同一个商户重新尝试授权付款。万事达卡的规则根据不同地区设定了每日和每月阈值（例如，每天不超过 10 次尝试或每月不超过 35 次重试）。超过这两个限额都会导致额外的费用。

万事达卡商户通知代码 (MAC)

万事达卡使用 MAC 来帮助商家了解何时适合重试交易。有些拒绝是不可逆转的，这意味着交易不应重试，通常是因为卡片已被关闭或欺诈已被确认。

TPE 程序专门跟踪这些不可逆转的下降后的重试情况，重点关注两个代码：MAC 03（"请勿重试"）和 MAC 21（"无重试生命周期"）。如果在收到上述代码后再次尝试处理相同的卡和金额，万事达卡可能会向你收取费用。

其他 MAC（如显示临时问题或资金不足的 MAC）不会触发 "卓越 MAC 交易 "费用，但如果您超过重试限制，仍可能会根据 "过多授权尝试 "计划被收费。

在某些情况下，MAC 会建议等待一段时间后再重试（例如，"24 小时后重试"）。这可以帮助您选择重试的最佳时机。

在MAC 列表中查看所有万事达卡MAC 及其尤诺标准化等价物。

签证

Visa 的 MAC 分为四类。其目的是保持生态系统的平衡，减少不必要的重试，并要求发卡机构使用精确、非通用的拒绝代码。

📘

签证费

由于不可逆转，第 1 类代码从第 2 次尝试开始收费。第 2、3 和 4 类代码在 30 天内最多可尝试 20 次，从第 21 次开始收费。第一次尝试后的 30 天内，任何重试都要收费。Visa 的收费如下

• 国内：0.10 美元 + 13.83% 税款
• 跨境0.25 美元 + 13.83% 税款

第 1 类（发行人永远不会批准）

不可逆转，表示该卡已被注销或从未存在过，或拒绝是永久性限制或错误的结果，将阻止今后的审批。第二次申请的费用。

• 常见的第 1 类代码可能包括 04, 07, 12, 15, 41, 43, 46, 57, R0, R1, R3

第 2 类（发行人目前无法批准）

可逆，是指拒绝是由于信用风险或其他卡片限制等临时条件造成的，可能允许交易重试获得批准。在某些情况下，持卡人或发卡机构需要在批准前采取行动取消限制。

• 常见的第 2 类代码可能包括 03, 19, 39, 51, 52, 53, 59, 61, 62, 65, 75, 78, 86, 91, 93, 96, N3, N4, Z5, 5C, 9G

第 3 类（数据质量）

可逆，由发卡机构识别的数据错误触发。商户在重试之前必须重新验证支付数据。这些拒绝代码可能会给商户带来潜在的欺诈风险。

• 常见的第 3 类代码可能包括 14, 54, 55, 70, 82, 1A, 6P, N7

🚧

第 3 类收费

商户在 30 天内最多可有 25,000 笔被拒绝的数据质量错误交易（第 3 类）。如果超过这一限额，Visa 将对每笔额外的此类被拒交易收取费用。

第 4 类（通用答复代码）

可逆，包括不属于 1、2 和 3 类的所有其他拒绝回复代码，因为在某些情况下，特定的拒绝可能没有回复代码值。发卡机构可以使用 VisaNet 技术规范中定义的其他响应代码值。但建议尽量少用。

所有签证互认代码及其尤诺归一化等效代码均可在互认代码列表中找到。

Elo

Elo 于 2025 年 1 月实施了相关规则，旨在减少商家和收单机构不必要的重试。交易计算时间为每月的第一天至最后一天。

📘

Elo 费用

超过团体限额的每次尝试收取 0.80 BRL。

Elo 组和重试规则

Elo 将可逆代码和不可逆代码分为三类：

📘

"CNPJ "是指巴西企业纳税人对机构的标识（在集团层面为 Root CNPJ）。

请参阅所有 EloMAC 列表和Yuno-normalized 等价物。

其他品牌

• 可逆代码：允许对同一客户和卡进行重试。没有限制或预设时限。

🚧

请注意

在再次尝试之前，请按照被拒绝的交易回复中的指导进行操作。

• 不可撤销代码：在收到发卡机构的第一次拒绝回复后，将不允许对同一卡或机构进行授权。

使用 MAC 进行路由选择

重试行为应通过路由条件实现。更新路由以包含新的 MAC 条件。

在Yuno 面板中创建拒绝组时，您可以选择按响应代码或按 MAC 代码添加条件。

🚧

过渡时期

在所有集成都单独发出 MAC 之前，一些 MAC 值将同时出现在响应代码和 MAC 代码下。这种情况预计会在该功能推出时出现。