After you connect Amazon, StoreClaw can read orders, inventory, products, reviews, and related data within the authorized scope for business analysis, reports, and automation tasks. This guide explains how to complete the Amazon SP-API app setup and obtain the four credentials required to connect Amazon to StoreClaw.

Process Overview

Connecting an Amazon store usually starts with the following 3 core stages:

  1. Prepare your account and required information
  2. Complete developer profile registration or review
  3. Create the app and collect the 4 required credentials

After completing the process, you will need to enter the following 4 values into StoreClaw:

  1. Seller ID
  2. LWA Client ID
  3. LWA Client Secret
  4. Refresh Token

Tip: The slowest part of this process is usually Amazon's review of the developer profile. It is best to start that step as early as possible and use the waiting time to review the rest of the setup.

Before You Start

Before you begin, make sure the following conditions are met:

  • You are using an Amazon Professional Seller Account.
  • You are signed in with the primary account, or the primary account has granted you app development permissions.
  • You have identified the region you want to connect, such as North America (NA), Europe (EU), or Far East (FE).

Note: One set of credentials can access only the regions that were authorized. If you operate in multiple regions, you will usually need to repeat the setup for each region.

Information to Prepare in Advance

To avoid interruptions during setup, it is helpful to prepare the following in advance:

  • Your registered company name
  • Your company website URL
  • The name and email of the technical contact
  • The Amazon store name and marketplace region you plan to connect
  • Standard answers for the security questionnaire

Note: If you are unsure how to complete the security questionnaire or do not have a suitable business email address, contact the StoreClaw customer success team before submitting. Submitting incomplete or inconsistent information may lead to a rejection and a longer wait on resubmission.

Step 1: Open the App Development Entry

1. Sign in to Amazon Seller Central

Open your browser and go to https://sellercentral.amazon.com/, then sign in with your primary seller account.

If you land on the Seller Central dashboard, you can access the relevant settings or development entry from the upper-right menu.

Amazon Seller Central Settings

2. Open the Develop Apps Page

In the top or left navigation of Seller Central, find:

Apps and Services -> Develop Apps

Amazon Develop Apps Menu

If you cannot find this entry, the most common causes are:

  • You are signed in with a sub-account
  • The sub-account has not been granted Develop Apps permission
  • The current account is not a Professional Seller account

In that case, ask the primary account owner to go to Settings -> User Permissions and grant the required development permissions.

3. Select the Seller Account to Bind

If your login is associated with multiple seller accounts, Amazon will ask you to choose the one you want to connect to StoreClaw.

Amazon Select Account

Tip: If you choose the wrong account at this stage, you can still switch later, but it is better to confirm the correct store and marketplace first.

Step 2: Complete Developer Profile Registration or Review

This is the most important and often the most time-consuming part of the process. You can create a production app only after the developer profile has been approved.

1. Fill in the Developer Profile

If this is the first time the account is using app development features, Amazon will ask you to complete the developer profile or the onboarding flow in the newer Solution Provider Portal.

Amazon SPP Onboarding

Pay special attention to the following sections:

  • Contact Information: Use a real, stable business email address that can receive review notifications.
  • Data Access / Roles: These determine which types of data StoreClaw can read.
  • Security Questionnaire: Amazon will ask about encryption, access control, log retention, employee permissions, and incident response.

2. Recommended Data Access Roles

For StoreClaw basic users, it is recommended to select the following roles as completely as possible so that later analysis features do not miss data:

  • Product Listing
  • Pricing
  • Inventory and Order Tracking
  • Amazon Fulfillment
  • Buyer Communication
  • Tax Invoicing
  • Tax Remittance

Note: Role names may vary slightly as Amazon updates the interface. The main principle is to cover product, pricing, inventory, order, and fulfillment data as completely as possible.

