商户建议码

当Mastercard在返回发卡行拒绝结果的同时,会附加一个商户建议码（Merchant Advice Code，简称MAC）。与发卡行错误码不同，MAC并不解释交易失败的具体原因，而是针对是否可以重试、以及建议在多久之后重试给出更明确的指引，帮助您优化重试策略、提升后续授权成成功率，同时避免因无效重试触发卡组织的超额重试罚款。

MAC会与发卡行错误码、错误消息一并返回给您，您可在支付失败后通过merchantAdviceCode查询。如您希望在API响应中获取到该字段，请联系PayerMax技术支持为您提供集成指引。

注意：

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 等卡组织的交易设计重试策略，建议直接根据发卡行错误码自行制定重试规则。