📋 商品模板管理完整教程

🎯 商品模板模块总览

这个模块用于配置商品下单时所需的参数输入模板，通过标准化的输入项设计，确保用户下单时提供必要的信息（如充值账号、区服、角色名等），支持两种模板类型：

• 系统模板：全局通用的参数模板，适用于大多数商品。

• 商户模板：为特定合作商户定制的专属参数模板，满足个性化需求。

核心价值：统一管理商品的下单参数，提升用户体验与订单信息的准确性，避免因信息缺失导致的订单失败。

🔹 标签页 1：系统模板（全局通用）

首页功能

1. 新增模板：点击「+ 添加参数模板」进入配置页面，创建全局通用的参数模板。

2. 模板列表：展示所有系统模板的 ID、名称、输入项数量、权重、创建时间，支持按权重排序（权重值越小，模板优先级越高）。

添加配置步骤

一、基础信息设置

• 模板名称：必填项，设置唯一且清晰的名称（如「游戏点卡通用模板」「话费充值模板」），便于后续关联商品时识别。

• 核心规则：系统强制要求每个模板必须包含一个 “充值账号” 类型的输入项（可修改名称为 “QQ 号”“手机号” 等，但必须保留一个核心账号输入项）。

二、输入项配置（核心）

点击「添加输入项」，为模板添加一个或多个参数输入项，每个输入项的详细配置如下：

🔹 标签页 2：商户模板（专属定制）

• 功能定位：为特定合作商户创建专属的参数模板，满足个性化需求（如某商户要求用户提供 “身份证号” 作为额外验证信息）。

• 配置逻辑：与「系统模板」完全一致，仅适用范围不同（仅关联该商户的商品可见）。

• 核心优势：无需修改全局模板即可满足商户个性化需求，避免影响其他商品。

⚠️ 注意事项

1. 核心输入项强制要求：每个模板必须包含一个 “充值账号” 类型的输入项（可修改名称），否则无法保存配置。

2. 键名唯一规则：同一模板内的键名必须唯一，否则会导致 API 接口参数识别错误。

3. 输入类型适配性：根据实际场景选择输入类型，如敏感信息用「密码」，省市区选择用「联动组合」，提升用户体验。

4. 权重优先级规则：权重值越小，模板优先级越高（如核心商品的模板权重设为 0，普通商品设为 50）。

5. 商户模板隔离性：商户模板仅对关联的商户商品生效，不会影响全局商品的参数配置。

📋 商品模板输入项配置示例表

1. 以下是不同商品类型的完整输入项配置示例，你可以直接参考并套用，确保参数设置符合业务需求与系统规范。

   商品类型	模板名称	输入项序号	输入类型	参数名称	键名	提示文本	参数验证规则	选项（适用时）
   游戏点卡	游戏点卡通用模板	1	文本	充值账号	recharge_account	请输入您的游戏账号（6-16 位）	非空验证、长度 6-16 位	-
   		2	下拉	所在区服	game_server	请选择您的游戏区服	非空验证	电信区，联通区，移动区，双线区
   		3	文本	角色名称	role_name	请输入您的游戏角色名	非空验证	-
   手机话费	话费充值模板	1	文本	充值手机号	phone_number	请输入需要充值的手机号	非空验证、手机号格式验证	-
   		2	下拉	充值金额	recharge_amount	请选择充值金额	非空验证	10 元，20 元，50 元，100 元，200 元
   视频会员	视频会员充值模板	1	文本	会员账号	vip_account	请输入您的视频平台账号（手机号 / 邮箱）	非空验证、手机号 / 邮箱格式验证	-
   		2	下拉	会员类型	vip_type	请选择会员时长	非空验证	月度会员，季度会员，年度会员
   实物商品	实物商品下单模板	1	文本	收货人姓名	recipient_name	请输入收货人姓名	非空验证	-
   		2	文本	联系电话	contact_phone	请输入联系手机号	非空验证、手机号格式验证	-
   		3	联动组合	收货地址	province,city,area	请选择省 / 市 / 区	非空验证	-
   		4	文本	详细地址	detail_address	请输入详细街道地址	非空验证	-
   Q 币充值	Q 币专属模板	1	文本	QQ 号	qq_number	请输入需要充值的 QQ 号	非空验证、QQ 号格式验证（5-12 位数字）	-
   		2	下拉	充值数量	qcoin_amount	请选择 Q 币数量	非空验证	10 个，20 个，50 个，100 个，500 个

   ---

   💡 配置说明

   1. 核心输入项：每个模板的第 1 项均为核心 “充值账号” 类输入（如游戏账号、手机号、QQ 号），满足系统强制要求。

   2. 键名规范：键名采用英文小写 + 下划线格式（如 recharge_account），确保 API 接口可正确识别。

   3. 验证规则：根据输入项的实际场景配置验证（如手机号格式、账号长度），减少用户输入错误。

   4. 选项设置：下拉 / 单选类型的选项用英文逗号分隔（如 电信区,联通区），确保前端正确渲染。

商品模板为虚拟商品下单表单模板，强大的表单管理可以满足各种表单参数需求

表单参数类型支持：文本、密码、下拉框、单选框、多选框、联动组合、图片上传

文本和密码类型参数，支持选择参数验证规则

下拉框、单选框、多选框可选参数填写在选项列，多选项用,隔开

联动组合点击编辑，强大的数据生成器支持一键导入城市数据，可以自定义数据，还可以针对指定的选项添加联动参数

注意：联动组合如果为城市数据，键名必须填写：sheng,shi,qu 提示文本必须填写：省,市,区 否则无法正确传参

图片上传类型，支持一键设置常见图片格式，及限制上传图片大小

支持对参数的顺序进行拖拽排序

下单表单示例