跨越支付 开发文档

线上支付订单QRCode

1、基本内容

接口地址:

/api/onlinepay/onlinepay_getQR

请求类型:POST

接口说明:根据提交充值订单,获取可支付付款码

注:该接口需要定时查询,查询频次控制2s/次以上,正常再2秒-10秒以内可响应;获得二维码后停止查询。


2、提交参数

参数是否必填描述
ordersn订单号,通过提交充值返回的参数
appid商户APPID
sign签名


3、返回参数

返回参数描述
status1:获取成功,不等于1:获取失败,表示数据获取成功可用把数据显示出来
err/msgstatus为0时,返回该参数,错误描述,表示还需要继续查询在,最多2分钟,未成功返回的,请重新提交。
datastatus1时,返回订单信息
data.amount选择充值的金额
data.qrurl二维码URL,可展示出来便于用户截图或扫描
data.effective_time数据有效期,单位为分钟,超时需重新获取,否则用户支付时支付宝或微信提示超时。
data.at_time数据生成时间,以该时间为参照,需要在有效期内完成支付
data.ordersn平台订单号
data.soid异常反馈码,可用通过该码和客服对接沟通



4、返回示例

{
    "status": 1,
    "data": {
        "amount": "100",
        "qrurl": "//pay-shop.serve.metfone.com/uploa********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
)