The reason for selecting these roles broadly is that StoreClaw's business analysis, customer insights, inventory checks, and fulfillment analysis rely on multiple data domains at the same time. If one category of role is missing, some analysis results may be incomplete or certain modules may not work as expected.

In most cases, selecting these relevant roles does not create additional charges, and you can return later to adjust the permissions if your business needs change.

3. Complete the Security Questionnaire

The security questionnaire is usually a key review checkpoint and one of the most common reasons that a submission gets sent back. Typical questions may cover:

  • Data encryption methods
  • Access control mechanisms
  • Log retention periods
  • Employee permission management
  • Data breach response procedures

If you are not sure how to answer, it is best to get the standard response template from the StoreClaw customer success team before submitting.

4. Submit and Wait for Review

After submission, the profile will usually enter review status. Review results are typically sent to the contact email address you provided in the profile.

Common review timing:

  • Developer profile review: about 3-5 business days

Once approved, you will usually see the entry to continue creating an app, such as Add new application, Add new app client, or a similar button.

Step 3: Create the App

After the developer profile is approved, return to the app development page and create your first app.

1. Open the App List

Go back to the Develop Apps page or the Solution Provider Portal page and locate the app list area.

2. Create the App

Click Add new application, Add new app client, or a similar button to start creating the app. At this stage, you will usually need to fill in:

  • App Name: It is recommended to use something like StoreClaw - [Your Company Short Name] so the app is easy to identify later.
  • API Type: Select Selling Partner API
  • App Type: Select Production

When creating the app, pay attention to the environment type:

  • Sandbox: Returns test data only and is meant for developer testing
  • Production: Returns real store data and is the correct choice for StoreClaw

Note: If you are connecting the store to StoreClaw, make sure the later authorization and data access are based on the Production environment. A Sandbox-only setup will return test data instead of real store data.

Step 4: Collect the 4 Credentials Required by StoreClaw

After the app is created, open the app details page and collect all credentials one by one.

1. Get the Seller ID

The Seller ID is your seller identity number and usually starts with an uppercase A.

You can find it in the app details page or in the relevant account information section of Seller Central.

Amazon App List Seller ID

When copying it:

  • Do not include leading or trailing spaces
  • Make sure the full value is copied

2. Get the LWA Client ID and LWA Client Secret

On the app details page, find the LWA credentials section:

  • Client identifier is the LWA Client ID
  • Client secret is the LWA Client Secret

Amazon LWA Credentials

Note: The LWA Client Secret should be treated like a password. Do not share it in group chats, public documents, or screenshots. It is best to paste it directly into StoreClaw after copying.

3. Get the Refresh Token

The Refresh Token is the most important of the four credentials because it allows StoreClaw to access your store data on an ongoing basis.

In most cases, you can generate it from the app details page by clicking Authorize, Self Authorize, Create Token, or a similar button.

Amazon Create Token Menu

After authorization, Amazon returns a long token string, usually starting with Atzr|. That is the Refresh Token.

Amazon Refresh Token

Important: The Refresh Token is often shown in full only once at the time it is generated. Copy and save it immediately. If you forget to copy it, you usually need to repeat the authorization flow and the old token will become invalid.

4. Final Checklist Before Leaving Amazon

Before leaving the Amazon backend, confirm that you have copied all four items below:

CredentialDescription
Seller IDSeller identifier
LWA Client IDApp identity ID
LWA Client SecretApp secret
Refresh TokenAuthorization token

Complete the Configuration in StoreClaw

After you have all the credentials, return to StoreClaw and finish the connection:

  1. Sign in to StoreClaw and open the Connectors page from the left navigation.
  2. Find the Amazon card and click connect.

  3. In the dialog, paste the following values in order:

    • Seller ID
    • LWA Client ID
    • LWA Client Secret
    • Refresh Token
  4. Select the correct Marketplace, such as US, JP, or UK.
  5. Enter an easy-to-recognize name for this connection, such as US Main Store.
  6. Click save and connect. StoreClaw will immediately run a connectivity check.

