保利威文档中心

帮助中心

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=1
    • year -> validity=2
    • day -> 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": "参数错误"
  }
}
联系客服,在线咨询