Appearance
支付
用于创建支付
- 支付流程
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 | 支付链接,用户点击该链接即可跳转到支付页面,支持微信和支付宝 |
- 支付宝唤起方式
javascript
function alipay() {
location.href = 'alipays://platformapi/startapp?appId=20000067&url=' + encodeURIComponent('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 | 支付完成时间,时间戳(秒) |