If the card shows a connected status, the connection has been established successfully. The first data sync usually starts within a few minutes.

FAQ

Q: The Develop Apps menu is grayed out or missing. What should I do?

A: This is usually caused by the account type or permission setup. Check whether the account is a Professional Seller account, whether you are using the primary account, and if you are using a sub-account, whether development permissions were granted to it.

Q: What if the review is rejected?

A: Amazon usually explains the reason in the review email. The most common issues are an invalid contact email, incomplete or non-standard answers in the security questionnaire, or company information that does not match the registered details. Correct the issue and resubmit.

Q: I forgot to copy the Refresh Token and the page is closed. What can I do?

A: In most cases, you can return to the app details page and run the authorization or token generation flow again. The newly generated Refresh Token will replace the old one.

Q: Does the Refresh Token expire?

A: Under normal circumstances, it remains valid for a long time. However, it can become invalid if you revoke authorization, change key app permissions, or Amazon flags the usage as abnormal. In that case, repeat the authorization process to restore the connection.

Q: I operate in multiple regions such as the US, Japan, and Germany. How many times do I need to do this?

A: Amazon's North America, Europe, and Far East ecosystems are usually managed separately. If you need to connect multiple regions, you will generally need to complete the setup separately for each one.

Q: Is there any cost for this setup itself?

A: Amazon's developer registration and SP-API access are generally not charged separately. StoreClaw pricing depends on your subscription plan and the number of stores you connect.

连接 Amazon 后，StoreClaw 可以在授权范围内读取订单、库存、商品、评价等数据，用于经营分析、简报和自动化任务。本文说明如何通过 Amazon SP-API 完成开发应用配置，并获取连接 StoreClaw 所需的 4 项凭证。

流程概览

完成 Amazon 店铺连接，通常需要先完成以下 3 个核心阶段：

  1. 准备账号与资料
  2. 完成开发者资料注册或审核
  3. 创建应用并提取 4 项凭证

完成以上流程后，您需要将以下 4 项信息填写到 StoreClaw：

  1. Seller ID
  2. LWA Client ID
  3. LWA Client Secret
  4. Refresh Token

提示： 这套流程里最耗时的部分通常是亚马逊对开发者资料的审核。建议优先启动审核，等待期间再继续熟悉后续步骤。

连接前请确认

在开始操作前，请确认您满足以下条件：

  • 您使用的是 Amazon 专业卖家账号（Professional Seller Account）。
  • 您当前登录的是 主账号，或者已被主账号授予开发应用权限。
  • 您已明确本次要接入的站点区域，例如北美站（NA）、欧洲站（EU）或远东站（FE）。

注意： 同一套凭证只能访问已授权的区域。如果您同时运营多个区域，通常需要分别完成对应区域的接入流程。

建议提前准备的信息

为了避免中途卡住，建议在正式开始前先准备好这些资料：

  • 公司注册名称
  • 公司官网 URL
  • 技术联系人姓名与邮箱
  • 计划接入的 Amazon 店铺名与所属站点
  • 安全问卷标准答复

注意： 如果您不确定安全问卷如何填写，或没有可用的企业邮箱，建议先联系 StoreClaw 客户成功团队获取标准答复模板，再开始提交。随意提交可能导致审核被拒，且二次提交等待时间更长。

第一步：进入开发应用入口

1. 登录 Amazon 卖家中心

打开浏览器并访问 https://sellercentral.amazon.com/，使用您的主账号登录。

如果您登录后进入的是卖家中心后台，可以从右上角菜单进入相关设置或开发入口。

Amazon Seller Central Settings

2. 打开 Develop Apps 页面

在卖家中心顶部或左侧菜单中找到：

Apps and Services （应用和内容） -> Develop Apps （开发应用）

Amazon Develop Apps Menu

