看官方文档
以下是关键位置
https://www.airwallex.com/docs/payments__apac__alipay-hk__desktop-website-browser
- 购物者选择使用AlipayHK付款,并被重定向到AlipayHK收银台 购物者
- 使用AlipayHK应用程序扫描二维码并完成付款
- 付款成功,购物者被重定向回您指定的页面
主要是两个步骤
第 1 步。初始化付款意向
从后端服务器创建带有 、 和 的付款意图对象。request_idamountcurrencymerchant_order_id
curl -X POST \
https://api.airwallex.com/api/v1/pa/payment_intents/create \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJhNDc...' \
-d '{
"request_id": "ed11e38a-7234-11ea-aa94-7fd44ffd1b89",
"amount": 20,
"currency": "HKD",
"merchant_order_id": "85d7b0e0-7235-11ea-862e-9f6aa1adfca6"
"return_url": "https://www.airwallex.com"
}'
第 2 步。重定向至相关的网页完成付款
当购物者在桌面浏览器选择使用AlipayHK付款时,调用以下API端点以获取电子钱包收银员URL,您可以将该URL重定向到AlipayHK收银员以完成付款。
从Airwallex获取网址,并将购物者重定向到AlipayHK收银台
请求:
curl -X POST \
https://api.airwallex.com/api/v1/pa/payment_intents/{id}/confirm \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJhNDc...' \
-d '{
"request_id": "ed11e38a-7234-11ea-aa94-7fd44ffd1b89",
"payment_method":
{
"type": "alipayhk",
"alipayhk": {
"flow": "webqr"
}
}
}'
响应:呈现将购物者重定向到支付宝收银员的价值。qrcode_url
{
"next_action": {
"type": "redirect",
"method": "GET",
"url": "https://render.alipay.com/p/c/jzmcoal2/hkcheck..."
}
}
等待Airwallex的通知
Airwallex将通过webhook API异步通知您付款结果。请参考 webhook 文档来相应地设置您的 webhook。虽然订阅不同的活动是可选的,但建议至少订阅“payment_intent.successed”,这表明购物者已成功通过AlipayHK支付订单。
查询付款意向状态
您也可以随时通过付款意向API查询付款状态
GET /payment_intents/{id}
以下是相关的其他官方接口
认证
https://api.airwallex.com/api/v1/authentication/login
获取可用的付款方式
https://api.airwallex.com/api/v1/pa/config/payment_method_types?transaction_currency=SGD&transaction_mode=oneoff&country_code=HK