- 集成指南
- 支持的功能（付款方式）
- 实施浏览器付款集成
- UnionPay SecurePay 支付
UnionPay SecurePay
以电子商务交易的全球支付系统银联在线支付 (UPOP) 为依托的银联国际推出 UnionPay SecurePay 服务，允许付款人在 UnionPay SecurePay 网站上使用其 UPOP SecurePay 账户在线购物。
UnionPay SecurePay 是一种受 Mastercard Gateway 支持的浏览器付款方式。 此页内容介绍特定于 UnionPay SecurePay 的集成详细信息。 建议您在构建 UnionPay SecurePay 集成前，先阅读浏览器付款集成指南。
先决条件
若要通过 Mastercard Gateway 作为付款方式提供 UnionPay SecurePay：
- 您必须通过 your payment service provider 加入 UPOP。
- 配置 UPOP 后，必须由 your payment service provider 通过 UPOP 使用您的账户的详细信息配置您在 Mastercard Gateway 上的商家配置文件。
- 结账页必须符合 UnionPay SecurePay 的品牌要求。 请参见银联国际电子商务商家接受指南。
UnionPay SecurePay 集成
使用 Hosted Checkout 集成版本 34 及更高版本，当 your payment service provider 为 UnionPay SecurePay 配置了收单行链接时，UnionPay SecurePay 将自动可用。
interaction.timeout 字段限制付款人完成订单的时间，当距离付款过期的剩余时间不足 900 秒时，付款人将不再能够选择 UnionPay SecurePay 作为 Hosted Checkout 的付款方式。 有关详细信息，请参阅通过 Hosted Checkout 集成进行浏览器付款。
如果您希望在自己的结账页提供 UnionPay SecurePay 付款方式，请选择 Direct Payment 集成。
发出 Initiate Browser Payment 请求，其中 sourceOfFunds.type = UNION_PAY。 其他详细信息，请参阅通过 Direct Payment 集成进行浏览器付款。
如何解释交易结果
下表显示了在发起 UnionPay SecurePay 浏览器付款后您可能遇到的可能出现的情景的交易响应代码。
| 情景 | Retrieve Transaction/Retrieve Order 响应 |
|---|---|
| TRANSACTION SUCCESSFUL | |
| 付款成功。 | browserPayment.interaction.status=COMPLETEDresponse.gatewayCode=APPROVED |
| TRANSACTION NOT SUCCESSFUL | |
| 付款被收单行拒绝。 | browserPayment.interaction.status=COMPLETEDresponse.gatewayCode=DECLINED |
| 付款未成功，因为收单行无法进行处理。 | browserPayment.interaction.status=COMPLETEDresponse.gatewayCode=ACQUIRER_SYSTEM_ERROR |
| Mastercard Gateway 无法成功发起 UnionPay SecurePay 付款。 | browserPayment.interaction.status=N/Aresponse.gatewayCode=SYSTEM_ERROR |
| Mastercard Gateway 已经收到付款人浏览器，并将其重定向到 UnionPay SecurePay。 未在 2 小时内发生付款。 此付款的所有重定向请求均被 Mastercard Gateway 拒绝。 |
browserPayment.interaction.status=REDIRECTED_TO_PROVIDERresponse.gatewayCode=DECLINED |
| Mastercard Gateway 未在 24 小时内收到来自商家的付款人浏览器的重定向。 未发生付款，此付款的所有重定向请求均被 Mastercard Gateway 拒绝。 |
browserPayment.interaction.status=INITIATEDresponse.gatewayCode=TIMED_OUT |
| 交易结果未知（正在处理） | |
| 已经在网关中成功发起交易。 网关尚未从商家收到要重定向到 UnionPay SecurePay 的付款人浏览器。 尚未发生付款。 | browserPayment.interaction.status=INITIATEDresponse.gatewayCode=SUBMITTED |
| 网关已接收到付款人的浏览器并将其重定向至 UnionPay SecurePay。 尚未发生付款。 |
browserPayment.interaction.status=REDIRECTED_TO_PROVIDERresponse.gatewayCode=SUBMITTED |
| 网关已将付款人浏览器返回到商家。 网关目前正在尝试查明付款是否成功。 |
browserPayment.interaction.status=RETURNED_TO_MERCHANTresponse.gatewayCode=SUBMITTED |
| 网关无法查找付款成功或其他结果的信息。 网关可能仍在查找和更新交易。 您可以跟进 Retrieve Transaction 请求（因为网关可能已经找到了结果）或使用网关的 Webhook 通知（如果您已订阅）。 |
browserPayment.interaction.status=RETURNED_TO_MERCHANTresponse.gatewayCode=UNKNOWN |
| 交易状态未知 | |
| 网关无法查找付款成功或其他结果的信息。 网关将不再尝试查找。 您必须联系收单行来查找结果。 |
browserPayment.interaction.status=N/Aresponse.gatewayCode=UNKNOWN |
过账和退款
您可以使用 API Capture/Refund 操作或通过 Merchant Administration 对 UnionPay SecurePay 订单执行后续的过账或退款。
取消
您可以使用 API Void 操作或通过 Merchant Administration 在 UnionPay SecurePay 订单上执行 Void 交易。 仅 Authorize、Capture 和 Pay 交易支持取消。
测试您的集成
Mastercard Gateway 提供允许您测试您的 UnionPay SecurePay 集成的 UnionPay SecurePay 模拟器。
疑难解答和常见问题
Retrieve Transaction 响应中没有返回卡号？您在 UPOP 的商家账户可以配置为不返回卡号。 在这种情况下，您不会在 Retrieve Transaction 响应中看到返回的卡号。 如果您希望在 UPOP 更改此配置，请联系 your payment service provider 。
如果 Mastercard Gateway 无法识别与付款人的卡关联的卡组织和卡品牌，Retrieve Transaction 将返回 sourceOfFunds.provided.card.scheme=OTHER 和 sourceOfFunds.provided.card.brand=UNKNOWN。