chirou.ai 网站对接教程

本教程适用于把本站商品通过 API 对接到你自己的发卡网站。对接完成后，你网站的用户下单时，系统会自动到本站下单并返回卡密/账号资料，实现自动发货。

本站对接地址：

https://chirou.ai/

商户后台添加店铺时优先填写上面的根地址，不要填写到某个具体接口。本站已同时兼容两类接口：

新版标准接口：https://chirou.ai/shared/...
旧版 SharedStock 接口：https://chirou.ai/plugin/SharedStock/api/...

如果你的发卡系统有“店铺共享 / 远程商品 / SharedStock / 类型2店铺”等选项，选择这一类对接方式即可。

对接时请优先使用不带 www 的地址 https://chirou.ai/。如果填写 https://www.chirou.ai/ 后无法连接，通常是当地 DNS 尚未正确解析 www，先改回主域名即可。

对接前准备

开始之前，请确认你自己的网站支持“店铺共享 / 商品对接 / 远程商品”功能。常见的异次元发卡或同类发卡系统，一般都支持这种对接方式。

对接需要满足以下条件：

• 你已在本站注册账号。
• 你可以在本站个人中心获取商户 ID 和商户密钥。
• 你要对接的商品已开放 API 对接权限。
• 你的网站后台可以添加远程店铺并拉取商品。
• 你的本站账号需要有余额，否则用户下单后无法自动向本站采购。

一、注册本站账号

1. 打开本站：

https://chirou.ai/

1. 点击页面上的“登录 / 注册”入口。
2. 按页面提示完成注册。
3. 登录后进入“个人中心”或“用户中心”。

二、获取商户 ID 和商户密钥

进入个人中心后，找到与 API 对接相关的信息：

• 商户 ID
• 商户密钥

请把这两个信息保存好，后面添加远程店铺时需要填写。

注意：商户密钥等同于接口凭证，不要发给无关人员，也不要公开截图。

三、在你的网站后台添加对接店铺

回到你自己的发卡网站后台，按以下路径操作：

后台 → 店铺共享 / 商品对接 → 新增店铺

新增店铺时填写：

店铺地址：https://chirou.ai/
商户 ID：填写你在本站个人中心获取的商户 ID
商户密钥：填写你在本站个人中心获取的商户密钥

注意：店铺地址填写根地址 https://chirou.ai/，不要填写 www，也不要填写到 /shared/ 或 /plugin/SharedStock/api/。部分旧版程序会自动拼接 /plugin/SharedStock/api/...，部分新版程序会自动拼接 /shared/...，本站两种路径都支持。

填写完成后点击“确认”或“保存”。

保存成功后，系统通常会显示本站店铺信息，例如店铺名称、站点地址、余额等。这里的余额很重要，余额不足时，用户在你的网站下单可能无法自动发货。

四、拉取本站商品

添加店铺成功后，点击“拉取商品 / 商品同步 / 插头图标”等按钮，进入远程商品导入页面。

导入商品时建议这样设置：

• 本地分类：选择你要把商品放到哪个分类。
• 同步价格：建议开启，避免本站价格变化后你的网站亏损。
• 同步库存：建议开启，避免用户下单后远程无货。
• 加价模式：按你的利润需求选择固定金额加价或百分比加价。

加价示例：

• 固定加价：本站商品 10 元，你设置加价 2 元，你网站售价为 12 元。
• 百分比加价：本站商品 100 元，你设置 20%，你网站售价为 120 元。

选择需要对接的远程商品后，点击确认导入。导入成功后，可以在你的商品列表中看到这些商品。

注意：导入后可以修改商品介绍、排序、分类、限购等展示信息，但不要随意修改商品共享代码或远程对接参数，否则可能导致自动发货失败。

五、给本站账号充值

完成商品导入后，你还需要给本站账号充值余额。对接下单的流程是：

用户在你的网站下单
→ 你的系统自动到 chirou.ai 下单
→ chirou.ai 自动发货
→ 你的系统把商品信息返回给用户

所以你的本站账号必须有足够余额，系统才能自动代下单。

本站当前支持 USDT 充值方式：

• USDT-Polygon
• USDT-BSC
• USDT-TRC20

充值时请注意：

• 必须选择正确网络。
• 必须转入页面显示的准确金额。
• 转账完成后系统会自动检测链上到账。
• 如果自动检测较慢，可以点击“手动检查订单状态”。

六、下单测试

充值完成后，回到你自己的网站，找一个刚刚对接的商品进行测试下单。

测试时重点检查：

• 用户下单后是否自动扣除你在本站的余额。
• 本站是否成功生成订单。
• 卡密或账号资料是否能自动返回到你的网站。
• 用户订单状态是否自动变为已支付/已发货。
• 商品库存是否同步正常。

如果测试订单可以正常发货，说明对接成功。

常见问题

1. 拉取不到商品

可能原因：

• 店铺地址填写错误，必须填写 https://chirou.ai/。
• 填成了 https://www.chirou.ai/，部分网络下 www 解析不稳定，先改成 https://chirou.ai/。
• 商户 ID 或商户密钥填写错误。
• 商品没有开放 API 对接。
• 你的网站程序不支持该对接方式。
• 你的程序强制要求旧版 SharedStock 插件地址时，也可以使用本站，接口已兼容 /plugin/SharedStock/api/connect、/plugin/SharedStock/api/items、/plugin/SharedStock/api/item、/plugin/SharedStock/api/stock、/plugin/SharedStock/api/valuation、/plugin/SharedStock/api/inventory 等路径。

快速判断：

未填写商户信息时，接口返回“商户ID不存在”是正常的，说明接口通了。
填写商户信息后，连接测试应返回 success，并能拉取商品分类和商品列表。

2. 商品能拉取，但用户下单不发货

可能原因：

• 你在本站的账号余额不足。
• 远程商品库存不足。
• 商品共享代码被修改。
• 你的网站后台没有开启自动发货。

3. 价格或库存不同步

建议在导入商品时勾选同步价格和同步库存。若已经导入，可在后台重新同步远程商品。

4. USDT 充值后没有自动到账

请先确认：

• 网络是否选对，例如 Polygon 不能转到 TRC20。
• 金额是否和页面显示完全一致。
• 是否已经等待链上确认。
• 是否点击过“手动检查订单状态”。

如果仍未到账，请提供订单号和链上交易哈希，方便人工核对。

对接信息汇总

对接站点：chirou.ai
店铺地址：https://chirou.ai/
新版接口前缀：https://chirou.ai/shared/
旧版兼容接口前缀：https://chirou.ai/plugin/SharedStock/api/
获取凭证位置：本站个人中心
需要信息：商户 ID、商户密钥
充值方式：USDT-Polygon、USDT-BSC、USDT-TRC20

完成以上步骤后，你的网站就可以自动调用本站商品，并实现用户下单后的自动发货。