SP-API Vendor FAQs

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:

  1. Go to Vendor Central. See Vendor Central URLs for a list of URLs by country.
  2. Sign in using the credentials for the Vendor Central account with the vendor group for which you want to add or remove vendor codes.
  3. Select the Support link at the top of the page.
  4. On the Support page, select the Contact Us button.
  5. On the Contact Amazon support page, select Settings and Account Management, then choose Account Settings.
  6. In the Settings and Account Management box, at the bottom, select Still need help?.
  7. 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.

Note: To register as a developer, you will need to create an Amazon Web Service (AWS) account.

  • Identity and Access Management (IAM) is a feature offered at no additional charge.
  • If you sign up for the free tier and the only AWS service you use is IAM, your account should continue to be free. You might incur charges after 12 months for the use of other AWS services by your users, if you use any other AWS services.
  • You can reference the IAM Pricing FAQ and the AWS Free tier info which includes information about which services always have free usage tiers or limits and which ones have 12 month free trials.

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 FAQs 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 should be the correct IAM Amazon Resource Name (ARN) value to be added during registering my application?

Select to expand the answer.

When registering your application, the IAM ARN that you provide must be for the IAM entity to which you attached the IAM policy from Step 3. Create an IAM policy.

In this workflow, that IAM entity is the IAM role from Step 4. Create an IAM role. If you register your application using your IAM user, be sure that the IAM policy is attached to it. Otherwise your calls to Selling Partner API will fail.

We recommend registering your application using an IAM role to help you better control access to your AWS resources.

These steps are available in the Register your application topic.

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, see How to make a sandbox call to the Selling Partner API and Selling Partner API sandbox endpoints.

Is there a list of 3rd party providers for Vendor API?

Select to expand the answer.

For information on third-party developers and vendor direct fulfillment APIs, see 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, see Connecting to the Selling Partner API.

Is there a way to access postman collections with examples directly from Vendor Central? Do I need to open a case to request access to them?

Select to view the answer.

You must open a support case to request postman collections today. We are working to make them available soon in Vendor Central for download.

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, see 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.