How to Connect to Amazon Seller Central
This guide will help you connect your Amazon Seller Central account to Apideck's Unified API. Amazon Seller Central provides access to the Selling Partner API (SP-API), which allows you to programmatically access your data on orders, products, shipments, and more.
Prerequisites
Before you begin, make sure you have:
- An active Amazon Seller Central account
- Access to your Amazon Seller Central account as the primary user
Configuration Settings
1. Seller Central URL
Select the appropriate Seller Central URL based on your marketplace location. This is the URL where your seller account is located.
Available options include:
- 🇦🇺 Australia:
https://sellercentral.amazon.com.au - 🇧🇪 Belgium:
https://sellercentral.amazon.com.be - 🇧🇷 Brazil:
https://sellercentral.amazon.com.br - 🇨🇦 Canada:
https://sellercentral.amazon.ca - 🇪🇬 Egypt:
https://sellercentral.amazon.eg - 🇪🇸 Spain:
https://sellercentral-europe.amazon.com - 🇫🇷 France:
https://sellercentral-europe.amazon.com - 🇬🇧 UK:
https://sellercentral-europe.amazon.com - 🇩🇪 Germany:
https://sellercentral-europe.amazon.com - 🇮🇳 India:
https://sellercentral.amazon.in - 🇮🇹 Italy:
https://sellercentral-europe.amazon.com - 🇯🇵 Japan:
https://sellercentral.amazon.co.jp - 🇲🇽 Mexico:
https://sellercentral.amazon.com.mx - 🇳🇱 Netherlands:
https://sellercentral.amazon.nl - 🇵🇱 Poland:
https://sellercentral.amazon.pl - 🇸🇦 Saudi Arabia:
https://sellercentral.amazon.sa - 🇸🇬 Singapore:
https://sellercentral.amazon.sg - 🇿🇦 South Africa:
https://sellercentral.amazon.co.za - 🇸🇪 Sweden:
https://sellercentral.amazon.se - 🇹🇷 Turkey:
https://sellercentral.amazon.com.tr - 🇦🇪 U.A.E.:
https://sellercentral.amazon.ae - 🇺🇸 US:
https://sellercentral.amazon.com
2. Marketplace IDs
After configuring your initial settings, you'll need to select the marketplace ID for the registered store from which you intend to extract data.
Available marketplace IDs include:
- 🇦🇺 Australia:
A39IBJ37TRP1C6 - 🇧🇷 Brazil:
A2Q3Y263D00KWC - 🇧🇪 Belgium:
AMEN7PMS3EDWL - 🇨🇦 Canada:
A2EUQ1WTGCTBG2 - 🇩🇪 Germany:
A1PA6795UKMFR9 - 🇪🇬 Egypt:
ARBP9OOSHTCHU - 🇪🇸 Spain:
A1RKKUPIHCS9HS - 🇫🇷 France:
A13V1IB3VIYZZH - 🇮🇳 India:
A21TJRUUN4KGV - 🇮🇹 Italy:
APJ6JRA9NG5V4 - 🇯🇵 Japan:
A1VC38T7YXB528 - 🇲🇽 Mexico:
A1AM78C64UM0Y8 - 🇳🇱 Netherlands:
A1805IZSGTT6HS - 🇵🇱 Poland:
A1C3SOZRARQ6R3 - 🇸🇦 Saudi Arabia:
A17E79C6D8DWNP - 🇸🇬 Singapore:
A19VAU5U5O7RUS - 🇸🇪 Sweden:
A2NODRKZP88ZB9 - 🇹🇷 Turkey:
A33AVAJ2PDY3EV - 🇿🇦 South Africa:
AE08WJ6YKNBMC - 🇦🇪 United Arab Emirates:
A2VIGQ35RCS4UG - 🇬🇧 United Kingdom:
A1F83G8C2ARO7P - 🇺🇸 United States of America:
ATVPDKIKX0DER
3. Merchant Token
To find your Merchant Token, go to Settings ⚙️(on the top right corner) > "Account Info" > "Business Information" > "Your Merchant Token" and copy the Merchant Token as per your region.
or
Follow this link and copy the Merchant Token as per your region.
Configure in Apideck
1. Enter Your Configuration Settings
Enter the following settings to set up the connection:
- Seller Central URL: Select the appropriate Seller Central URL from the dropdown menu based on your marketplace location
2. Select Marketplace IDs
After saving your initial settings, select the marketplace IDs for the registered stores from which you intend to extract data.
3. Enter Your Merchant Token
Enter the Merchant Token in the "Merchant Token" field. Example: A2345SIRxxxxxx
4. Connect Your Account
Once you've entered all the required settings:
- Click Save settings
- Click Connect
- You'll be redirected to Amazon to authorize the connection
- After authorization, you'll be redirected back to Apideck
Troubleshooting
Resolve 400 Errors
There are many possible reasons for a 400 response. Here are the most common causes and solutions:
For more detailed information, see the Amazon SP-API documentation on resolving 400 errors.
Permissions and Credentials
Ensure the following:
- Required roles are approved for your profile and application
- The seller account is active
If your seller account isn't active and you're receiving 400 errors:
- Contact the seller and request that they navigate to Seller Central > Settings > Account Info > Charge Information
- If the Charge Information page displays a banner requesting a credit card update, ask the seller to update their credit card information
- Allow 48 hours for the updates to propagate through all Amazon systems
Note: If a seller account has not been used for 90 or more days, the account will be marked dormant, and the seller will be advised to update their credit card. Allow for a 48-hour waiting period to ensure a successful update. Afterwards, API calls can be made by that account.
Error: Invalid Application ID
If you receive an error about an invalid Application ID:
- Double-check that you've copied the correct Application ID
- Ensure there are no extra spaces or characters in the ID
Error: Marketplace Selection
If you're having issues with marketplace selection:
- Ensure you've selected the correct Seller Central URL for your region
- Verify that you've selected the appropriate marketplace IDs for your stores
Rate Limits
Rate limits apply per account-application pair. The following rate limits apply to order-related operations:
For more information, see the Amazon SP-API Orders API rate limits documentation.
Orders List (getOrders)
- Rate limit: 0.0167 requests per second
- Burst: 20 requests
- Scope: Per account-application pair
Single Order (getOrder)
- Rate limit: 0.5 requests per second
- Burst: 30 requests
- Scope: Per account-application pair
Order Line Items on Single Order (getOrderItems)
- Rate limit: 0.5 requests per second
- Burst: 30 requests
- Scope: Per account-application pair