创建订单
Path: /optimus/core/order/placeOrder
入参说明(JSON 格式)
入参整体结构
| 字段 | 类型 | 描述 |
|---|---|---|
| appid | String | 应用ID |
| seller | Object | 商户信息 |
| mallID | Object | 商城ID |
| buyer | Object | 买家信息 |
| checkoutItemsId | String | 结算明细ID |
| scenes | Array | 场景信息 |
入参字段结构
mallID 字段明细:
| 字段 | 类型 | 描述 |
|---|---|---|
| mallSn | String | 商城编号 |
| signature | String | 商城签名 |
seller 字段明细:
| 字段 | 类型 | 描述 |
|---|---|---|
| merchantId | String | 商户ID |
| merchantUserId | String | 商户用户ID |
| role | String | 角色 |
buyer 字段明细:
| 字段 | 类型 | 描述 |
|---|---|---|
| buyerId | String | 买家ID |
scenes 字段明细:
[
{
"type": "textarea",
"fieldName": "备注",
"isFieldRequired": false,
"tag": "common",
"form": "basic",
"label": "basic",
"body": {
"type": "textarea",
"content": "备注文本",
"isRequired": false,
"readonly": true
},
"compType": "textarea"
}
]
出参说明(JSON 格式)
出参整体结构
| 字段 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 是否成功 |
| code | String | 返回码 |
| msg | String | 返回消息 |
| data | Object | 数据 |
出参字段结构
data 字段明细:
| 字段 | 类型 | 描述 |
|---|---|---|
| orderSn | String | 订单号 |
| signature | String | 订单签名 |
| acquiring | Object | 收单信息 |
acquiring 字段明细:
| 字段 | 类型 | 描述 |
|---|---|---|
| payUrl | String | 支付URL |
| orderId | String | 订单ID |
| acquiringId | String | 收单ID |
注意:如果 acquiring 不存在,说明创建收单失败,无法发起支付。
可能原因:终端被禁用、收款权限关闭等,需要排查。
示例
{
"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": "53c8cb52-4ad3-11ed-952b-7cd30a5a1e6c"
},
"checkoutItemsId": "BXUo2Dzlm399p6PGgwc3TACRf2xoQWMvZ9qWetDqudg=",
"requestId": "DWTY90126131909560"
}