跨越支付 开发文档

交易查询

1、接口说明:

根据订单号获取支付状态,商户可根据实际情况自行处理业务逻辑。

2、接口地址:

POST:https://{url}/api/onlinepay/onlinepay_getorderstatus
Content-Type:application/json

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

3、提交参数

参数是否必填类型描述
ordersnstr(50)订单号,通过下单地址返回的参数
callbacurlstr(255)检测支付成功后跳转页面(2023年1月1日起该字段暂缓)
appidstr(15)商户APPID
signstr(32)签名

4、返回参数

返回参数类型描述
statusint(4)1:获取成功,不等于1:获取失败
err/msgint(50)status为0时,返回该参数,错误描述
dataobjstatus1时,返回订单信息
data.orderstatusint(4)订单状态
data.status_textint(20)状态对应中文标识
data.attimeint(11)查询时间
data.urlstr(255)跳转页面(2023年1月1日起该字段暂缓)

orderstatus订单状态说明:

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

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

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

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

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

返回示例

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

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