How it works

With your instance deployed, simply redirect users to:

https://YOUR_HANDSHAKE_INSTANCE_URL/auth/HANDLER_ID/redirect

Where HANDLER_ID is either amazon-seller or the value passed to the optional id argument of the AmazonSeller() factory. (See Usage below.)

Handshake will take the user through the Amazon Seller Central OAuth flow and redirect them back to the URL specified by the callback_uri query parameter.

Usage

Modify your app/options.ts file to include the AmazonSeller() handler like so:

app/options.ts

import { HandshakeOptions, Amazon } from "handshake";
 
const options: HandshakeOptions = {
  handles: [
    Amazon({
      appId: string,
      clientId: string,
      clientSecret: string,
      isDraftApp: true | false,
    });
  ],
  // ...
};

Consult the reference to learn about HandshakeOptions.

Troubleshooting

Need to "set up your “Authorize” buttons so that selling partners are redirected to the Seller Central (for sellers) or Vendor Central (for vendors) sign-in page for their own region."

No localhost redirect

Amazon does not allow setting localhost as a redirect_uri . You may want to use Ngrok or another service to provide a publicly addressable URL.

https://github.com/amzn/selling-partner-api-docs/issues/26

Error Code: MD5101

This means unauthorized redirect URI. localhost URIs are allowed.

Developer Central – "You do not have permissions to view this page"

FYI. Only the primary user of the Seller Central account is able to create and modify apps via the "Developer Central" page.

https://github.com/amzn/selling-partner-api-docs/issues/2191

Not setup for OAuth

Error shows up when OAuth hasn't been enabled for application

–

Having an issue not included here? Open an issue in our Github repo to get help from our team.