9、订单状态查询接口

创建于 2025-04-08 / 最近更新于 2025-04-09 / 134

字体： [默认] [大] [更大]

接口说明：
用于获取订单的最终执行结果。建议在下单完成后间隔 1~3 秒调用本接口以获取准确状态。
注意事项：
每笔订单在状态为“成功”或“已退款”后，最多允许查询 10 次。
超过查询次数限制的请求将被系统拦截，无法继续获取结果。

请求参数

参数	是否必填	类型	描述
appid	是	String	appid
time	是	Number	10位当前时间戳，间隔上下不低于120秒
sign	是	String	签名，规则参照签名规则
method	是	String	youquanyi.api.out.orderinfo
order_number	否	String	订单号,两个订单号至少传一个
cus_order_no	否	String	客户端订单号,两个订单号至少传一个
kami_style	否	String	卡密返回格式，不传按模式格式返回，传1将按照卡号，密码，备注格式返回卡密，参考下方返回示例

请求示例

{
    "method": "youquanyi.api.out.orderinfo",
    "appid": "xxxxxx",
    "time": "1699935886"
    "sign": "签名内容，请阅读签名方法",
    "order_number": "202309281613169896751688"
}

公共响应参数

参数	类型	描述
code	Number	返回码 0-成功 99-失败
msg	String	提示信息
data	String	业务返回数据

业务返回参数（data）

参数	类型	描述
order_number	String	订单号
cus_order_no	String	客户端订单号
good_id	Number	商品id
count	Number	购买数量
good_name	String	商品名称
good_type	Number	商品类型 1-卡券 2-订单 3-实物
price	Number	成交单价
status	Number	订单状态 2-未发货 3-发货中 4-已完成 6-退款
create_time	Number	创建时间。10位时间戳
charge_account	String	订单扩展信息，订单，实物商品时会返回。
cards	String	卡密内容。卡密商品返回。
address_info	String	收货地址（good_type为3时可能返回）
express_company	String	快递公司（good_type为3时可能返回）
express_num	String	快递单号（good_type为3时可能返回）
end_time	Number	订单完成时间，可能为空，10位时间戳

注意：当 status 为 5 时，表示订单处于异常状态，此时并非最终处理结果。订单将会被重新处理，并最终转为已完成或退款状态。

kami_style传1时，卡密返回格式（cards）

参数	类型	描述
card_no	String	卡号
card_pass	String	密码
card_remark	String	备注

直充订单返回示例

{
    "msg": "请求成功！",
    "code": 0,
    "data": {
        "order_number": "202309281613169896751688",
        "cus_order_no": "1111",
        "good_id": 123,
        "count": 1,
        "good_name": "测试产品-测试对接订单",
        "good_type": 2,
        "price": "2.00",
        "create_time": 1695888796,
				"end_time": 1713151488,
        "status": 2,
        "charge_account": [
            "18228114612",
            "444446666",
            "sdfa5f4asdf1"
        ]
    }
}

卡密默认模式返回示例

{
    "msg": "ok",
    "code": 0,
    "data": {
        "order_number": "202407031229451719580899",
        "cus_order_no": "3948163779094539527",
        "good_id": 122,
        "count": 1,
        "good_name": "测试产品测试对接卡密11",
        "good_type": 1,
        "price": "0.0210",
        "create_time": 1719980985,
        "status": 4,
        "end_time": 1719980985,
        "cards": [
            "BytNVSFxSn1m"
        ]
    }
}

卡密默认模式返回示例(kami_style为1时)

{
    "msg": "ok",
    "code": 0,
    "data": {
        "order_number": "202407031229451719580899",
        "cus_order_no": "3948163779094539527",
        "good_id": 122,
        "count": 1,
        "good_name": "测试产品测试对接卡密11",
        "good_type": 1,
        "price": "0.0210",
        "create_time": 1719980985,
        "status": 4,
        "end_time": 1719980985,
        "cards": [
            {
                "card_no": "",
                "card_pass": "BytNVSFxSn1m",
                "card_remark": ""
            }
        ]
    }
}

0 人点赞过