查询订单列表

POST  /merchant/orderQueryList

使用商户 API 密钥查询订单列表，无需登录即可访问。支持按状态、类型、时间范围等条件筛选订单。

INFO

本接口使用 API 密钥签名认证，与需要登录的 orderList 接口不同。适用于第三方系统集成场景。

请求参数

参数名	类型	必填	说明
page	int	否	页码，默认 1
limit	int	否	每页数量，默认 20
status	string	否	订单状态筛选（pending/paid/confirmed/completed/cancelled）
order_type	int	否	订单类型筛选：1=买入，2=卖出
start_time	int	否	开始时间戳
end_time	int	否	结束时间戳

通用认证参数

另需携带 api_key、timestamp、nonce、signature，详见 通用参数。

请求示例

POST https://api.alllandpay.cn/addons/huanyu/merchant/orderQueryList
Content-Type: application/json

{
    "api_key": "your_api_key",
    "timestamp": 1699065600,
    "nonce": "abc123def456",
    "signature": "generated_signature_here",
    "page": 1,
    "limit": 20,
    "status": "completed",
    "order_type": 1,
    "start_time": 1699065600,
    "end_time": 1699152000
}

响应参数

参数名	类型	说明
list	array	订单列表
total	int	总记录数
page	int	当前页码
limit	int	每页数量

list 对象字段

参数名	类型	说明
order_no	string	订单编号
order_type	int	订单类型（1=买入，2=卖出）
cny_amount	string	付款金额（人民币）
merchant_actual_amount	int	商户实际金额
service_rate	string	服务费率
service_amount	int	服务费
status	string	订单状态
createtime	int	创建时间戳
updatetime	int	更新时间戳

响应示例

{
    "code": 1,
    "msg": "获取成功",
    "data": {
        "list": [
            {
                "order_no": "ORD20260130123456789",
                "order_type": 1,
                "cny_amount": "1000.00",
                "merchant_actual_amount": 970,
                "service_rate": "0.03000000",
                "service_amount": 30,
                "status": "completed",
                "createtime": 1737715200,
                "updatetime": 1737715800
            }
        ],
        "total": 1,
        "page": 1,
        "limit": 20
    }
}