Amazon SNS notifications for container products
To receive notifications, you subscribe to the AWS Marketplace Amazon Simple Notification Service (Amazon SNS) topics provided to you during product creation. The topics provide notifications about changes to customers’ subscriptions for your products. For example, you can use this to know when customers accept a private offer.
Note
During the product creation process, you'll receive the actual Amazon Resource Name (ARN)
to the SNS topic. For
example: arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE
The following Amazon SNS topic is available for container products:
-
Amazon SNS topic: aws-mp-subscription-notification – This topic notifies you when a buyer subscribes or unsubscribes to a product. This is available for hourly pricing models, including hourly and hourly with long term.
Amazon SNS topic:
aws-mp-subscription-notification
Each message in the aws-mp-subscription-notification
topic has the following
format.
{ "action": "
<action-name>
", "customer-identifier": "X01EXAMPLEX
", "product-code": "n0123EXAMPLEXXXXXXXXXXXX
", "offer-identifier": "offer-abcexample123
", "isFreeTrialTermPresent":"true" }
The <action-name>
will vary depending on the notification.
Possible actions are:
-
subscribe-success
-
subscribe-fail
-
unsubscribe-pending
-
unsubscribe-success
The offer-identifier
only appears in the notification if the offer is a
private offer.
Subscribing an Amazon SQS queue to the Amazon SNS topic
We recommend subscribing an Amazon SQS queue to the provided SNS topics. For detailed instructions on creating an SQS queue and subscribing the queue to a topic, see Subscribing an Amazon SQS queue to an Amazon SNS topic in the Amazon Simple Notification Service Developer Guide.
Note
You can only subscribe to AWS Marketplace SNS topics from the AWS account used to sell the products. However, you can forward the messages to a different account. For more information, see Sending Amazon SNS messages to an Amazon SQS queue in a different account in the Amazon Simple Notification Service Developer Guide.
Polling the SQS queue for notifications
After you subscribe your SQS queue to an SNS topic, the messages are stored in SQS. You must define a service that continually polls the queue, looks for messages, and handles them accordingly.