空中云汇 (Airwallex) 钱包支付

AirwallexAlipayHK支付流程与API集成

最新推荐文章于 2025-12-05 09:41:13 发布

原创最新推荐文章于 2025-12-05 09:41:13 发布 · 2k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#程序人生 #经验分享

本文详细描述了如何使用AirwallexAPI进行AlipayHK的桌面网站浏览器支付，包括初始化付款意向和重定向至支付页面的过程，以及后续的支付结果通知和状态查询方法。

该文章已生成可运行项目，

看官方文档
以下是关键位置
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

全部api地址
https://www.airwallex.com/docs/api#/Payment_Acceptance/Payment_Intents/_api_v1_pa_payment_intents__id__confirm/post

本文章已经生成可运行项目