本站 网站对接教程

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

本站对接地址：

https://web3aishop.com

商户后台添加店铺时填写上面的根地址，不要填写到某个具体接口。本站的对接接口尚未开放，现在填写任何接口地址都无法连接。

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

对接时请直接填写上面的地址 https://web3aishop.com，不要自行加上 www。如果加了 www 后无法连接，通常是当地 DNS 尚未正确解析 www，改回上面的地址即可。

对接前准备

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

对接需要满足以下条件：

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

一、注册本站账号

1. 打开本站：

https://web3aishop.com

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

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

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

• 商户 ID
• 商户密钥

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

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

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

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

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

新增店铺时填写：

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

注意：店铺地址填写根地址 https://web3aishop.com，不要加上 www，也不要自己在后面拼接接口路径。本站对接接口尚未开放，现在保存店铺或测试连接都会失败。

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

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

四、拉取本站商品

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

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

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

加价示例：

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

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

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

五、给本站账号充值

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

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

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

充值方式以本站「充值优惠」页面实际显示为准（USDT 目前只支持 BEP20（BSC）和 TRC20 两条网络，不支持 Polygon）。

充值时请注意：

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

六、下单测试

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

测试时重点检查：

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

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

常见问题

1. 拉取不到商品

可能原因：

• 店铺地址填写错误，必须填写 https://web3aishop.com。
• 自行加上了 www，部分网络下 www 解析不稳定，先改成 https://web3aishop.com。
• 商户 ID 或商户密钥填写错误。
• 商品没有开放 API 对接。
• 你的网站程序不支持该对接方式。
• 本站对接接口尚未开放。开放之前，无论店铺地址和商户信息是否填对，都无法拉取商品。

快速判断：

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

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

可能原因：

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

3. 价格或库存不同步

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

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

请先确认：

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

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

对接信息汇总

对接站点：本站
店铺地址：https://web3aishop.com
对接接口：尚未开放
获取凭证位置：本站个人中心
需要信息：商户 ID、商户密钥
充值方式：以充值页面实际显示为准

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