创建代客下单

描述

创建代客下单（预下单），返回全局唯一的 preOrderId，后续修改、查询、生成分享链接、支付成功推送等所有交互均基于该 preOrderId。

路径

/optimus/module/open/preOrder/savePreOrder

入参说明（JSON 格式）

入参整体结构

参数 参数名称 类型 是否必传 描述 示例
appid 应用id String Y 固定值 见测试参数
mallID 商城信息 Object Y 固定值 见测试参数
seller 用户信息 Object Y 固定值 见测试参数
source 来源 Byte Y 固定值 3
amount 金额信息 Object Y
checkout 结算信息 Object Y
scenes 商城场景信息 String Y 和创建的商城有关。示例是带有备注的商城，是 JSON 字符串格式，没有填 [] 见下方示例
requestId 请求号 String N 回调会通知；只做记录，不做幂等处理

入参字段结构

mallID 字段明细

参数 参数名称 类型 是否必传 描述 示例
mallSn 商城ID String Y 固定值 见测试参数
signature 商城签名 String Y 固定值 见测试参数

seller 字段明细

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

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 自定义商品标题 自定义商品
price 商品价格 Long N 自定义商品价格，单位：分 100
image 商品图片 String N 自定义商品图片地址

scenes 字段示例（带备注商城）

scenes 是 JSON 字符串，需要在服务端序列化后传入。原始结构：

[
    {
        "type": "textarea",
        "fieldName": "备注",
        "isFieldRequired": false,
        "tag": "common",
        "form": "basic",
        "label": "basic",
        "body": {
            "type": "textarea",
            "content": "备注文本",
            "isRequired": false,
            "readonly": true
        },
        "compType": "textarea"
    }
]

未配置采集字段的商城传 "[]" 即可。

出参说明（JSON 格式）

出参整体结构

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

出参字段结构

data 字段明细

参数 参数名称 类型 描述 示例
preOrderId 预订单号 String 预订单号，全局唯一，后续交互均使用该字段 ruf6iy2SGP1rakJDNToDA-4Q3mGWpafcIjP2CH/x64M=

示例

{
    "appid": "2025082700005615",
    "seller": {
        "merchantId": "2fb8469f-6d28-4bc8-8201-ff57dff86e3f",
        "merchantUserId": "6155adc6-68b5-4bad-b95b-2b44521171ea",
        "role": "super_admin"
    },
    "mallID": {
        "mallSn": "2025111310042834933",
        "signature": "xCLJhkXbL6o2WGPAkT6n"
    },
    "source": 3,
    "amount": {
        "oriAmount": 1
    },
    "checkout": {
        "type": 2
    },
    "scenes": "[]"
}

results matching ""

    No results matching ""