平台对接插件使用教程
魔方财务对接插件教程
1. 安装插件
将插件压缩包解压到 public/plugins/servers/ 目录下。
确保解压后的文件夹名称与插件名称一致，且目录结构正确。
2. 添加接口
登录魔方财务后台，依次进入 设置 → 商品设置 → 通用接口，点击 创建接口。
在编辑接口页面，按以下说明填写：
- 名称：任意填写，便于识别即可。
- IP 地址：填写平台域名。
- 服务器模块：选择 云尚 API 分销模块（若未找到，请检查插件是否安装成功）。
- 接口容量：根据您的业务需求填写（如 1000）。
- 用户名是应用ID，密码是应用密钥（全局应用）。
3. 添加商品
商品分组：您可以选择已有分组，也可以新建一个分组（如“API 产品”）。
基本信息：填写商品名称、描述等信息。注意：“主机名”和“密码”选项请不要开启（保持关闭），其余字段可根据需要自由调整。
定价：选择“一次性”计费模式，并将价格设置为 0（此处仅为占位，实际价格由可配置项决定）。
自动开通：
- 开通方式：选择 自动化接口。
- 接口分组：选择您在 第 2 步 创建的接口分组。
- API 代码：填写您平台 API 的英文调用代码（可从本平台的开发文档中获取）。
- 默认次数：可填写 0，或按需设置默认次数。
- 默认有效期：建议填写 12（表示 12 个月，可根据实际调整）。
4. 配置可配置项（即商品规格）
在商品编辑页面，找到 可配置项 区域，点击 添加配置项。
配置项设置：
- 配置选项名称：必须填写为 “次数”（用于标识 API 调用次数）。
- 配置项类型：选择 单选。
- 子项名称：填写您希望提供的次数档位，例如 100、200、500 等（仅填数字）。
价格设置：在对应子项右侧的“一次性价格”栏中，设置该档位的售价。
> 示例：若子项名称为 100，一次性价格设为 4，则表示用户支付 4 元可购买 100 次 API 调用。
5. 前台效果
完成以上配置后，用户在前台商品详情页将看到类似下图的选择界面，可根据需要选择不同的次数档位并下单。
