console-center-aggregate 接口文档
更新时间:2026-05-21 18:37:38
商城套餐版本下单
接口地址
POST /v3/console/mall-package-version/create-order
接口说明
根据商城套餐版本 ID 创建订单。
当前接口由 console-center-aggregate 提供,内部先调用 MallApiClient#getVersionDetail 获取版本详情,再按商城版本信息转换为续费下单模型 SubmitRenewalOrderReq,最终复用支付侧 /api/payment/submit_renewal_order 创建订单。
当前实现按新购处理,订单类型固定为 0。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
id |
Integer |
是 | 商城套餐版本 ID |
请求示例
{
"id": 1001
}
版本详情转换规则
| 来源字段 | 目标字段 | 说明 |
|---|---|---|
id |
productId |
订单产品 ID,转字符串 |
name |
productName / packageName |
订单名称、套餐名称 |
crm_product_id |
productInfo.productCode |
CRM 商品编码 |
description |
productInfo.packageDesc |
套餐描述 |
unit_price |
productAmount / productInfo.amount |
金额按元解析,productAmount 转成分 |
price_cycle + price_cycle_value |
startDate / endDate / validity / validityUnit |
开始时间取当前日期,结束时间按周期计算 |
resource_quotas.type = main_package |
billingPlanCode / quantity / billingUnit |
主套餐资源信息 |
resource_quotas.type = function |
functionList |
转为 clearing 可识别的功能列表 |
说明:
startDate取当前日期,格式yyyy-MM-dd。endDate为开始日期加上对应周期后减 1 天。price_cycle映射规则:month->validity=1year->validity=2day->validity=3
price_cycle_value直接作为validityUnit。resource_quotas中若不存在function项,则回退使用feature_switches构造functionList。- 主体信息会结合当前账号的套餐状态、最近销售机会进行推导,默认主体兜底为广州。
请求示例
POST /v3/console/mall-package-version/create-order
Content-Type: application/json
{
"id": 1001
}
返回结构
返回类型:ResponseVO<PackageRenewalOrderVO>
ResponseVO 字段
| 字段名 | 类型 | 说明 |
|---|---|---|
code |
Integer |
状态码,成功一般为 200 |
status |
String |
success / error |
requestId |
String |
请求 ID |
error |
Object |
失败信息 |
data |
PackageRenewalOrderVO |
订单数据 |
PackageRenewalOrderVO 字段
| 字段名 | 类型 | 说明 |
|---|---|---|
orderId |
String |
订单 ID |
tradeNo |
String |
交易流水号 |
status |
Integer |
订单状态 |
amount |
Integer |
订单金额,单位分 |
成功返回示例
{
"code": 200,
"status": "success",
"data": {
"orderId": "202605211830000001",
"tradeNo": "T202605211830000001",
"status": 11,
"amount": 1200000
}
}
失败返回示例
{
"code": 400,
"status": "error",
"error": {
"code": 400,
"desc": "参数错误"
}
}
