After you connect Amazon, StoreClaw can read orders, inventory, products, reviews, and related data within the authorized scope for business analysis, briefs, 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 includes the following three stages:

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

After completing the process, you will need to enter the following four 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. We recommend starting the review as early as possible and using the waiting time to review the rest of the setup.

Security Note: StoreClaw only reads Amazon store data within the scope you authorize for business analysis, briefs, and automation tasks. The connection process does not modify, delete, or publish your Amazon store data.

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 usually access only the regions and marketplaces included in the authorization scope. If you operate in multiple regions, you may need to repeat the setup for each region.

Information to Prepare in Advance

To avoid interruptions during setup, prepare the following information in advance:

  • Registered company name
  • Business registration documents or company verification information, such as registration number, registered address, or business owner information
  • Identity information for the business owner, legal representative, or account administrator, if requested by Amazon
  • Company website URL
  • Business email address and technical contact name
  • Amazon store name and marketplace region you plan to connect, such as North America, Europe, or Far East
  • Business description of how StoreClaw will use Amazon data, such as for store business analysis, inventory analysis, order briefs, review analysis, and automation tasks
  • 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 rejection and a longer wait when you resubmit.

Amazon may require you to complete business identity verification, business owner or legal representative identity verification, or administrator identity verification. Some accounts may also require facial verification. Specific requirements vary by account type, country of registration, and Amazon page prompts. Refer to the actual Amazon page for details.

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 Connect

If your sign-in account 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.
  • App Type Selection: If the page requires you to select an app type, refer to the "Choose App Type" section below. For regular merchants connecting their own stores, usually choose Private application / Private developer.
  • Data Access / Roles: These roles determine which types of data StoreClaw can read.
  • Security Questionnaire: Amazon will ask about encryption, access control, log retention, employee permissions, and incident response.

Choose App Type

In the Amazon Solution Provider Portal or developer profile page, if you need to select an app type, choose Private application / Private developer.

This option is suitable for merchants who are creating an internal integration app for their own Amazon stores and using the authorization information to allow StoreClaw to read authorized store data.

In most cases, do not choose Public application unless you are developing a public app for other Amazon sellers and plan to provide services to external sellers through an OAuth authorization flow and Amazon review.

Simply put:

  • If you only want to connect your own Amazon store to StoreClaw, choose Private application / Private developer.
  • If you are a software service provider developing a public app for multiple Amazon sellers, then consider Public application.

2. Select Data Access Roles

Data access roles determine which Amazon store data StoreClaw can read. Select roles based on the business scope you want StoreClaw to analyze.

For StoreClaw's basic business analysis, inventory analysis, order briefs, and product analysis, we recommend prioritizing the following roles:

  • Product Listing: Reads product and listing information.
  • Pricing: Reads product prices, selling prices, and price-related data.
  • Inventory and Order Tracking: Reads inventory and order status-related data.
  • Amazon Fulfillment: Reads FBA fulfillment, inventory, and shipping-related data.
  • Buyer Communication: Select this role if you need to analyze buyer communication or message-related data.
  • Tax Invoicing: Select this role if you need invoice or tax-related analysis, based on marketplace requirements.
  • Tax Remittance: Select this role if you need tax remittance-related analysis, based on marketplace requirements.

Note: The more complete the roles are, the more complete the data range StoreClaw can analyze. However, some roles may require stricter review. Select roles based on your actual business needs and refer to the final available options and review results on the Amazon page.

Note: If a role is not approved, you can still complete the connection with other approved roles first. StoreClaw will not read unauthorized data, and the corresponding analysis capabilities may be unavailable or incomplete.

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, 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 an 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: We recommend using a name 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 use the Production environment. A Sandbox-only setup will return test data instead of real store data.

Step 4: Collect the Four 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 on the app details page or in the relevant account information section of Seller Central：

  1. Click the settings icon in the top right corner and select Account Info.
  2. Click Business Information and then Your Merchant Token.
  3. In the Merchant Token page, you can find the Seller ID you need.
  4. Copy Seller ID to StoreClaw.

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: Treat the LWA Client Secret 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 sensitive of the four credentials because it allows StoreClaw to keep accessing your authorized store data.

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|. This is the Refresh Token.

Amazon Refresh Token

Important: The Refresh Token is often shown in full only once when 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:

Credential Description
Seller ID Seller identifier
LWA Client ID App identity ID
LWA Client Secret App secret
Refresh Token Authorization 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: 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.

Q: Can I connect multiple Amazon stores?

A: Currently, the custom Amazon connector in StoreClaw is account-based. Each StoreClaw account supports connecting only one Amazon account.

The Amazon marketplaces that can be connected to StoreClaw depend on the authorization scope configured in your Private application. For example, if the authorization scope includes the United States, Canada, the United Kingdom, and France, all four marketplaces can be connected.

