支付

用于创建支付

支付流程

1.创建支付 -> 2.返回支付链接和参数 -> 3.用户支付 -> 4.支付成功回调

回调须知

1.支付成功后，会立即向回调地址POST一个JSON格式的回调通知，包含支付相关信息。

2.回调通知中包含的参数请参考支付回调参数。

3.回调通知中包含的sign参数是对回调通知中其他参数进行MD5加密后的结果，用于验证回调通知的完整性和真实性，确保回调通知没有被篡改。

4.回调请求需直接返回success字符串，否则会导致回调失败。

5.回调失败后，系统会自动重试，最多重试5次，每次重试间隔为15s/1m/5m/10m/15m。

通联基础收银台

接口地址

https://服务api地址/externalApi/v1/pay/allinpay-cashier

POST参数

提交参数	类型	长度	说明
order_sn	string	50	商户订单号
amount	number	10,2	支付金额，单位为元(香港通道为港币)，保留2位小数
body	string	200	订单内容描述
return_url	string	200	返回地址，支付完成后会显示此地址内容
notify_url	string	200	通知回调地址，支付成功后会向该地址POST一个JSON格式的回调通知
notify_additional	string	200	附加信息，用于存储额外的支付相关数据，如订单号、用户ID等，会在支付成功回调中原样返回

返回参数

返回参数	类型	说明
out_trade_no	string	支付订单号，系统自动生成，用户订单查询
url	string	支付链接，用户点击该链接即可跳转到支付页面，支持微信和支付宝

支付宝唤起方式

javascript

function alipay() {
    location.href = 'alipays://platformapi/startapp?saId=10000007&qrcode=' + encodeURIComponent('url地址');
}

通联香港统一支付

接口地址

https://服务api地址/externalApi/v1/pay/allinpay-hk-union

POST参数

提交参数	类型	长度	说明
group	string	50	登录平台（h5：H5，wechat：微信浏览器）
channel	number	10	支付渠道（1：支付宝，2：微信）
wallet_type	number	10	支付宝钱包类型（0：内地，1：香港）
order_sn	string	50	商户订单号
amount	number	10,2	支付金额，单位为元(香港通道为港币)，保留2位小数
body	string	200	订单内容描述
return_url	string	200	返回地址，支付完成后会显示此地址内容
notify_url	string	200	通知回调地址，支付成功后会向该地址POST一个JSON格式的回调通知
notify_additional	string	200	附加信息，用于存储额外的支付相关数据，如订单号、用户ID等，会在支付成功回调中原样返回

返回参数

返回参数	类型	说明
out_trade_no	string	支付订单号，系统自动生成，用户订单查询
url	string	支付链接，用户点击该链接即可跳转到支付页面（微信支付）
action	string	from表单action地址（支付宝支付）
method	string	from表单method方法（支付宝支付）
params	string	from表单input的key/value（支付宝支付）

支付宝form表单

当使用支付宝支付时，请参考以下代码唤起支付：

html

<form action="<?= $action ?>" method="<?= $method ?>" id="form">
    <div>
        <?php foreach ($params as $k => $v) { ?>
        <input type="hidden" name="<?= $k; ?>" value="<?= $v; ?>">
        <?php } ?>
    </div>
</form>
<script>
    $(function () {
        $('#form').submit();
    });
</script>

通联香港无卡支付

支持 Visa / Mastercard / Apple Pay / Google Pay，用户跳转到通联 CNP 托管收银台完成支付。

接口地址

https://服务api地址/externalApi/v1/pay/allinpay-hk-cnp

POST参数

提交参数	类型	长度	说明
order_sn	string	50	商户订单号
amount	number	10,2	支付金额，单位为元(香港通道为港币)，保留2位小数
body	string	200	订单内容描述
return_url	string	200	返回地址，支付完成后会跳转至此地址（系统会自动附带 out_trade_no）
notify_url	string	200	通知回调地址，支付成功后会向该地址POST一个JSON格式的回调通知
notify_additional	string	200	附加信息，用于存储额外的支付相关数据，如订单号、用户ID等，会在支付成功回调中原样返回

返回参数

返回参数	类型	说明
out_trade_no	string	支付订单号，系统自动生成，用于订单查询
url	string	支付中间页链接（固定授权域名），打开后自动跳转通联 CNP 收银台

唤起方式

javascript

// 浏览器或 App 内 WebView 打开返回的 url
location.href = url;

支付回调参数

返回参数	类型	说明
amount	number	支付金额，单位为元(香港通道为港币)，保留2位小数
order_sn	string	商户订单号
out_trade_no	string	支付订单号
transaction_id	string	三方订单号，微信、支付宝支付成功后生成的订单
body	string	订单内容描述
notify_additional	string	附加信息，用于存储额外的支付相关数据，如订单号、用户ID等，会在支付成功回调中原样返回
key	string	APIKEY
pay_status	number	支付状态，0：待支付，1：已支付，2：支付中，-1：支付失败
pay_time	number	支付完成时间，时间戳（秒）
sign	string	签名，用于验证回调通知的完整性和真实性，确保回调通知没有被篡改

订单查询

接口地址

https://服务api地址/externalApi/v1/pay/query

POST参数

提交参数	类型	长度	说明
out_trade_no	string	50	支付订单号

返回参数

返回参数	类型	说明
amount	number	支付金额，单位为元(香港通道为港币)，保留2位小数
order_sn	string	商户订单号
out_trade_no	string	支付订单号
transaction_id	string	三方订单号，微信、支付宝支付成功后生成的订单
body	string	订单内容描述
notify_additional	string	附加信息，用于存储额外的支付相关数据，如订单号、用户ID等，会在支付成功回调中原样返回
pay_status	number	支付状态，0：待支付，1：已支付，2：支付中，-1：支付失败
pay_time	number	支付完成时间，时间戳（秒）

订单退款

用于对已支付的通联香港统一支付（Union）或无卡支付（CNP）订单发起退款。系统根据原支付通道自动选择退款方式，支持部分退款（累计退款金额不可超过支付金额）。

接口地址

https://服务api地址/externalApi/v1/pay/refund

POST参数

提交参数	类型	长度	说明
out_trade_no	string	50	支付订单号（创建支付接口返回的 out_trade_no）
amount	number	10,2	退款金额，单位为元(香港通道为港币)，保留2位小数

返回参数

返回参数	类型	说明
out_trade_no	string	支付订单号
refund_sn	string	退款单号，系统自动生成
amount	number	原支付金额，单位为元(香港通道为港币)，保留2位小数
refund_amount	number	本次退款金额，单位为元(香港通道为港币)，保留2位小数
refund_fee	number	累计已退款金额，单位为元(香港通道为港币)，保留2位小数
is_refund	number	是否已退款，0：未退款，1：已退款
refund_status	number	本次退款状态，1：退款成功，2：退款处理中

说明

仅支持通联香港 Union / CNP 已支付成功的订单。
Union 退款可能为异步处理（refund_status=2），通道处理完成后会回调系统，无需商户侧额外处理。
CNP 退款一般为同步结果（refund_status=1 即成功）。
同一笔支付订单可多次部分退款，但累计 refund_fee 不得超过原支付金额。

支付 ​

通联基础收银台 ​

通联香港统一支付 ​

通联香港无卡支付 ​

支付回调参数 ​

订单查询 ​