In order to connect Amazon SP-API to API2Cart account, you need to fill out the credentials, which is shown in the screenshot below:

Amazon SP API store parameters

The seller account that is planned to be connected to API2Cart must have an active "Professional" selling plan at Amazon.

We recommend reading the original guide from the Amazon Selling Partner API Developer Guide.

1. amazon_seller_id - can be seen in Sellercentral -> Settings -> Account Info -> Business Information -> Merchant Token. Direct link: https://sellercentral.amazon.com/sw/AccountInfo/MerchantToken/step/MerchantToken

How to connect Amazon SP-API to API2Cart?

2. To determine which value should be substituted into amazon_sp_aws_region you need to use the table Selling Partner API endpoints.

Selling region AWS Region
North America (Canada, US, Mexico, and Brazil marketplaces) us-east-1
Europe (Spain, UK, France, Belgium, Netherlands, Germany, Italy, Sweden, South Africa, Poland, Saudi Arabia, Egypt, Turkey, United Arab Emirates, and India marketplaces) eu-west-1
Far East (Singapore, Australia, and Japan marketplaces) us-west-2

For example, if the seller sells in the US, you must select us-east-1.

3. To get amazon_sp_client_id and amazon_sp_client_secret you need to go to an Amazon seller account registered as a developer. If there is no such an account, you have to register a seller account, and then register in it as a developer here - Register as a developer.

Go to Developer Central and add a new client.

Develop Apps

Add new client

Create SP API app

Click “View” to see amazon_sp_client_id and amazon_sp_client_secret.

LWA credentials

Please note that the lifetime of amazon_sp_client_id and amazon_sp_client_secret credentials is limited to 180 days. Therefore, you should periodically update them in the "Amazon developer console" and then in our system using the account.config.update method.

4. To get the last parameter - amazon_sp_refresh_token you need to implement OAuth authentication in one of the following ways:

  1. Website workflow
  2. Marketplace Appstore workflow
  3. Self authorization

Let's consider the 3rd way, it is the most convenient when you need to quickly get an amazon_sp_refresh_token to test the work.

Autorize app

Copy the refresh token

5. Now, when you have all the necessary credentials, you can add a store in API2Cart.

Add store

Important details:
  • Amazon restricts API access to personally identifiable information (PII), such as addresses in orders. If your app requires this data, you need to get access to it. To do this, you need to select the “Direct-to-Consumer Shipping” role and fill out the application form on Amazon Developer Profile https://sellercentral.amazon.com/developer/register



  • We do not have our app with access to personal data, and we do not plan to do so because, in this case, we would be forced to place our app on the Amazon marketplace. That will cause a white label will be impossible, and sellers must install the API2Cart app instead of your app.

  • Sometimes you may get the API2Cart response with an error "Report is not ready yet, please try again later (report_request_id=XXXXXXXXXXXX)". This is because the Amazon API, in many cases, does not provide real-time data, so API2Cart is forced to work through the Reports API. For example, when requesting "product.list" or "product.info", API2Cart requests a report and waits for its result, the maximum waiting time is 15 seconds, and if the report information is not ready during this time, the above error text will be returned. When receiving this error, you need to wait 1-5 minutes and try to repeat the request with the same parameters. Reports are cached on our side for 15 minutes. If you pass the parameter disable_report_cache=true, the cache is not used.