To update the marketplace scope, update the authorization scope in Amazon first. Then return to StoreClaw, disconnect the current Amazon connection, and reconnect it.

连接 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

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

安全说明： StoreClaw 仅在您授权的范围内读取 Amazon 店铺数据，用于经营分析、简报和自动化任务。连接过程不会修改、删除或发布您的 Amazon 店铺数据。

连接前请确认

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

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

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

建议提前准备的信息

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

  • 公司注册名称
  • 公司营业执照或商业登记信息，例如注册号、注册地址、法定代表人信息等
  • 法人或账号管理员的身份证件信息
  • 公司官网 URL
  • 企业邮箱和技术联系人姓名
  • 计划接入的 Amazon 店铺名与所属站点，例如北美站、欧洲站或远东站
  • StoreClaw 使用 Amazon 数据的业务说明，例如用于店铺经营分析、库存分析、订单简报、评价分析和自动化运营任务
  • 安全问卷标准答复

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

Amazon 可能会要求完成企业身份验证、法人或管理员身份验证，部分账号还可能出现人脸验证流程。具体要求会因账号类型、注册国家或 Amazon 页面提示而不同，请以 Amazon 实际页面为准。

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

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）： 建议填写真实、稳定可收信的企业邮箱。
  • 应用类型选择： 如页面要求选择应用类型，请参考下方"选择应用类型"说明。普通商家连接自己店铺时，通常选择 Private application / Private developer。
  • 数据访问角色（Data Access / Roles）： 这些角色决定 StoreClaw 可以读取哪些数据。
  • 安全问卷（Security Questionnaire）： 亚马逊会询问数据加密、访问控制、日志保留、员工权限、泄露响应等问题。

选择应用类型

在 Amazon Solution Provider Portal 或开发者资料页面中，如果需要选择应用类型，请选择 Private application / Private developer。

该方式适用于商家为自己的 Amazon 店铺创建内部接入应用，并将授权信息用于 StoreClaw 读取已授权的店铺数据。

不要选择 Public application，除非您要开发一个面向其他 Amazon 卖家的公开应用，并计划通过 OAuth 授权流程和 Amazon 相关审核面向外部卖家提供服务。

简单来说：

  • 如果您只是要把自己的 Amazon 店铺连接到 StoreClaw，请选择 Private application / Private developer。
  • 如果您是软件服务商，要开发一个给多个 Amazon 卖家使用的公开应用，才需要考虑 Public application。

2. 选择数据访问角色

数据访问角色决定 StoreClaw 可以读取哪些 Amazon 店铺数据。建议根据您希望 StoreClaw 分析的业务范围选择角色。

对于 StoreClaw 的基础经营分析、库存分析、订单简报和商品分析，建议优先选择以下角色：

  • Product Listing（商品目录）：用于读取商品和 listing 信息。
  • Pricing（商品定价）：用于读取商品价格、销售价和价格相关数据。
  • Inventory and Order Tracking（库存和订单）：用于读取库存和订单状态相关数据。
  • Amazon Fulfillment（FBA 履约）：用于读取 FBA 履约、库存和配送相关数据。
  • Buyer Communication（买家消息）：如需分析买家沟通或消息相关数据，可选择该角色。
  • Tax Invoicing（税务发票）：如需处理发票或税务相关分析，可按站点需要选择。
  • Tax Remittance（税款申报）：如需处理税款申报相关分析，可按站点需要选择。

说明： 角色越完整，StoreClaw 后续可分析的数据范围越完整；但部分角色可能需要更严格的审核。请根据实际业务需要选择，并以 Amazon 页面最终可选项和审核结果为准。

注意： 如果某个角色暂时没有获批，您仍然可以先完成其他已获批角色的连接。未授权的数据范围不会被 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 开头。

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

  1. 点击右上角的设置图标，选择 账户信息。
  2. 随即在左侧的导航栏中，选择 业务信息，点击 您的卖家记号。
  3. 在 卖家记号 页面，即可找到 Seller ID。
  4. 复制 Seller ID 到 StoreClaw。 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 官方的开发者注册和 SP-API 接入本身通常不单独收费。StoreClaw 的费用则取决于您的订阅方案和接入店铺数量。

Q：我可以连接多个 Amazon 店铺吗？

A： 目前，StoreClaw 的自定义 Amazon 连接按账号授权。每个 StoreClaw 账号仅支持连接 1 个 Amazon 账号。 该 Amazon 账号下实际可连接的站点，取决于您在 Private application 中配置的授权范围。例如，如果授权范围包含美国、加拿大、英国和法国，那么这些站点都可以连接到 StoreClaw。 如需调整站点范围，请先在 Amazon 侧更新 Private application 的授权范围，然后回到 StoreClaw 断开当前连接并重新连接。