- 集成指南
- 支持的功能（付款方式）
- 实施浏览器付款集成
- Alipay 支付
Alipay
Alipay 是在中国使用的电子钱包，让客户可以使用其 Alipay 余额或从电子钱包中选择付款方式来在线购买商品。
Alipay 是一种受 <<paymentGateway>> 支持的浏览器付款方式。 此页内容介绍特定于 Alipay 的集成详细信息。 建议您在构建 Alipay 集成前，先阅读浏览器付款集成指南。
Alipay 浏览器付款支持使用以下货币进行交易：AUD、CAD、EUR、GBP、HKD、SGD、USD、CHF、JPY、NZD、CNY。
请注意，网关仅支持进入中国市场的跨境商家（即国际商家）以及希望使用 Alipay 支付的位于国外的中国游客使用 Alipay。 网关不允许为定居中国的商家本地处理 CNY。
如果是跨境商家：
- 订单金额将使用处理货币（例如，EUR）向付款人呈现（由网关呈现）。
- 付款人将由 Alipay 使用 CNY 扣款，并被收取货币兑换费。
- 商家将由浏览器付款服务提供商使用 EUR 结算。
先决条件
若要通过 <<paymentGateway>> 作为付款方式提供 Alipay：
- 您必须向您的浏览器付款服务提供商注册。
- 您在网关上的商家配置文件必须通过浏览器付款服务提供商使用您的账户的详细信息配置。
- 您必须有使用支持的货币之一的银行账户，且该账户已向您在浏览器付款服务提供商处的商家账户注册。
Alipay 集成
使用 <<checkout>> 集成版本 51 及更高版本，当 your payment service provider 为您启用并配置 Alipay 后，它将对您的付款人自动可用。
有关详细信息，请参阅通过 <<checkout>> 集成进行浏览器付款。
<<directPayment>> 集成可让您在自己的结账页提供 Alipay 付款方式。
在 sourceOfFunds.type = ALIPAY 且 browserPayment.operation = PAY 时发起 Initiate Browser Payment 请求（Alipay 不支持 Authorize 操作）。 对于标准字段，请参阅通过 <<directPayment>> 集成进行浏览器付款。
首选语言
您可以通过在 Initiate Browser Payment 请求中提供 browserPayment.preferredLanguage 字段来设置 Alipay 为向付款人显示的页面使用的首选语言。 不过，此语言只有在 Alipay 支持时才能够使用。
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"browserPayment":{
"operation":"PAY",
"returnUrl":"https://<return_url>"
},
"order":{
"amount":"10.00",
"currency":"GBP"
},
"sourceOfFunds":{"type":"ALIPAY"
}
}
如何解释交易结果
下表显示了在发起 Alipay 付款后您可能遇到的可能出现的情景的交易响应代码。
Initiate Browser Payment 响应 |
具体含义... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
使用响应中提供的 URL 重定向付款人。 |
Retrieve Transaction/Retrieve Order 响应 |
具体含义... |
response.gatewayCode=APPROVEDresult=SUCCESS |
付款成功。 |
response.gatewayCode=PENDINGresult=PENDING |
<<paymentGateway>> 等待来自收单行的付款结果通知。 稍后重试 RETRIEVE_TRANSACTION 或接收来自网关的通知。 |
response.gatewayCode=CANCELLEDresult=FAILURE |
付款人已取消此付款的交互。 为付款人提供尝试其他付款方式的选项。 |
response.gatewayCode=DECLINED or ACQUIRER_SYSTEM_ERRORresult=FAILURE |
付款被拒绝。 为付款人提供尝试其他付款方式的选项。 如果出现 ACQUIRER_SYSTEM_ERROR，您可能需要询问收单行付款失败的原因，也可以重试 RETRIEVE_TRANSACTION。 |
response.gatewayCode=TIMED_OUTresult=FAILURE |
请将此情况视为被拒付款。 <<paymentGateway>> 将进行尝试以确保交易不成功或撤消交易。 |
退款
您可以部分或全部退还 Alipay 付款。 您必须在 <<paymentGateway>> 以及您在浏览器付款服务提供商处的商家账户中进行退款配置。
测试您的集成
<<paymentGateway>> 提供允许您测试您的 Alipay 集成的浏览器付款模拟器。