如果您找不到这个入口，最常见原因如下：

  • 当前登录的是子账号
  • 子账号未被授予 Develop Apps 权限
  • 当前账号不是专业卖家账号

此时请让主账号在 Settings -> User Permissions 中为您勾选相关开发权限后再重试。

3. 选择要绑定的卖家账户

如果当前登录账号关联了多个卖家账户，系统会先要求您选择本次要接入 StoreClaw 的目标账户。

Amazon Select Account

提示： 如果本次选错账户，后续仍可以返回页面重新切换，但建议一开始就确认好对应的店铺与站点。

第二步：完成开发者资料注册或审核

这是整个流程里最关键、也最可能耗时的部分。只有开发者资料通过审核后，您才能继续创建正式应用。

1. 填写开发者资料

如果这是该账户第一次使用开发应用能力，系统会要求您完成开发者资料或新版 Solution Provider Portal 的入驻流程。

Amazon SPP Onboarding

填写时请重点关注以下几部分：

  • 联系信息（Contact Information）： 建议填写真实、稳定可收信的企业邮箱。
  • 数据访问角色（Data Access / Roles）： 这些角色决定 StoreClaw 可以读取哪些数据。
  • 安全问卷（Security Questionnaire）： 亚马逊会询问数据加密、访问控制、日志保留、员工权限、泄露响应等问题。

2. 推荐勾选的数据角色

对于 StoreClaw 的基础用户，建议尽量完整勾选以下角色，避免后续某些分析能力缺少数据：

  • Product Listing （商品目录）
  • Pricing（商品定价）
  • Inventory and Order Tracking（库存和订单）
  • Amazon Fulfillment（FBA 履约）
  • Buyer Communication（买家消息）
  • Tax Invoicing（税务发票，视站点而定）
  • Tax Remittance（税款申报，视站点而定）

说明： 具体角色名称可能会随着亚马逊页面更新略有变化。核心原则是尽量覆盖商品、价格、库存、订单和履约等数据域。

之所以建议尽量完整勾选，是因为 StoreClaw 的经营分析、客户洞察、库存判断、履约分析等能力会同时依赖多个数据域。少勾某一类角色，可能会导致部分分析结果不完整，或某些模块无法正常使用。

通常情况下，勾选这些相关角色不会产生额外费用，后续如果业务需求变化，也可以再返回后台调整权限设置。

3. 填写安全问卷

安全问卷通常是审核中的重点部分，也是最容易导致资料被退回的环节之一。常见问题通常会涉及：

  • 数据加密方式
  • 访问控制机制
  • 日志留存时间
  • 员工权限管理
  • 数据泄露响应流程

如果您不确定如何填写，建议先向 StoreClaw 客户成功团队获取标准答复模板后再提交。

4. 提交并等待审核

提交后，系统通常会进入审核状态。审核结果一般会发送到您在资料中填写的联系邮箱。

常见审核周期：

  • 开发者资料审核： 约 3–5 个工作日

审核通过后，您通常会看到可以继续创建应用的入口，例如 Add new application、Add new app client 或类似按钮。

第三步：创建应用

审核通过后，返回开发应用页面并创建您的第一个应用。

1. 进入应用列表

回到 Develop Apps （开发应用） 或 Solution Provider Portal （解决方案提供商门户） 页面，找到应用列表区域。

2. 创建应用

点击 Add new application （添加新应用）、Add new app client （添加新的应用客户端）或同类按钮，开始创建应用。此时通常需要填写：

  • App Name（应用名称）： 建议填写 StoreClaw - [你的公司简称]，方便未来识别
  • API Type（API 类型）： 选择 Selling Partner API
  • App Type（应用类型）： 选择 Production（生产环境）

创建时请注意环境类型：

  • Sandbox： 仅返回测试数据，用于开发调试
  • Production： 返回真实店铺数据，供 StoreClaw 使用

