域名商品配置教程(资源池到下单)

帮助 · 2026-11-21 20:00:38

适用版本:云掌柜 2.1.0

本教程从资源池接口开始,完整的顺序是:创建资源池 → 创建商品分组 → 新增域名商品 → 绑定域名后缀 → 设置价格 → 前台搜索与下单。

一、创建资源池(上游接口)

1. 登录云掌柜后台,进入「资源池列表」→「资源接口」。

2. 点击「新增资源池」。

3. 按下图填写:

  • 名称:例如「域名 / 3号线-国内接口」
  • 分组:选择或新建「域名」
  • 交付模块:选择「西部数码域名(westcn)」
  • 主机地址:https://api.west.cn/api/v2
  • 用户名:西部数码 API 用户名
  • 密码 / 密钥:西部数码 API 密码
  • 状态:正常

4. 保存后回到资源池列表,点「测试连接」,确认余额和接口正常。

新增资源池

二、创建商品分组

1. 进入「商品管理」→「商品分组」。

2. 先建一级分组「域名注册」,scope 必须选择「域名」。

3. 再建二级分组「国内域名」和「国际域名」。

4. 只有 scope 为 domain 的分组,才会出现在前台「注册域名」页面。

5. 分组状态要设为「显示」。

三、新增域名商品

1. 进入「商品管理」→「域名业务」→「新增商品」。

2. 基础信息填写:

  • 商品分组:国内域名
  • 商品名称:例如「.hk 域名注册」
  • 商品编码:内部唯一编码,可随意填写,不参与后缀判断
  • 商品类型:域名
  • 计费单位:年

3. 打开「接口管理」,选择交付模块「西部数码域名(westcn)」和刚创建的资源池。

4. 在「域名后缀」填写该商品绑定的后缀,例如 hk、com、cn、com.cn;只能填一个,不要带点。

5. 保存商品设置。

绑定域名后缀

四、设置价格

1. 打开「价格」标签。

2. 点「添加周期」,选择「年」。

3. 填写售价、续费价和开通费。

4. 点「保存价格」。

5. 每个后缀单独建商品,不要在一个商品里填多个后缀。

设置域名价格

五、前台展示、搜索和下单

1. 商品分组显示后,前台「注册域名」页面会出现对应后缀卡片。

2. 商品卡片可以整块点击进入下单,不再只是展示。

3. 搜索完整域名时,系统按后缀匹配对应商品。

4. 同一后缀有多个线路时,搜索结果会列出线路和价格供客户选择。

5. 下单页只允许查询当前商品绑定的后缀;例如 .hk 商品输入 .com,会提示重新选择 .com 商品。

前台域名注册

六、常见问题

1. 首页没有显示分组:检查分组 scope 是否为 domain、状态是否为显示、商品是否上架。

2. 搜索提示暂不支持该后缀:没有对应后缀的域名商品,先新增商品并绑定后缀。

3. 下单提示后缀不匹配:当前商品后缀与输入域名后缀不一致,返回选择对应商品。

4. 修改商品编码不会影响后缀;后缀只看「域名后缀」字段。

5. 修改配置后建议清理缓存并强制刷新前台页面。