跨越支付 开发文档

线上支付查询支付订单状态

1、基本内容

接口地址:

/api/onlinepay/onlinepay_getorderstatus

请求类型:POST   Content-Type:application/json

接口说明:根据订单号获取支付状态

注:该接口需要定时查询,查询频次控制2s/次以上。


2、提交参数

参数是否必填描述
ordersn订单号,通过提交充值返回的参数
callbacurl检测支付成功后跳转页面
appid商户APPID
sign签名


3、返回参数

返回参数描述
status1:获取成功,不等于1:获取失败
err/msgstatus为0时,返回该参数,错误描述
datastatus1时,返回订单信息
data.orderstatus订单状态
data.status_text状态对应中文标识
data.attime查询时间
data.url跳转页面

订单状态说明:

  1. 【0】等待支付,预支付订单已创建成功,排队生成支付收款码;

  2. 【1】支付成功,用户已支付完成,系统已收到款项;

  3. 【2】回调成功,已返回收款码,等待用户支付,该状态会多返回一个QRinfo的字段,包含了收款码信息;

  4. 【3】支付超时/失败取消:用户未在5分钟内完成支付操作,二维码已过期,自动取消订单;

  5. 【4】订单异常:其他未知原因导致订单支付失败。


4、返回示例

{
    "status": 1,
    "data": {
        "status": 1,
        "orderstatus": 1,
        "status_text": "支付成功",
        "attime": 1675134039
    }
}
....

{
    "code": 0,
    "err": {
        "status": 3,
        "orderstatus": 3,
        "status_text": "支付超时/失败取消订单",
        "attime": 1675133994
    }
}