Amazon Marketplace Web Service (Amazon MWS)
is a secure environment that uses
signatures for authentication and lets sellers delegate calling rights to developers
by using the Amazon MWS
authorization service. Before
you can develop Amazon MWS
applications for yourself or
others you must register as a developer on the User
page in Seller Central. See Registering as a developer
. To be eligible
to register for Amazon MWS
, you must have a
Professional selling plan. For more information, see Selling plans
in the Seller Central Help.
Registering as a developer
Before you can develop Amazon MWS applications for
yourself or others you must register as a developer.
To register as a developer
- Go to the User
Permissions page in Seller Central and log into
your Amazon seller account as the primary user.
- In the Amazon MWS Developer Permissions section, click
the Register as a developer button.
- Fill out the Register as a developer form.
Be sure to click
the Verify button to verify email addresses that you
- Click the Sign up button.
Your Developer ID
- Click Your developer credentials - Do no share these.
AWS Access Key ID and Secret Key appear.
You can access your Developer ID and developer credentials at any time on the
Permissions page in Seller Central.
Using your Developer ID and developer credentials
The following is an example of the Developer ID and developer credentials that
you receive when you register as a developer:
- Developer ID (a 12-digit identifier): 1234-3214-4321
- AWS Access Key ID (a 20-character, alphanumeric identifier):
- Secret Key (a 40-character identifier):
If you are developing an Amazon MWS web
application for sellers or are providing Amazon MWS-related development services to sellers, you must provide your Developer ID
to those sellers so that they can authorize you to access their Amazon seller
accounts using Amazon MWS.
If you are
developing an Amazon MWS
desktop application, do
not embed your credentials in the application. Instead, have the users of your
application register as a developer to get their developer credentials. Users of
your desktop application should use their own developer credentials when
submitting requests to Amazon MWS
. For more
information, see I have developed a
desktop application. How do sellers use it?
The AWS Access Key ID is associated with your Amazon MWS registration. You include it in all Amazon MWS requests to identify yourself as the
sender of the request. The AWS Access Key ID is not a secret. To provide proof
that you truly are the sender of the request, you must also include a digital
signature. For all requests except those generated using the Amazon MWS client libraries, you calculate the
signature using your Secret Key. Amazon uses the AWS Access Key ID in the
request to look up your Secret Key and then calculates a digital signature with
the key. If the signature Amazon calculates matches the signature you sent, the
request is considered authentic. Otherwise, the request fails authentication and
is not processed.
Important: Your Secret Key is a secret that only you and Amazon should
know. It is important to keep it confidential to protect your account. Never
include your Secret Key in your requests to Amazon MWS, never embed it in a desktop
application, and never e-mail it to anyone. Never share it with anyone, even if
they claim to be from Amazon. No one from Amazon will ever ask you for your
Resetting your AWS Access Key ID and Secret Key
If you need to change your AWS Access Key ID and Secret Key, contact Seller
Support in your home marketplace via chat, telephone, or
Contact Amazon MWS
form and ask to reset your AWS Access
Key ID and Secret Key. If you use the form, provide the following
- For Subject, enter "Reset access keys to my Amazon MWS account".
- For Your comment, enter "Please reset the AWS Access Key ID and
Secret Key for my account."
You will receive a reply from the Seller Support team with a link to the User
Permissions page on Seller Central, where
you can generate a new key pair for your account. Only administrators can use
the link to create new keys.
Note: When Seller Support deletes your key pair,
all applications that use your current keys will be denied access to your
account information until you update those applications with your new
Authorizing a developer
A seller must authorize a developer to make calls to Amazon MWS on the seller's behalf.
For a seller to authorize a developer
- The developer must be a registered Amazon MWS
developer. See Registering as a developer.
- The developer gives their Developer ID to the seller.
- The seller goes to the User
Permissions page in Seller Central and
logs into their Amazon seller account as the primary user.
- The seller clicks the Authorize a developer
- In the Developer name text box, the seller enters the
name of the developer that they are authorizing. This doesn't need to be the
exact name; it is merely for the seller's reference in the future.
- In the Developer ID text box, the seller enters the
Developer ID that the developer gave them in Step 2, and then clicks the
Authorize developer button.
The seller's MWS Auth Token appears.
- The seller gives their Seller ID and MWS Auth Token to the developer so the developer
can make calls to Amazon MWS on the seller's