AlipayHK(Alipay+)

支付方式属性

字段名称	内容
可用国家代码	中国香港 (HK)
消费者货币	港元 (HKD)
处理货币	澳元 (AUD), 加元 (CAD), 瑞士法郎 (CHF), 人民币 (CNY), 欧元 (EUR), 英镑 (GBP), 港元 (HKD), 日元 (JPY), 纽元 (NZD), 新加坡元 (SGD), 美元 (USD)
结算货币	澳元 (AUD), 加元 (CAD), 瑞士法郎 (CHF), 欧元 (EUR), 英镑 (GBP), 港元 (HKD), 日元 (JPY), 纽元 (NZD), 新加坡元 (SGD), 美元 (USD)
类型 I	电子钱包 (wallet)
类型 II	`alipayhk`
最小交易金额	HKD 0.01 元
最大交易金额	50,000 HKD/笔;200,000 HKD/年
会话超时	10 分钟，取决于流程
退款	支持全额退款、部分退款和多次部分退款
退款有效期	365 天
拒付	无
集成类型	异步

交易流程

在商家结账页面，消费者选择使用AlipayHK(Alipay+)付款。
商户向AlipayHK(Alipay+)发送交易请求。
如果消费者通过桌面浏览器付款：
1. 消费者被重定向到AlipayHK(Alipay+)页面
2. 消费者可以扫描二维码，或者登录AlipayHK(Alipay+)网站进行支付。
如果消费者通过移动设备付款：
1. AlipayHK(Alipay+)向商户的移动网站返回支付链接。
2. 商家的移动网站将消费者重定向到AlipayHK(Alipay+)应用内支付页面。
3. 消费者在AlipayHK APP上完成支付。

集成

请求参数说明：

参数名	类型	必填	说明
`reference`	String	是	订单唯一标识
`amount`	Object	是	订单金额信息
├── `currency`	String	是	货币类型（如 HKD, USD）
├── `value`	Number	是	金额数值，单位为最小货币单位
`productDetail`	String	是	订单描述
`countryCode`	String	是	国家代码（如 HK）
`origin`	String	是	订单来源，如商城域名
`paymentMethod`	Object	是	支付方式信息
├── `holderName`	String	否	持卡人姓名
├── `shopperEmail`	String	否	付款人邮箱
├── `type`	String	是	支付方式（如 alipayhk）
`returnUrl`	String	是	支付完成后返回的 URL
`browserInfo`	Object	否	设备浏览器信息
├── `osType`	String	否	操作系统类型（如 IOS, ANDROID,OTHER）
├── `terminalType`	String	否	终端类型（如 APP, WAP,WEB,MINI_APP）
`shopperReference`	String	是	付款人唯一标识

交易调用输入示例

{
    "reference": "TR1739188526ANM7D5",
    "amount": {
        "currency": "CNY",
        "value": 4500
    },
    "productDetail": "描述订单",
    "countryCode": "TH",
    "origin": "fffmall.com",
    "paymentMethod": {
        "holderName": "test",
        "shopperEmail": "[email protected]",
        "type": "alipayhk"
    },
    "returnUrl": "https://www.baidu.com",
    "browserInfo": {
        "osType": "IOS",
        "terminalType": "APP"
    },
    "shopperReference": "8cc77a71707447819ef87155926516cc"
}

响应参数说明

参数名	类型	必填	说明
`code`	String	是	响应状态码，"0" 表示成功
`msg`	String	是	响应消息
`serverTime`	Number	是	服务器时间戳，单位毫秒
`data`	Object	是	业务数据对象
├── `action`	Object	是	支付跳转相关信息
│ ├── `paymentMethodType`	String	是	支付方式类型（如 alipayhk）
│ ├── `schemeUrl`	String	否	支付宝 scheme URL（用于 App 内支付）
│ ├── `applinkUrl`	String	否	支付宝 App 链接 URL（用于外部浏览器跳转）
│ ├── `url`	String	是	Web 端支付 URL
│ ├── `method`	String	是	请求方法（如 Get）
│ ├── `type`	String	是	操作类型（如 redirect）
├── `amount`	Object	是	订单金额信息
│ ├── `currency`	String	是	货币类型（如 HKD, USD）
│ ├── `value`	Number	是	金额数值，单位为最小货币单位
├── `merchantReference`	String	是	商户订单号
├── `pspReference`	String	是	支付平台交易号
├── `resultCode`	String	是	支付结果状态（如 PENDING）
`success`	Boolean	是	是否成功（true 表示成功）

交易调用响应示例

{
    "code": "0",
    "msg": "success",
    "serverTime": 1739257937234,
    "data": {
        "action": {
            "paymentMethodType": "alipayhk",
            "schemeUrl": "alipayconnect://platformapi/alipayconnectcode.html?code=281666040099hsDB6IgeR48ustzUrk8v4Zff&pspName=ALIPAY_CN&loadMode=2",
            "applinkUrl": "https://psp.ac.alipay.com/page/simulation-wallet/acwallet/alipayconnectcode.html?code=2816660400949Sy36H8Dh0ch7H6GlNKv4Io2&pspName=ALIPAY_HK&loadMode=2",
            "url": "https://psp.ac.alipay.com/page/simulation-wallet/acwallet/alipayconnectcode.html?code=2816660400949Sy36H8Dh0ch7H6GlNKv4Io2&pspName=ALIPAY_HK&loadMode=2&needPull=false",
            "method": "Get",
            "type": "redirect"
        },
        "amount": {
            "currency": "CNY",
            "value": 4500
        },
        "merchantReference": "TR1739188526ANM7D5",
        "pspReference": "1889210827400151040",
        "resultCode": "PENDING"
    },
    "success": true
}

附加信息

人民币处理须知

所有以人民币处理的交易均以美元或欧元结算。Alipay+对每笔交易采用一个外汇汇率，并以预定的结算货币（美元或欧元）向我们结算转换后的金额。我们也会与您结算转换后的金额。这意味着您必须跟踪每笔交易的外汇汇率，以便将其转换为结算货币（美元或欧元）。