# 商户建议码 当Mastercard在返回发卡行拒绝结果的同时,会附加一个**商户建议码（Merchant Advice Code，简称MAC）**。与[发卡行错误码](https://docs.payermax.com/202606-version/acquiring/integration-testing-and-troubleshooting/troubleshooting/issuer-response-code.md)不同，MAC并不解释交易失败的具体原因，而是针对**是否可以重试、以及建议在多久之后重试**给出更明确的指引，帮助您优化重试策略、提升后续授权成成功率，同时避免因无效重试触发卡组织的超额重试罚款。 MAC会与发卡行错误码、错误消息一并返回给您，您可在支付失败后通过`merchantAdviceCode`查询。如您希望在API响应中获取到该字段，请联系PayerMax技术支持为您提供集成指引。 ::: warning 注意： MAC 仅适用于 Mastercard 交易，但并非所有 Mastercard 发卡行都会返回 MAC，可能因发卡行未支持而收不到该字段，此时请以**发卡行错误码及错误消息**作为主要判断依据。 ::: | 商户建议（MAC） | 建议码信息 | 描述 | 备注（建议处理动作） | | --------------- | ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | 01 | New account information available | There has been a change in the shopper's account information, for example a new expiry date for an expired card. | 持卡人账户信息发生变更（例如卡片已更新有效期）。建议通过账户更新服务获取最新卡信息，或直接联系持卡人确认。 | | 02 | Cannot approve at this time, try again later | This can happen because of a credit limit, or insufficient funds on the card. | 可能因信用额度不足或余额不足导致本次无法通过。建议在 72 小时后重试该笔交易。 | | 03 | Do not try again | The account is closed, or the issuer suspects fraud. | 账户已关闭，或发卡行怀疑存在欺诈风险。不建议再对该卡片发起重试，重试可能被 Mastercard 判定为超额重试并产生罚款，建议直接联系持卡人更换支付方式。 | | 04 | Token requirements not fulfilled for this token type | There is a technical issue related to the token used in this payment. | 交易所使用的 Token 存在技术问题。建议联系 PayerMax 技术支持协助排查。 | | 21 | Payment cancellation | The shopper has canceled the recurring payment agreement with their issuer. | 持卡人已在发卡行侧取消该笔定期扣款协议。不建议再对该笔协议发起重试，建议联系持卡人确认后续处理方式。 | | 24 | Retry after 1 hour | Insufficient funds on the shopper's account. | 账户余额不足。建议在 1 小时后重试该笔交易。 | | 25 | Retry after 24 hours | Insufficient funds on the shopper's account. | 账户余额不足。建议在 24 小时后重试该笔交易。 | | 26 | Retry after 2 days | Insufficient funds on the shopper's account. | 账户余额不足。建议在 2 天后重试该笔交易。 | | 27 | Retry after 4 days | Insufficient funds on the shopper's account. | 账户余额不足。建议在 4 天后重试该笔交易。 | | 28 | Retry after 6 days | Insufficient funds on the shopper's account. | 账户余额不足。建议在 6 天后重试该笔交易。 | | 29 | Retry after 8 days | Insufficient funds on the shopper's account. | 账户余额不足。建议在 8 天后重试该笔交易。 | | 30 | Retry after 10 days | Insufficient funds on the shopper's account. | 账户余额不足。建议在 10 天后重试该笔交易，若仍失败建议引导持卡人更换支付方式。 | | 40 | Consumer non-reloadable prepaid card | The card is a non-reloadable (single-load) consumer prepaid card. | 该卡为不可充值的消费级预付卡，卡内余额通常无法追加。建议引导持卡人使用其他支付方式。 | | 41 | Consumer single-use virtual card number | The card is a single-use virtual card number, only valid for one transaction. | 该卡为一次性虚拟卡号，仅能用于单次交易。若交易失败，通常无法再次使用同一卡号重试，建议引导持卡人获取新的支付凭证。 | | 42 | Sanctions Scoring Service | The transaction was flagged by Mastercard's sanctions screening service. | 交易被 Mastercard 制裁名单筛查服务拦截。不建议重试，建议按贵司合规流程进一步核实持卡人身份及交易背景。 | | 43 | Consumer multi-use virtual card number | Transaction was carried out with a consumer multi-use virtual card number. | 该卡为可多次使用的消费级虚拟卡号。无需特殊处理，可按常规重试逻辑参考对应的发卡行错误码进行判断 | ## 常见问题 ### Q: 收到 MAC 后，是否还需要参考发卡行错误码？ 需要。MAC 是对发卡行错误码的补充说明，二者应结合使用：发卡行错误码告诉您交易失败的原因，MAC 则告诉您接下来应该如何处理（是否重试、何时重试）。 ### Q: 未返回 MAC 的交易，说明什么？ 说明该笔交易的发卡行未提供该建议码，通常是因为发卡行暂不支持返回 MAC，此时请以发卡行错误码及错误消息作为主要判断依据。 ### Q: 使用 Visa / JCB / Diners / Discover等卡组织的交易，是否也会返回 MAC？ 不会。MAC 是 Mastercard 特有的字段，其他卡组织没有对应机制，因此不会返回该字段。若您需要对 Visa 等卡组织的交易设计重试策略，建议直接根据[发卡行错误码](https://docs.payermax.com/202606-version/acquiring/integration-testing-and-troubleshooting/troubleshooting/issuer-response-code.md)自行制定重试规则。