聚合正扫

接口说明:支持主扫、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":""}}