1、接口说明:
根据订单号获取支付状态,商户可根据实际情况自行处理业务逻辑。
2、接口地址:
POST:https://{url}/api/onlinepay/onlinepay_getorderstatus Content-Type:application/json
注:该接口需要定时查询,查询频次控制2s/次以上。
3、提交参数:
参数 | 是否必填 | 类型 | 描述 |
ordersn | 是 | str(50) | 订单号,通过下单地址返回的参数 |
callbacurl | 否 | str(255) | 检测支付成功后跳转页面(2023年1月1日起该字段暂缓) |
appid | 是 | str(15) | 商户APPID |
sign | 是 | str(32) | 签名 |
4、返回参数:
返回参数 | 类型 | 描述 |
status | int(4) | 1:获取成功,不等于1:获取失败 |
err/msg | int(50) | status为0时,返回该参数,错误描述 |
data | obj | status为1时,返回订单信息 |
data.orderstatus | int(4) | 订单状态 |
data.status_text | int(20) | 状态对应中文标识 |
data.attime | int(11) | 查询时间 |
data.url | str(255) | 跳转页面(2023年1月1日起该字段暂缓) |
orderstatus订单状态说明:
【0】等待支付,预支付订单已创建成功,排队生成支付收款码;
【1】支付成功,用户已支付完成,系统已收到款项;
【2】回调收款信息已返回,已返回收款码,等待用户支付,该状态会多返回一个QRinfo的字段,包含了收款码信息;
【3】支付超时/失败取消:用户未在5分钟内完成支付操作,二维码已过期,自动取消订单;
【4】订单异常:其他未知原因导致订单支付失败。
返回示例
{ "status": 1, "data": { "status": 1, "orderstatus": 1, "status_text": "支付成功", "attime": 1675134039 } } .... { "code": 0, "err": { "status": 3, "orderstatus": 3, "status_text": "支付超时/失败取消订单", "attime": 1675133994 } }