HomeDocumentationCode SamplesAnnouncementsModelsRelease NotesFAQGitHubVideos
Developer HubAPI StatusSupport
Documentation
Developer HubAPI StatusSupport

SP-API General FAQ

Frequently asked questions for SP-API.

Accounts

Do I need a Professional Selling Account to register as a Selling Partner API developer?

Select to expand the answer.

Yes, only Professional Selling Accounts can register to develop or integrate with Selling Partner API. Individual accounts are not eligible. You can upgrade your account to a professional plan at any time. You can view your selling plan type and the marketplace information under Your Services in Account info. Vendors can register as private developers on Vendor Central. For more information, refer to Registering as a developer.

Do I need to have a professional selling account to use Sandbox endpoint?

Select to expand the answer.

Yes, Making sandbox calls to the SP-API is identical to making production calls except you direct the calls to the SP-API sandbox endpoints. Calling the sandbox endpoints returns static, mocked responses for all Selling Partner APIs. Sandbox endpoint allows you to test your applications without affecting production data or triggering real-world events. Vendors can register as private developers on Vendor Central. For more information, refer to Registering as a developer.

Will updating my developer profile affect existing applications or roles?

Select to expand the answer.

No. When you submit changes to update a developer profile, a new case will be created. Depending on the feedback you get on the case, you will need to update/modify your profile by the due date provided in the reply.

After I update my developer profile, how long does it take to complete review?

Select to expand the answer.

Review usually takes at least two weeks. If you don’t have restricted (PII) roles and are applying to them for the first time, review will take longer. Amazon needs to review the restricted (PII) roles with the latest ADP, which is frequently updated.

Authorization

Why is the Confirm button not working when I test the Authorization Workflow?

Select to expand the answer.

For the Authorization workflow to work correctly (in both the Amazon Selling Partner Appstore and Website workflows), the SP-API application must include both the OAuth Login URI and Redirect URI details. Failure to add information for either of these fields results in the Confirm button not working.

Why is the MWS auth token not returned with spapi_oauth_code during OAuth workflow process for a hybrid application?

Select to expand the answer.

When you authorize your own seller account using the OAuth workflow process, no MWS Auth Token is returned.

What are the Login and Redirect URI values to be added in OAuth information when I am registering my app?

Select to expand the answer.

The OAuth Login URI defines the login page of your website during authorization. This URI is shown after a seller consents to authorize your application.

The OAuth Redirect URI is used to redirect the browser to your application after authorization. You can specify more than one redirect by including the redirect_uri parameter in the OAuth URL. If the redirect_uri parameter is not specified, it will default to the first OAuth Redirect URI you’ve defined.

Note: OAuth Redirect URI does not support localhost: URIs. You must specify both the OAuth Login URI and the OAuth Redirect URI to successfully save them to your App registration.

When will the refresh token expire?

Private developers select to expand the answer. The refresh token does not expire.
Public developers select to expand the answer. The refresh token expires after one year.

Can we get the expiration date of refresh tokens through SP-APIs?

Select to expand the answer.

No. However, sellers will receive an email with a reminder to re-authorize their SP-API app 30 days before the expiration.

How is a publication application for sellers authorized?

Select to expand the answer.

You can implement OAuth authorization with either the Selling Partner Appstore authorization workflow or the Website authorization workflow.

Publishing and editing applications

How do I publish my application? How long will the process take?

Select to expand the answer.

The process to publish your application:

  1. Access Developer Central.
  2. For the existing app to be updated, select Create listing from the pull down list Edit App for the app you want to list.
  3. Enter the app info.
  4. Submit your app.

Note: It usually takes more than two weeks to complete the whole process and publish the app.

I want to update an application that is already published. If I submit the application with updated information, does it affect the existing one?

Select to expand the answer.

No. The existing application will not be affected during the publishing process. After the changes are approved and published, the new version will display to customers.

General questions

Can I still integrate with Amazon Marketplace Web Service (MWS)?

Select to expand the answer.

No. As of May 2024, we have shut off all usage of MWS for selling on Amazon. You can no longer use MWS Access Keys in apps. For more information on the MWS to SP-API migration, refer to the July 2022 MWS deprecation announcement.

How do I use multiple redirect URIs?

Select to expand the answer.

When a selling partner signs in to your website (Step 3 in the Selling Partner Appstore authorization workflow), your application loads the Amazon callback URI into the browser and adds the redirect URI, the amazon_state parameter, and the state parameter.

To use multiple redirect URIs for your app, you must add the OAuth Redirect URIs when you register your app. Note that both the OAuth Login URI and the OAuth Redirect URI(s) values must be specified to successfully save them to your app registration. OAuth Redirect URI does not accept localhost: URIs.

When your app is configured with multiple redirect URIs, pass the redirect URI that you want to use as a query parameter in Step 3 in the Selling Partner Appstore authorization workflow. If you do not include the redirect_uri parameter, the default is the first OAuth Redirect URI you specified when you registered your application.

Does Amazon provide a client library for Ruby/PHP?

Select to expand the answer.

No. Amazon does not support a client library for Ruby/PHP.

Which version should I use when there are multiple versions of the same API?

Select to expand the answer. We recommend to using the latest version. The latest versions account for earlier technical issues and older versions are deprecated accordingly.

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.