查询代客下单

描述

根据 preOrderId 查询代客下单当前状态、金额、结算信息、过期时间等。

路径

/optimus/module/open/preOrder/queryPreOrder

入参说明（JSON 格式）

入参整体结构

参数 参数名称 类型 是否必传 描述 示例
appid 应用id String Y 固定值 见测试参数
seller 用户信息 Object Y 固定值 见测试参数
preOrderId 预下单id String Y 创建代客下单 时返回

入参字段结构

seller 字段明细

参数 参数名称 类型 是否必传 描述 示例
merchantId 商户Id String Y 固定值 见测试参数
merchantUserId 商户userId String Y 固定值 见测试参数
role 角色 String Y 固定值 见测试参数

出参说明（JSON 格式）

出参整体结构

参数 参数名称 类型 描述 示例
success 请求状态 Boolean true：成功；false：失败 TRUE
code 状态码 String 0000：成功；其他为异常码 "0000"
msg 状态描述 String 请求结果的描述信息 "处理成功"
data 订单数据 Object 结果数据

出参字段结构

data 字段明细

参数 参数名称 类型 是否必传 描述 示例
preOrderId 预订单id String Y
orderSn 订单编号 String Y
state 状态 String Y 0 待支付；1 已完成；2 已取消
stateDesc 状态描述 String Y
amount 金额 Object Y
checkout 结算信息 Object Y
time 时间信息 Object Y
seller 卖家信息 Object N
scenes 场景信息 Object N

amount 字段明细

参数 参数名称 类型 是否必传 描述 示例
oriAmount 原金额 Long Y 10
discAmount 实际金额 Long N 5

checkout 字段明细

参数 参数名称 类型 是否必传 描述 示例
type 结算类型 Byte Y 1 商品；2 金额
items 结算商品信息 List\ N

checkout.items 字段明细

参数 参数名称 类型 是否必传 描述 示例
spuId 商品spu String Y
skuId 商品sku String Y
unit 商品单位 String N 件
quantity 商品数量 String Y
type 商品类型 Byte N 自定义商品类型为：1 1
title 商品名称 String N 自定义商品标题 自定义商品
curPrice 商品价格 Long N 自定义商品价格，单位：分 100
img 商品图片 String N 自定义商品图片地址

time 字段明细

参数 参数名称 类型 是否必传 描述 示例
createdAt 创建时间 String Y
deletedAt 删除时间 String N
paymentAt 支付时间 String N
expireAt 分享链接过期时间 String N

示例

{
    "appid": "2025082700005615",
    "seller": {
        "merchantId": "2fb8469f-6d28-4bc8-8201-ff57dff86e3f",
        "merchantUserId": "6155adc6-68b5-4bad-b95b-2b44521171ea",
        "role": "super_admin"
    },
    "preOrderId": "m9DiFixXKOnIFOcMxR846a-UyxzGdBBpRNtYWRc5Crs="
}

results matching ""

    No results matching ""