1、接口说明
通过该接口获取支付平台二维码,目前该接口支持返回支付宝和微信支付的官方二维码,付款用户可用直接扫码支付。
2、接口地址
POST|GET:https://{url}/api/onlinepay/onlinepay_getQR Content-Type:application/json
注:该接口需要定时查询,查询频次控制1s/次以上,正常再2秒-10秒以内可响应,获得二维码后停止查询,如大于20s未获取到数据,请重新操作下单接口下单。
3、提交参数
参数 | 是否必填 | 类型 | 描述 |
ordersn | 是 | str(50) | 订单号,通过提交充值返回的参数 |
appid | 是 | str(15) | 商户APPID |
sign | 是 | str(32) | 签名,签名算法见 |
4、返回参数
返回参数 | 类型 | 描述 |
status | int(4) | 1:获取成功,不等于1:获取失败,表示数据获取成功可用把数据显示出来 |
err/msg | int(50) | status为0时,返回该参数,错误描述,表示还需要继续查询在,最多2分钟,未成功返回的,请重新提交。 |
data | obj | status为1时,返回订单信息 |
data.amount | decimal(8,2) | 选择充值的金额 |
data.qrurl | str(50) | 二维码URL,可展示出来便于用户截图或扫描 |
data.effective_time | int(5) | 数据有效期,单位为分钟,超时需重新获取,否则用户支付时支付宝或微信提示超时。 |
data.at_time | int(11) | 数据生成时间(数据格式为11位时间戳),以该时间为参照,需要在有效期内完成支付. |
data.ordersn | str(50) | 平台订单号 |
data.soid | str(50) | 异常反馈码,可用通过该码和客服对接沟通 |
返回示例
{ "status": 1, "data": { "amount": "100", "qrurl": "//static.crossingpay.com/ploa********293d2248c572a5de0919bd.png", "effective_time": 2, "at_time": 1675081272, "ordersn": "O1T1308***PS461", "soid": "8cca6537-a***c3b4d27976", } }
5、用户支付成功回调参数及接口
用户支付完成,系统异步通知到商户系统,便于商户系统及时处理业务逻辑。
回调接口:请参照异步回调说明或主动请求获取支付状态,http://www.crossingpay.com/devdocumentation/52.html
回调参数:
array ( 'orderid' => 'sh-56073d***8a2ff5521a',//商户订单号,等同于提交参数的orderid 'localusermark' => '1',//用户标识 'amount' => '30000',//到账金额,为提升精度,需要除以10000 'appid' => 'VunT***h1l8',//商户appid 't' => '1662299838',//时间戳 'sign' => '237A3D3EEFE6***F408EA7EFFB1F2',//参数签名,请参照签名说明:http://www.crossingpay.com/devdocumentation/6.html )