注意： 如果您是为了连接 StoreClaw，请优先确认后续授权和数据读取使用的是 Production 环境。仅创建 Sandbox 应用会导致拿到的只是测试数据。

第四步：获取 StoreClaw 所需的 4 项凭证

应用创建完成后，在应用详情页中依次提取全部凭证。

1. 获取 Seller ID

Seller ID 是您的卖家身份编号，通常以大写字母 A 开头。

您可以在应用详情页或卖家中心相关账户信息页面中看到它。

Amazon App List Seller ID

复制时请注意：

  • 不要带入前后空格
  • 保持完整，不要截断

2. 获取 LWA Client ID 和 LWA Client Secret

在应用详情页中找到 LWA credentials 区域：

  • Client identifier 就是 LWA Client ID
  • Client secret 就是 LWA Client Secret

Amazon LWA Credentials

注意： LWA Client Secret 相当于密码。不要发到群聊、公开文档或截图传播，建议复制后直接填写到 StoreClaw。

3. 获取 Refresh Token

Refresh Token 是 4 项凭证中最关键的一项，用于让 StoreClaw 长期访问您的店铺数据。

通常做法是在应用详情页中点击 Authorize、Self Authorize、Create Token 或相近按钮。

Amazon Create Token Menu

授权完成后，页面会返回一串很长的令牌，一般以 Atzr| 开头，这就是 Refresh Token。

Amazon Refresh Token

重要： Refresh Token 往往只在生成当下完整显示一次。请务必立刻复制并保存。如果忘记复制，通常需要重新走一次授权流程，旧 Token 会失效。

4. 提取前的检查清单

在离开 Amazon 后台前，请确认以下 4 项都已经复制完成：

凭证说明
Seller ID卖家编号
LWA Client ID应用身份编号
LWA Client Secret应用密钥
Refresh Token授权令牌

在 StoreClaw 中完成配置

拿到全部凭证后，返回 StoreClaw 完成接入：

  1. 登录 StoreClaw，打开左侧导航栏的 连接器 页面。
  2. 找到 Amazon 卡片并点击连接。

  3. 在弹窗中依次填写：

    • Seller ID
    • LWA Client ID
    • LWA Client Secret
    • Refresh Token
  4. 选择店铺所属的 Marketplace，例如 US、JP、UK。
  5. 为本次连接填写一个易识别的名称，例如 美国站-主店。
  6. 点击保存并连接，StoreClaw 会立即进行一次连通性校验。

如果卡片显示已连接，说明连接已建立。通常首次数据同步会在几分钟内开始。

常见问题 (FAQ)

Q：Develop Apps 菜单是灰的，或者根本看不到，怎么办？

A： 通常是账号类型或权限问题。请依次检查：是否是专业卖家账号、是否用主账号登录、如果是子账号，是否已被授予开发应用权限。

Q：审核被拒了怎么办？

A： 亚马逊通常会在通知邮件里说明原因。最常见的问题包括联系邮箱无效、安全问卷填写不规范，以及公司信息与注册资料不一致。修正后可重新提交。

Q：我忘记复制 Refresh Token 了，页面已经关掉怎么办？

A： 一般可以回到应用详情页，再次点击授权或生成 Token 的入口，重新走一遍流程。新生成的 Refresh Token 会替代旧的。

Q：Refresh Token 会过期吗？

A： 正常情况下它可以长期使用。但如果您主动撤销授权、修改应用关键权限，或亚马逊判定存在异常使用行为，Token 可能失效。此时重新执行授权流程即可。

Q：我同时运营美国、日本、德国等多个区域，需要做几次？

A： Amazon 的北美、欧洲、远东通常是分区域授权与管理的。若您需要分别接入多个区域，通常需要为对应区域分别完成接入流程。

Q：这个流程收费吗？

A： Amazon 官方的开发者注册和 SP-API 接入本身通常不单独收费。StoreClaw 的费用则取决于您的订阅方案和接入店铺数量。