查询订单列表

此接口用于查询商户的订单列表，可用于对账或同步订单状态等操作。支持分页查询和订单状态过滤。

请求信息

请求URL /api/merchant/orders
请求方式 POST

请求参数

参数名 类型 必填 示例值 说明
pid Int 是 1001 商户ID
offset Int 是 0 查询偏移量，从0开始
limit Int 是 50 每页条数，最大不能超过50
status Int 否 1 过滤订单状态，0：未支付，1：已支付
timestamp String 是 1721206072 当前时间戳，10位整数，单位秒
sign String 是 签名字符串，详见签名规则
sign_type String 是 RSA 签名类型，默认为RSA

返回参数

参数名 类型 示例值 说明
code Int 0 返回状态码，0为成功，其它值为失败
msg String 返回信息，失败或成功时返回提示
data Array 订单列表数组，具体参数可参考订单查询
timestamp String 1721206072 当前时间戳，10位整数，单位秒
sign String 签名字符串，详见签名规则
sign_type String RSA 签名类型，默认为RSA

返回示例

成功示例：

{
    "code": 0,
    "msg": "查询成功",
    "data": [
        {
            "trade_no": "20160806151343349",
            "out_trade_no": "20160806151343351",
            "api_trade_no": "40001249985198893",
            "type": "alipay",
            "status": 1,
            "pid": 1001,
            "addtime": "2024-07-01 16:47:32",
            "endtime": "2024-07-01 16:49:24",
            "name": "商品名称",
            "money": "1.00",
            "param": "{\"id\":\"123\"}",
            "buyer": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
        },
        {
            "trade_no": "20160806151343350",
            "out_trade_no": "20160806151343352",
            "api_trade_no": "40001249985198894",
            "type": "wxpay",
            "status": 1,
            "pid": 1001,
            "addtime": "2024-07-01 16:50:12",
            "endtime": "2024-07-01 16:51:03",
            "name": "商品名称2",
            "money": "2.00",
            "param": "{\"id\":\"124\"}",
            "buyer": "oUpF8uMuAJO_M2pxb1Q9zNjWeS7p"
        }
    ],
    "timestamp": "1721206072",
    "sign": "xxxxx",
    "sign_type": "RSA"
}

失败示例：

{
    "code": -1,
    "msg": "商户不存在"
}

其他说明

注意事项