查询订单详情

POST  /merchant/orderQueryDetail

根据查询条件查询订单详情，使用商户 API 密钥签名认证。支持按订单 ID（id）、订单号（order_no）或商户单号（merchant_order_no）三选一查询，优先级从高到低。

merchant_order_no 非唯一

merchant_order_no 不强制唯一，若同一商户下存在多条相同商户单号，将返回第一条匹配的订单。需要精确查询请使用 order_no。

请求参数

参数名	类型	必填	说明
id	int	三选一	订单 ID
order_no	string	三选一	订单编号
merchant_order_no	string	三选一	商户单号（不强制唯一，命中多条时返回首条）

通用认证参数

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

请求示例

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

{
    "api_key": "your_api_key",
    "timestamp": 1699065600,
    "nonce": "abc123def456",
    "signature": "generated_signature_here",
    "order_no": "ORD20260130123456789"
}

请求示例（按商户单号查询）

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

{
    "api_key": "your_api_key",
    "timestamp": 1699065600,
    "nonce": "abc123def456",
    "signature": "generated_signature_here",
    "merchant_order_no": "M20260814001"
}

响应参数

参数名	类型	说明
order_no	string	订单编号
merchant_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": {
        "order_no": "ORD20260130123456789",
        "merchant_order_no": "M20260814001",
        "order_type": 1,
        "cny_amount": "1000.00",
        "merchant_actual_amount": 970,
        "service_rate": "0.03000000",
        "service_amount": 30,
        "status": "completed",
        "createtime": 1737715200,
        "updatetime": 1737715800
    }
}