SP-API Vendor FAQ
Frequently asked questions for SP-API Vendors.
Who can help add vendor codes to my Vendor Central account?
Select to expand the answer.
If you use a single vendor group to manage all of your vendor codes, you can authorize an application to access the data in that vendor group. To do this, register as a developer using the credentials for the Vendor Central account associated with the vendor group.To be sure that your vendor group contains all of the vendor codes that you want your application to access, check the vendor codes in your vendor group. If you need to, you can add or remove vendor codes from your vendor group at any time.
To add or remove vendor codes from your vendor group:
- Go to Vendor Central. Refer to Vendor Central URLs for a list of URLs by country.
- Sign in using the credentials for the Vendor Central account with the vendor group for which you want to add or remove vendor codes.
- Select the Support link at the top of the page.
- On the Support page, select the Contact Us button.
- On the Contact Amazon support page, select Settings and Account Management, then choose Account Settings.
- In the Settings and Account Management box, at the bottom, select Still need help?.
- Follow the instructions to contact Amazon support.
Is there an additional price for adopting Vendor APIs?
Select to expand the answer.
No, it is a free service and you can start Vendor API integration by registering as a developer.
Do I need to register separate application clients for Retail and Direct Fulfillment (DF) API access?
Select to expand the answer.
No. API integration is based on access to specific roles. You can create one application client and add the required roles to have access to the APIs. So one application can have both the roles, if you need access to both Retail and DF APIs.
What can I do if my developer profile is not approved?
Select to expand the answer.
You can appeal the decision via a support case with our vetting team, and they will provide insight on the missing details or any relevant changes that the submission needs to have to get the application approved.
I have multiple vendor groups. Do I need to submit a developer profile for each group?
Select to expand the answer.
A developer account that is set as an administrator for your vendor groups can authorize a single application for multiple vendor groups. As a private developer, you can use the application to authorize nine other vendor groups. With this method, you can authorize your application for multiple vendor groups and countries, without having to submit a new application for each of them. Refer to Using multiple vendor groups for more information. For more information on self-authorization, refer to the Vendor Self Authorization documentation.
Where can I find documentation related to Vendor API?
Select to expand the answer.
You can go to the Vendor Direct Fulfillment APIs Use Case Guide, the Vendor Retail Procurement Use Case Guide or you can navigate to the “Integration” > “API Integration” section of your Vendor Central account, and select the “API Documentation” hyperlink to download the documentation.
The “Getting Started” page under the “Integration” menu item also has additional details including FAQ on EDI vs API usage.
What role do I need for the API integration access?
Select to expand the answer.
-
For Direct Fulfillment API access, you must have the Direct-to-Consumer Shipping role added to your application client.
Note
Direct-to-Consumer Shipping is a restricted role. Restricted roles allow access to Personally Identifiable Information (PII) about Amazon Buyers so you will be required to provide additional information about your data use and security controls.
-
For Retail Procurement API access, you must have the Amazon Fulfillment role added to your application client.
What are the regions in which Vendor API is currently available?
Select to expand the answer.
Our vendor API integration features and support operations are available in the following regions and marketplaces:- NA: (US, CA, MX)
- EU: (ES, UK, FR, DE, IT)
- India: (IN)
- FE: (JP, AU, SG)
Make sure to enable the API integration using the correct vendor code, region, and country since this is not yet available in all marketplaces.
Is there a sandbox environment for Vendor API?
Select to expand the answer.
Yes. The Selling Partner API provides a sandbox environment that allows you to test your applications without affecting production data or triggering real-world events. Making sandbox calls to the Selling Partner API is identical to making production calls except you direct the calls to the Selling Partner API sandbox endpoints.
The authorization and authentications models are the same for sandbox calls and production calls. Calling the sandbox endpoints returns static, mocked responses for all Selling Partner APIs. You can refer to these mocked responses in the Swagger model JSON file for the API that you want to call. For more information, refer to How to make a sandbox call to the Selling Partner API and Selling Partner API sandbox endpoints.
Is there a list of third-party providers for Vendor API?
Select to expand the answer.
For information on third-party developers and vendor direct fulfillment APIs, refer to Vendor Central.
Can Vendor API be integrated through EDI?
Select to expand the answer.
No, Vendor API is built on the Selling Partner API (SP-API) and the registration process and integration is described in the SP-API Registration overview.
How do I get an access token for the API requests?
Select to expand the answer.
A Login with Amazon (LWA) access token authorizes your application to take certain actions on behalf of a selling partner. An access token expires one hour after it is issued, and must be included with every request to the Selling Partner API.For more information, refer to Connecting to the Selling Partner API.
Is there a way to access Postman collections with examples?
Select to view the answer.
Yes. To access the SP-API Postman collections, refer to Using Postman for Selling Partner API Models.
Can I test using production data before going live?
Select to view the answer.
Testing is not available with vendors' production data right now. Vendors can test in the sandbox environment using mock request and responses. Sandbox testing performs syntax and semantic validation but does not perform business validation.
To learn more about making a sandbox call to SP API, refer to The Selling Partner API sandbox topic.
Need more help?
For additional support, contact Selling Partner API Developer Support. For vendor applications, submit a support case in Vendor Central by navigating to Vendor Central > Support > Contact Us > API Integration.
Updated 18 days ago