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
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.
Note: You do not need to register as a developer to use Amazon MWS applications built by other software
Registering as a developer
Before you can develop Amazon MWS applications for yourself or
others you must register as a developer to get your Amazon MWS Developer ID and Developer Keys.
Important: Do Not Share Amazon MWS
Sharing your Amazon MWS Developer Keys is a
violation of Amazon’s Terms of Service. Sharing your Developer Keys may
result in suspension of your selling account and 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 and follow the
instructions on the form.
Using your Amazon MWS Developer ID and Developer
The following is an example of the Amazon MWS
Developer ID and
Developer Keys 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. Asking for a seller's own Amazon MWS developer credentials is a violation
of Amazon Terms of Service.
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 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 Secret
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 information:
- 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 behalf.