疑难解答和常见问题
此部分包含集成中可能出现的问题的建议和解决方案。
Mastercard Gateway 上的 附加费功能 允许商家根据以下参数对交易征收附加费：
- 网关入口点，例如 Hosted Checkout 或 API。
- 付款方式，如 Mastercard、Visa 或 American Express。
- 资金提供方法，如贷记或借记。
- 货币
可以，您可以在 Merchant Administration 中配置 IP 国家/地区筛选规则。 除了适用于其所有商家的规则外，您的支付服务提供商也可以在 Merchant Manager 中单独为您配置规则。 这将允许您拒绝或审查来自与高风险国家相关的 IP 地址的交易。
仅当通过 Pay 或 Capture 完成资金转移后，才可进行退款 。
取消只能对在一天结束前收单行还未发送到银行进行处理的交易执行。
可以，您可以设置可变金额的定期付款，例如，支付后付费账单。 您需要根据需求更新 amountVariability 参数值。 有关更多信息，请参阅存档凭据交易。
两个 SDK 版本的主要区别如下：
| SDK 版本 1 | SDK 版本 2 |
|---|---|
| 没有原生的应用内体验 | 原生应用内体验，无需重定向 |
| 带重定向的质询流 | 支持多种质询流，如 OTP、单选和多选、基于答案等。 |
| 通过移动设备上的 Web 浏览器执行的发卡机构质询流 | 减少付款人质询问题的更智能的无障碍流 |
这取决于向付款人发放卡的金融机构。 每个发卡机构定义授权过期期间，在此期间内，发卡机构在等待过账交易到来时在付款人账户内保留资金。 通常，在从付款人账户清除授权、释放付款人对资金的访问权之前，需要 5-8 天处理时间。
您可以使用以下字段来捕获验证错误：
字段 error.explanation [REST][NVP] 将包含一些提供更详细错误信息的人类可读错误文本，如最小长度或预计长度等。请勿解析此信息，因为不能保证此文本的格式。
与支付客户端和虚拟支付客户端的集成返回与为 DirectAPI 返回的枚举不同的响应代码。 下表显示了 CommWeb payment gateway 返回的两类响应之间的映射。
| 支付客户端/虚拟支付客户端 | DirectAPI | ||
|---|---|---|---|
| 响应代码 | 说明 | response.gatewayCode |
说明 |
| 0 | 交易成功 | APPROVED |
交易已审批 |
| 1 | 交易无法处理 | UNSPECIFIED_FAILURE |
交易无法处理 |
| 2 | 交易被拒 - 请咨询发卡银行 | DECLINED |
请求的操作未成功。 例如，付款被发卡机构拒绝或付款人身份验证无法成功完成。 |
| 3 | 交易被拒 - 银行未响应 | TIMED_OUT |
响应超时 |
| 4 | 交易被拒 - 卡过期 | EXPIRED_CARD |
交易由于卡过期被拒 |
| 5 | 交易被拒 - 信用不足 | INSUFFICIENT_FUNDS |
交易由于资金不足被拒 |
| 6 | 交易被拒 - 银行系统错误 | ACQUIRER_SYSTEM_ERROR | 处理交易时发生收单行系统错误 |
| 7 | 支付服务器处理错误。 通常因输入数据（如信用卡号）无效导致。 也可能发生处理错误。 | SYSTEM_ERROR |
处理交易时发生内部系统错误 |
| 8 | 交易被拒 - 不支持此交易类型 | NOT_SUPPORTED |
不支持此交易类型 |
| 9 | 银行拒绝交易（请勿联系银行） | DECLINED_DO_NOT_CONTACT |
交易被拒 - 请勿联系发卡机构 |
| A | 已中止交易 | ABORTED |
交易被持卡人中止 |
| B | 交易被阻止 -以下情况返回： -验证安全级别值为 '07'， - 商家启用了 3D 验证阻止， - 总体风险评估结果返回 'Reject' 或 'System Reject' |
BLOCKED |
交易因风险或 3D 验证阻止规则被阻止 |
| C | 已取消交易 | CANCELLED |
交易被持卡人取消 |
| D | 交易延期 | DEFERRED_TRANSACTION_RECEIVED |
收到延期交易，等待处理 |
| E | 交易被拒 - 请咨询发卡机构 | REFERRED |
交易被拒 - 请咨询发卡机构 |
| F | 3DS 支付验证失败 | AUTHENTICATION_FAILED |
3DS 支付验证失败 |
| I | 卡安全码失败 | INVALID_CSC |
卡安全码无效 |
| L | 购物交易被锁定。 这指示发生了另一个使用相同购物交易编号的交易。 | LOCK_FAILURE |
订单被锁定 - 正在处理此订单的另一个交易 |
| M | 已提交交易（交易已被重定向到收单行，但支付服务器尚未收到此要完成的交易） | SUBMITTED |
已提交交易 - 尚未收到响应 |
| N | 持卡人未注册 3D 验证（仅身份验证） | NOT_ENROLLED_3D_SECURE |
持卡人未注册 3D 验证 |
| P | 交易等待处理 | PENDING |
交易等待处理 |
| R | 超过重试次数限制，未处理交易 | EXCEEDED_RETRY_LIMIT |
超过交易重试次数限制 |
| S | 交易被拒 - 批处理重复 | DUPLICATE_BATCH |
交易由于批处理重复被拒 |
| T | 地址验证失败 | DECLINED_AVS |
交易由于地址验证被拒 |
| U | 卡安全码失败 | DECLINED_CSC |
交易由于卡安全码被拒 |
| V | 地址验证和卡安全码失败 | DECLINED_AVS_CSC |
交易由于地址验证和卡安全码被拒 |
| W | 交易被拒 - 不支持此付款方案。 | DECLINED_PAYMENT_PLAN |
交易由于付款方案被拒 |
| X | 已审批的待处理结算 - 已由批处理结算系统审批，但仍在等待收单行提供更多详细信息。 | APPROVED_PENDING_SETTLEMENT |
已审批交易 - 等待批处理结算 |
| ? | 未知响应 | UNKNOWN |
未知响应 |
| 支付客户端/虚拟支付客户端 | DirectAPI | ||
|---|---|---|---|
| 响应代码 | 说明 | response.cardholderVerification.avs.gatewayCode |
说明 |
| X | 准确匹配 – 地址和 9 位数邮政编码 | ADDRESS_ZIP_MATCH |
街道地址和邮政编码匹配 |
| Y | 准确匹配 – 地址和 5 位数邮政编码 | ||
| D | 国际交易的街道地址和邮政编码匹配。 | ||
| M | 国际交易的街道地址和邮政编码匹配。 | ||
| F | 街道地址和邮政编码匹配。 仅适用于英国。 | ||
| W | 9 位数邮政编码匹配，地址不匹配 | ZIP_MATCH |
邮政编码匹配。 街道地址不匹配 |
| P | 国际交易的邮政编码匹配，但街道地址由于格式不符未验证。 | ||
| Z | 5 位数邮政编码匹配，地址不匹配 | ||
| A | 仅地址匹配 | ADDRESS_MATCH |
街道地址匹配 |
| B | 国际交易的街道地址匹配。 邮政编码由于格式不符未验证。 | ||
| S | 目前不支持此服务。 | SERVICE_NOT_SUPPORTED |
收单行或商家不支持当前服务 |
| G | 国际交易，未提供地址信息。 | NOT_VERIFIED |
无法验证国际交易的 AVS |
| C | 国际交易的街道地址和邮政编码由于格式不符未验证。 | ||
| I | 仅 Visa。 未验证国际交易的地址信息。 | ||
| R | 发卡机构系统不可用。 请重试。 | SERVICE_NOT_AVAILABLE_RETRY |
发卡机构系统不可用。 可以重试 |
| U | 未提供地址，没有来自发卡机构的数据。 | NOT_AVAILABLE |
没有来自发卡机构的数据或交易的 AVS 数据不受支持 |
| E | 不是邮购电话订单。 | ||
| N | 地址和邮政编码不匹配 | NO_MATCH |
不匹配 |
| 0（零） | 未请求 AVS。 （VisaII 使用。） | NOT_REQUESTED |
未请求 AVS |
| K | 仅持卡人姓名匹配。 | NAME_MATCH |
持卡人姓名匹配 |
| O | 持卡人姓名和地址匹配 | NAME_ADDRESS_MATCH |
持卡人姓名和地址匹配 |
| L | 持卡人姓名和邮政编码匹配 | NAME_ZIP_MATCH |
持卡人姓名和邮政编码匹配 |
| 支付客户端/虚拟支付客户端 | DirectAPI | ||
|---|---|---|---|
| 响应代码 | 说明 | response.cardSecurityCode.gatewayCode |
说明 |
| M | 有效或匹配的 CSC | MATCHED |
有效或匹配 |
| S | 商家指示 CSC 不显示在卡上 | NOT_PRESENT |
商家指示 CSC 不显示在卡上 |
| P | CSC 未处理 | NOT_PROCESSED |
未处理 |
| U | 发卡机构未注册和/或认证 | NOT_SUPPPORTED |
发卡机构未注册和/或认证 |
| N | 代码无效或不匹配 | NO_MATCH |
无效或不匹配。 |
可以，重新提交包含完全相同的详细信息的请求是安全的，因为网关支持幂等操作。 当重复调用时，幂等操作产生相同的结果。 如果网关已经收到您的请求，其将返回初始响应；否则将处理该请求并返回响应。
通常，您可以使用 order.id 和 transaction.id 字段将请求与响应匹配，因为它们在请求中提供，在响应中返回。 但是，如果您的应用程序不支持同步集成模式，或您的请求的来源和目标不同，您可以使用字段 correlationId 来识别请求及其匹配的响应。correlationId 是一个暂时识别码，它的值不会在网关中留存，并且与提供时一样在请求的响应中返回。 您可以对所有 DirectAPI 请求使用 correlationId。
No merchant acquirer link 错误？请联系 your payment service provider，以确保您在网关上的商家收单行链接是针对所需的卡类型和货币组合配置的。
Merchant Administration 是一个基于 Web 的界面，可让商家轻松查看和管理他们的订单。 商家可以搜索和查看他们的订单/交易详细信息、下载 CSV 报告、检查 3-D 验证结果、设置风险控制、手动创建订单、管理退款，还有更多。 有关详细信息，请参阅“Merchant Administration 用户指南”。
商家需要登录到网关并成功配置其商家配置文件以访问 Merchant Administration。
发卡机构或卡网络可能会以商家建议代码的形式提供附加信息，这将帮助您了解拒绝交易的原因。 当交易因资金不足而被拒绝时，建议代码可能会向商家推荐一个重试时间范围，在该时间范围内授权批准可能会成功。
下表提供组织返回的各种商家建议代码的说明。
| 商家建议代码 | 组织推荐 |
|---|---|
| 01 | 新账户信息可用 |
| 02 | 本次无法批准，请稍后再试 |
| 03 | 不要再试 |
| 04 | 此令牌类型未满足令牌要求 |
| 05 | 协商价值未获批准 |
| 21 | 取消付款 |
| 22 | 商家不满足使用产品代码的条件 |
| 24 | 1 小时后重试 |
| 25 | 24 小时后重试 |
| 26 | 2 天后重试 |
| 27 | 4 天后重试 |
| 28 | 6 天后重试 |
| 29 | 8 天后重试 |
| 30 | 10 天后重试 |
| R0 | 停止付款订单 |
| R1 | 取消授权订单 |
| R3 | 取消所有授权订单 |