创建结算明细
描述
创建订单前置步骤。
路径
/optimus/core/order/createCheckoutItems
入参说明(JSON 格式)
入参整体结构
| 参数 | 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|---|
| appid | 应用id | String | Y | 固定值 | 见测试参数 |
| mallID | 商城信息 | Object | Y | 固定值 | 见测试参数 |
| seller | 商户信息 | Object | Y | 固定值 | 见测试参数 |
| buyer | 买家信息 | Object | Y | 固定值 | 见测试参数 |
| checkoutItems | 结算项列表 | List\ | N | 三者只存在其一 | 商品/自定义商品 |
| amount | 结算金额 | Long | N | 纯金额 | |
| mallBillIds | 账单号 | List\ |
N | 账单号 |
入参字段结构
mallID 字段明细
| 参数 | 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|---|
| mallSn | 商城id | String | Y | 固定值 | 见测试参数 |
| signature | 商城密码 | String | Y | 固定值 | 见测试参数 |
seller 字段明细
| 参数 | 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|---|
| merchantId | 商户Id | String | Y | 固定值 | 见测试参数 |
| merchantUserId | 商户userId | String | Y | 固定值 | 见测试参数 |
| role | 角色 | String | Y | 固定值 | 见测试参数 |
buyer 字段明细
| 参数 | 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|---|
| buyerId | 买家id | String | Y | 固定值 | 见测试参数 merchantUserId |
checkoutItems 字段明细
商品会自动根据数量 × 价格算出需要支付的总金额。
| 参数 | 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|---|
| spuId | spuId | String | Y | 自定义商品随便传 正常商品需要使用收钱吧的spuId | 213132 |
| skuId | skuId | String | Y | 同上 | 213132 |
| price | 单价分为单位 | Long | N | type1的时候必填 | |
| quantity | 购买数量 | String | N | type1的时候必填 | |
| type | 商品类型 | Byte | N | 0 正常商品 1 自定义商品 | |
| title | 商品标题 | String | N | type1的时候必填 | |
| image | 图片地址 | String | N | type1的时候必填 |
出参说明(JSON 格式)
出参整体结构
| 参数 | 参数名称 | 类型 | 描述 | 示例 |
|---|---|---|---|---|
| success | 请求状态 | Boolean | true:成功;false:失败 | TRUE |
| code | 状态码 | String | 0000:成功;其他为异常码 | "0000" |
| msg | 状态描述 | String | 请求结果的描述信息 | "处理成功" |
| data | 订单数据 | Object | 结果数据 |
出参字段结构
data 字段明细
| 参数 | 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|---|
| checkoutItemsId | 结算项id | String | Y |
示例
{
"appid": "2025082700005615",
"seller": {
"merchantId": "fd567f94-9a44-4ae5-879f-9acc919d0f89",
"merchantUserId": "42c556cc-1509-4de0-bfc3-dfbcb48eae57",
"role": "super_admin"
},
"mallID": {
"mallSn": "2026032016163406527",
"signature": "qCbBQ9l99yCXdpuao945"
},
"buyer": {
"buyerId": "fd567f94-9a44-4ae5-879f-9acc919d0f89"
},
"checkoutItems": [
{
"image": "https://images.wosaimg.com/bb/026955bfac02f24828a729ca355a936b24c9c0.png",
"price": 1,
"spuId": "1",
"quantity": "1",
"type": "1",
"title": "测试商品",
"skuId": "1"
}
]
}