聚合正扫
接口说明:支持主扫、H5、微信公众号、小程序、服务窗等
应用场景:系统调用该接口后,返回支付URL调起支付或跳转至聚合收银台进行支付。
支付请求接口
生产环境请求地址: http://send.tonglian.xyz/pay/create.aspx
请求方法: POST/GET
| 参数名 |
参数值 |
可空 |
加入签名 |
说明 |
| 应用ID |
appId |
否 |
是 |
商户应用ID,商户中心应用管理中获取应用ID值 |
| 支付方式 |
payMethod |
否 |
是 |
商户中心支付配置中获取通道代码值
取值:微信扫码(跳转收银台模式):1004 微信二维码(返回JSON数据模式):1007 微信H5(跳转收银台模式):1006 微信公众号(返回JSON数据模式):1008 支付宝扫码(跳转收银台模式):992 支付宝二维码(返回JSON数据模式):1011 支付宝H5(跳转收银台模式):1010 支付宝APP(返回JSON数据模式):1009 云闪付(返回JSON数据模式):993
|
| 提交金额 |
amount |
否 |
是 |
单位元(人民币) |
| 商户订单号 |
orderId |
否 |
是 |
该值需在商户系统内唯一 |
| 异步通知地址 |
notifyUrl |
否 |
是 |
异步通知的地址 |
| 备注信息 |
attach |
是 |
否 |
备注信息,下行中会原样返回 |
| 签名 |
sign |
否 |
否 |
SHA256WITHRSA商户私钥进行签名,平台以商户公钥进行验签,商户公私钥由在应用管理中获取,密钥位数为2048 |
签名说明:
为了保证数据传输过程中的数据真实性和完整性,我们需要对数据进行数字签名,平台在接收签名数据之后进行签名校验,以验证数据报文的真实性及有效性,防止报文被恶意篡改。
签名生成规则:上送报文体中,业务数据appId={0}&payMethod={1}&amount={2}&orderId={3}&notifyUrl={4}即为签名原文其中{}为占位符,将其使用约定的签名算法计算得到签名。
目前仅支持SHA256WithRSA签名方式,签名时需使用平台提供的商户私钥进行签名。得到签名后,需要将其放入报文体的sign字段中一起上送,以供服务端进行签名验证。
1. 对于跳转收银台模式直接用GET方式进行跳转,对于返回JSON数据模式直接用POST方式进行请求。
2. 对于应用场景为JSON数据模式(POST提交)的提交,同步返回为JSON格式的字符串,跳转收银台模式(GET提交)为跳转页面模式无直返数据可以忽略
| 参数名 |
参数 |
说明 |
| 状态id |
id |
0 成功,1 失败 |
| 状态code |
code |
SUCCESS 成功,Fail 失败 |
| 状态描述 |
message |
状态描述 |
| 数据内容 |
data |
返回的数据内容如下 |
| data |
orderid |
商户订单号 |
| data |
sysorderid |
接口订单号 |
| data |
amount |
提交金额 |
| data |
payMethod |
支付方式 |
| data |
qrcode |
二维码链接 |
| data |
attach |
备注信息 |
示例直返值:{"id":0,"code":"SUCCESS","message":"获取数据成功","data":{"orderid":"202301030003","sysorderid":"23010311255566140003","amount":"1","payMethod":"1007","qrcode":"https%3a%2f%2forder.duolabao.com%2factive%2fc%3fstate%3d23010311255566140003%257C10011029166929072805621%257C1.00%257C%257CAPI","attach":""}}