鱼店长 + 阿奇索 自动直充对接完整教程

前期准备清单

• 可正常售卖的电商店铺账号，无处罚限制
• 阿奇索账号，并完成实名认证
• 上游货源账号，拿到API接口地址、商户ID、密钥
• 服务器/电脑挂机环境，保持鱼店长客户端常开在线

1. 订购鱼店长服务

1. 登录阿奇索商家后台
2. 打开【服务订购】页面，找到鱼店长自动发货套餐
3. 支付开通服务
4. 下载鱼店长客户端，用阿奇索账号登录
5. 确认客户端在线，服务状态显示【已开通】

【截图：阿奇索后台服务订购页面】

套餐列表、开通按钮截图

2. 店铺授权绑定

作用：让阿奇索有权限抓取你店铺的订单。

1. 阿奇索后台 → 授权管理
2. 点击【新增授权】，选择你的店铺类型
3. 按照页面提示扫码完成店铺授权
4. 授权成功，列表状态变为【已绑定】
5. 开启订单获取、消息通知权限

【截图：店铺授权管理页面】

店铺列表、新增授权按钮、扫码弹窗

3. 上游货源API绑定

作用：对接充值货源，订单来了可以自动发给上游充值。

1. 登录上游货源后台，复制API地址、商户ID、密钥
2. 阿奇索后台，货源管理 → 添加自定义接口
3. 粘贴接口地址、商户ID、密钥
4. 编码选UTF-8，核对签名算法（MD5/RSA，以上游文档为准）
5. 点击连通测试，提示成功后保存接口

【截图：货源接口添加页面】

接口地址、商户ID、密钥输入框、连通测试按钮

4. 配置上游回调地址

作用：上游充值完成后，推送结果给阿奇索，自动更新订单状态。

https://你的域名/api/callback

阿奇索官方回调地址示例：

https://aldsidle.agiso.com/api/callback

【截图：上游货源回调地址填写页面】

回调地址输入框，保存按钮

⚠️ 回调地址必须HTTPS，填完建议测试连通。

5. 普通商品：标识直充

适用：固定数量商品，拍1件就充固定数量，不需要倍数计算。

1. 阿奇索后台 → 商品管理 → 添加/编辑商品
2. 货源选择：前面添加好的上游接口
3. 开启【标识为直充】
4. 设置买家需要填写的信息（手机号/账号）
5. 保存商品配置

【截图：商品列表-标识直充操作】

商品列表、标识直充按钮、买家信息设置

6. 抖币/Q币倍数充值设置

适用：抖币、Q币，买家拍多件自动叠加充值数量。

1. 商品管理 → 添加/编辑抖币/Q币商品
2. 货源选择：上游直充接口，开启【标识为直充】
3. 开启【发送倍数】功能
4. 填写基础面值：1份对应的充值数量。例：1份=100抖币，填100
5. 公式：充值总数 = 购买件数 × 基础面值
6. 设置买家输入项：抖币填抖音ID，Q币填QQ号
7. 设置单次最大倍数，限制上限，防止上游报错
8. 保存配置

【截图：倍数充值参数配置页面】

倍数开关、基础面值、账号输入设置

7. 订单测试（必须做！）

1. 店铺下小额测试订单，付款
2. 查看API请求日志，核对传给上游的参数
3. 倍数商品重点核对：充值数量是否等于件数×基础面值
4. 确认上游成功受理订单，完成充值
5. 确认上游回调推送，阿奇索自动更新订单状态
6. 测试无问题，再正式售卖接单

【截图：订单测试日志页面】

请求日志、返回结果、回调记录

完整业务流程

1.买家店铺下单并付款
2.鱼店长+阿奇索自动抓取订单
3.系统校验订单信息
4.倍数商品自动计算充值数量：件数 × 基础面值
5.组装参数，向上游API提交充值请求
6.上游收到请求，开始充值
7.上游推送回调，通知阿奇索充值成功/失败
8.阿奇索自动更新订单状态，通知买家

常见问题排查

• 抓不到店铺订单：检查鱼店长是否在线、店铺授权是否正常、商品是否开启直充
• 接口连接失败：检查网络、防火墙、HTTPS域名是否正常
• 签名错误：核对参数排序、密钥、编码格式
• 倍数充值数量不对：确认倍数开关开启，基础面值填写正确，上游支持数量参数
• 收不到回调：上游后台回调地址填写错误，防火墙拦截
• 余额不足：上游账户余额不足，充值后重试

重要注意事项