1.9 KiB
查询订单【必要】 接口说明
- 订单查询接口
- GET 请求
- application/x-www-form-urlencoded
- 接口地址 adapter-apiaccess/open/api/queryOrderV2
请求参数 参数 类型 示例值 必要 描述 请求公共参数 —— 参考接口规范的请求公共参数 是 携带公共参数 out_order_id string OUT202503010010208888 是 来源/外部订单号
响应信息 参数 类型 示例值 必要 描述 响应公共参数 —— 请参考接口规范的响应公共参数 是 携带公共参数 请求异常情况下,下面的参数都是非必要的下标描述的是请求接收正常情况下的参数说明 out_order_id string OUT202503010010208888 是 来源/外部订单号 order_id string 202503010010208888 是 供货方的订单号 order_type int 4 是 订单类型:0-直充;1-话费;2-流量;3-卡密 order_status int 0 是 0,待处理;1,处理中;2,成功;3,失败 4-异常 fail_reason string 否 失败原因,失败必传 create_time string 2025/3/1 0:10 是 订单创建时间(原厂) finish_time string 2025/3/1 0:10 否 订单完成时间(原厂) cards string 加密数据 否 卡密订单时才可能有数据,使用ASE加密,加密方式参考附录的数据加密部分
code数据对业务流程的影响
- 查询订单时如果返回非 200 的状态码,订单失败,流程结束
order_status数据对业务流程的影响
- 当为 0 和 1 时,订单没有结束,
- 需要调用方自轮询查询订单;
- 或本平台订单结束后,异步通知订单结果
- 当为 2 和 3 、4 时,订单结束
cards解密后的结构如下 [ { card_no: 'CN88889999',(无卡号就填""空串) card_pwd: 'ABCD-DEFG-GHIJ-JKLM', expired_time: '2026-09-27 08:36:58',(过期时间,可不传) price: '8.8',(卡密单价,可不传) card_type: '0'(不传时,默认为0。0.普通卡密 1.短链) } ]