如何授权 Etsy 店铺

开始前准备

• Etsy 卖家账号：店铺已在 Etsy 正常开店，并且可以登录。
• Etsy 开发者后台权限：能打开 https://www.etsy.com/developers/your-apps；未登录时会先跳转登录。
• 旺销王账号：使用要绑定该店铺的旺销王账号登录。
• 稳定的网络环境：Etsy 对账号关联较敏感，建议在店铺日常登录的网络与浏览器环境中完成授权。

在旺销王发起 Etsy 授权

1. 登录旺销王，进入 系统 → 店铺授权。
2. 在平台列表中选择 Etsy。
3. 点击 添加授权，打开 Etsy 授权弹窗。

弹窗中需要填写三项信息：

• 账号别名：用于在旺销王内识别这家店铺的别名，卖家可自定义填写，不要求和 Etsy 店铺名完全一致。
• Keystring：Etsy 应用的 Keystring，在下一节创建应用后获取。
• Shared Secret：Etsy 应用的 Shared Secret，与 Keystring 一起获取。

创建 Etsy 个人应用，获取 Keystring 与 Shared Secret

如果已经有可用的 Etsy 应用，可以直接跳到第 4 节；第一次授权时按下面的步骤创建。

3.1 进入 Etsy 开发者后台

打开 https://www.etsy.com/developers/your-apps，使用要授权店铺对应的 Etsy 账号登录。

3.2 创建个人应用

选择 Create a personal app，点击 Get started 创建个人应用。若页面提示未登录，请先完成登录再创建。

3.3 填写应用信息

按页面要求填写以下内容，然后点击 Create App：

• Name：应用名称，可自定义，例如 ETSYAPP。
• Describe your application：描述应用用途，说明程序的功能和实用价值。可参考：I plan to use this application to manage my own Etsy shop. It will help me create, edit, publish, and deactivate listings, as well as view and process orders in one place. For now, I plan to use the application for my own day-to-day shop operations.
• Website URL：填写 https://www.wxwerp.com/。
• APP Details：按页面提示补充应用详情。

3.4 等待审核通过并复制密钥

应用创建完成后，状态（Status）会先显示为审核中；当状态变为 Personal Access，说明应用已审核通过。此时在应用详情中复制 Keystring 和 Shared Secret，回到旺销王的授权弹窗填入。

填写授权信息并开始授权

1. 回到旺销王的 Etsy 授权弹窗，填写 账号别名。
2. 把第 3 节获取的 Keystring、Shared Secret 分别填入对应输入框。
3. 选择授权方式：
   • 直接点击「开始授权」：当前浏览器会打开新页面跳转到 Etsy 登录授权，适合店铺就在当前浏览器登录的情况。
   • 点击「复制链接」：把授权链接复制到店铺实际登录的浏览器（例如指纹浏览器、隔离 IP 的浏览器）中打开，适合店铺在其他环境登录的情况，可以降低账号关联风险。
4. 在 Etsy 页面登录店铺账号，按提示同意应用授权。
5. 授权完成后回到旺销王，点击 确定 保存授权结果。

确认授权结果

1. 授权成功后，点击弹窗中的 确定 完成保存。
2. 回到店铺授权列表，确认 Etsy 店铺已出现在列表中，且店铺状态正常。
3. 进入订单、商品等模块，确认可以正常读取该 Etsy 店铺的数据。

常见问题

• 提示「请填写 Etsy 应用的 Keystring / Shared Secret」：两个输入框都不能为空，请确认复制的是应用详情中的 Keystring 和 Shared Secret，注意不要带多余空格。
• 应用一直处于审核中：需要等 Etsy 审核通过、状态变为 Personal Access 后再授权，未通过前无法完成授权。
• 授权过期或失效：在旺销王重新发起 Etsy 授权，按第 4 节重新走一次授权流程即可，Keystring 与 Shared Secret 可以继续使用原应用。
• 新增其他 Etsy 店铺：Keystring 与 Shared Secret 属于应用级信息，可以沿用；每家店铺需要单独完成一次授权，并使用不同的账号别名加以区分。