Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

Deprecation Notice:

Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.

Amazon MWS Documentation

Receiving notifications

Describes how to set up a Destination to receive notifications.

To receive notifications, you must first create a Destination. Currently, notifications can only be sent to an Amazon Simple Queue Service (Amazon SQS) standard queue.

Receiving notifications from an Amazon SQS queue

To receive notifications from an Amazon SQS queue, you must first create one. You can find instructions for setting up an Amazon SQS queue at Amazon SQS.

Granting Amazon MWS permission to write to your queue

After you set up your Amazon SQS queue, you must follow these steps in order for Amazon MWS to push notifications to your queue:

  1. Log in to the Amazon Web Services (AWS) Management Console using your Amazon AWS username and password.
  2. Click SQS to open the Amazon SQS Management Console.
  3. Select the standard queue from which you want to receive notifications.
  4. Click the Permissions tab.
  5. Click Add a Permission.
  6. In the dialog that opens: set the Effect to Allow. Set the Principal to 437568002678. Set the Actions to SendMessage and GetQueueAttributes. Finally, click Add Permission to save your changes.
  7. Make note of the URL for the queue. You can find this URL from the Details pane of the queue that you selected above. This is the value you will specify in the Destination datatype.
Note: If you are using server-side encryption (SSE), then you must provide Amazon MWS access to your key using the AWS Key Management Service (KMS). Consider using the following policy:
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::437568002678:root"
      },
      "Action": [
        "kms:GenerateDataKey",
        "kms:Decrypt"
      ],
      "Resource": "*"
    }
  ]
}

See Key Management for more information.

Processing notifications from your queue

There are several important properties of Amazon SQS queues that you must understand in order to process notifications properly:

  • Amazon MWS does not support delivery to FIFO queues. You must use Amazon SQS standard queues to receive notifications.
  • Amazon SQS standard queues do not guarantee that notifications will be received in the order they were sent. Although Amazon SQS makes a best effort to deliver notifications in order, you must design your application to accept notifications in any order.
  • Amazon SQS standard queue notifications might be delivered more than once. Amazon SQS stores copies of your notifications on multiple servers. In the event that one of these servers becomes unavailable when you receive or delete a notification, the unavailable server will still have a copy of that notification and it will attempt to deliver it when the server becomes available again. Therefore, you must design your application to accept multiple copies of any given notification.

    You can determine if a notification is a duplicate of a notification you have already received by looking at the UniqueId XML element of the notification. The UniqueId XML element can be found at: /Notification/NotificationMetaData/UniqueId.

For more information about processing notifications from Amazon SQS queues, see the Amazon Simple Queue Service Developer Guide and the Amazon Simple Queue Service API Reference at the AWS Documentation portal.