Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Notifications Amazon SNS pour les produits SaaS
**Important**
Les notifications SNS pour les produits AWS Marketplace SaaS sont remplacées par des EventBridge notifications Amazon. Si vous avez déjà intégré des produits SaaS à SNS, ils continueront à fonctionner. Les nouvelles offres finiront par passer à Amazon EventBridge plutôt qu'à SNS. Pour de plus amples informations, veuillez consulter [Gestion des événements d'abonnement SaaS avec Amazon EventBridge](saas-eventbridge-integration.md).
Pour recevoir des notifications, vous devez vous abonner aux rubriques Amazon Simple Notification Service (Amazon SNS) qui vous sont fournies lors de AWS Marketplace la création du produit. Les rubriques fournissent des notifications concernant les modifications apportées aux abonnements des clients et aux droits contractuels relatifs à vos produits. Elle vous permet de savoir quand octroyer et annuler l'accès pour des clients spécifiques.
**Note**
Au cours du processus de création du produit, vous recevrez le véritable nom de ressource Amazon (ARN) associé à la rubrique SNS. Par exemple : `arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE`
Les rubriques Amazon SNS suivantes sont disponibles pour les produits SaaS (Software as a Service) :
+ [Rubrique Amazon SNS : `aws-mp-entitlement-notification`](#saas-sns-message-body)— Cette rubrique vous informe lorsque les acheteurs créent un nouveau contrat, le mettent à niveau, le renouvellent ou expirent. Ceci n'est disponible que pour les produits dont les modèles de tarification incluent un contrat (également appelés **contrats SaaS et contrats** **SaaS avec consommation (excédents))**.
+ [Rubrique Amazon SNS : `aws-mp-subscription-notification`](#saas-sns-subscription-message-body)— Cette rubrique vous informe lorsqu'un acheteur s'abonne ou se désabonne d'un produit et inclut le drapeau pour les offres privées et un indicateur d'essai gratuit `offer-identifier` pour les essais gratuits de SaaS. Cela est disponible pour tous les modèles de tarification, y compris les contrats et les abonnements (également appelés **abonnements SaaS**, **contrats SaaS** et **contrats SaaS avec consommation (excédents)**.
Pour en savoir plus sur les scénarios dans lesquels vous répondez à ces notifications, consultez les rubriques suivantes :
+ [Intégrer votre abonnement ou Pay-As-You-Go produit SaaS avec AWS Marketplace](saas-integrate-subscription.md)
+ [Intégrer votre produit contractuel SaaS avec AWS Marketplace](saas-integrate-contract.md)
+ [Intégrer votre produit SaaS basé sur un contrat avec AWS Marketplace](saas-integrate-contract-with-pay.md)
## Rubrique Amazon SNS : `aws-mp-entitlement-notification`
Le format de chaque message de la `aws-mp-entitlement-notification` rubrique est le suivant.
```
{
"action": "",
"customer-identifier": " X01EXAMPLEX",
"product-code": "n0123EXAMPLEXXXXXXXXXXXX",
}
```
Ils le ** seront toujours` entitlement-updated`.
**Note**
Pour les messages d'autorisation, quelle que soit l'action (nouvelle action, mise à niveau, renouvellement ou expiration), le message est le même. Un appel ultérieur à `GetEntitlement` est nécessaire pour découvrir le contenu de la mise à jour.
Pour les **contrats SaaS avec consommation (excédents)**, la rubrique [`aws-mp-subscription-notification`SNS](#saas-sns-subscription-message-body) est proposée aux vendeurs. Il s'agit d'une notification supplémentaire qu'un vendeur reçoit lorsqu'il ajoute un prix excédentaire. Lorsqu'un vendeur acquiert de nouveaux clients, au lieu de se contenter d'en obtenir `entitlement-updated` (ce qui peut faire référence à n'importe quel type d'action), il reçoit un message d'abonnement indiquant qu'il s'agit d'un nouveau client.
Pour les contrats à date future (FDAs), cette rubrique est abordée à la date de début de l'accord (et non à la date de signature de l'accord). Il est également lancé lorsque des modifications ultérieures se produisent dans le droit, telles que l'annulation, le remplacement, le renouvellement ou l'expiration du contrat.
Les produits dont les prix sont contractuels (y compris les contrats avec pay-as-you-go) doivent répondre à ces messages. Pour plus d'informations sur la manière de répondre, consultez[Scénario : surveiller les modifications apportées aux abonnements des utilisateurs](saas-integrate-contract.md#saas-contract-monitor-changes).
## Rubrique Amazon SNS : `aws-mp-subscription-notification`
Le format de chaque message de la `aws-mp-subscription-notification` rubrique est le suivant.
```
{
"action": "",
"customer-identifier": " X01EXAMPLEX",
"product-code": "n0123EXAMPLEXXXXXXXXXXXX",
"offer-identifier": "offer-abcexample123",
"isFreeTrialTermPresent":"true"
}
```
Le `offer-identifier` n'est inclus dans la notification que lorsque l'action est `subscribe-success` ou`subscribe-fail`. Il n'est pas inclus dans les notifications lorsque l'action est `unsubscribe-pending` ou`unsubscribe-success`. Pour les offres créées avant janvier 2024, cet identifiant est inclus dans la notification uniquement pour les offres privées. Pour les offres créées en janvier 2024 et ultérieurement, cet identifiant est inclus dans les notifications de toutes les offres, y compris les offres privées et les offres publiques.
Pour plus d'informations sur les types d'offres, consultez la réponse de l'[DescribeEntity API](https://docs.aws.amazon.com//marketplace/latest/APIReference/work-with-private-offers.html#describe-entity) ou la visibilité de l'offre d'un accord dans le tableau de [bord des renouvellements des accords](https://docs.aws.amazon.com//marketplace/latest/userguide/agreements-renewals-dashboard.html).
**Note**
Pour [DescribeEntity l'API](https://docs.aws.amazon.com//marketplace/latest/APIReference/work-with-private-offers.html#describe-entity), si vous trouvez une facette de ciblage Compte AWS dans le compte de la règle de ciblage pour cette offre, il s'agit d'une offre privée. S'il n'existe pas Compte AWS de règle de ciblage intégrée au compte pour cette offre, il s'agit d'une offre publique.
La `isFreeTrialTermPresent` propriété indique si l'abonnement de l'acheteur est un essai gratuit. La valeur JSON de cette propriété n'est pas un type de données *booléen*. Au lieu de cela, la valeur est convertie en un type de données de *chaîne*. Pour plus d'informations, consultez la section [Essais gratuits de SaaS.](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-free-trials.html)
Elles ** varient en fonction de la notification. Les actions possibles sont les suivantes :
+ `subscribe-success`— Le `subscribe-success` message indique à quel moment le vendeur peut commencer à envoyer des relevés de mesure. Si une [offre basée sur un accord](https://docs.aws.amazon.com/marketplace/latest/userguide/private-offers-upgrades-and-renewals.html#private-offers-upgrades-and-renewals-process) est acceptée par l'acheteur, ce message est renvoyé avec la nouvelle. `offer-identifier`
+ `subscribe-fail`— Si le `subscribe-fail` message est généré, le paiement a peut-être échoué alors que l'acheteur est déjà passé de la page d'accueil SaaS du vendeur AWS Marketplace à la page d'accueil. Le vendeur doit attendre le `subscribe-success` message avant d'autoriser la consommation du produit.
+ `unsubscribe-pending`— Lorsqu'un acheteur se désabonne, un `unsubscribe-pending` message est d'abord envoyé. Cela indique que le vendeur dispose d'un temps limité (environ une heure) pour envoyer les derniers relevés de mesure avant que l'acheteur ne soit complètement annulé.
+ `unsubscribe-success`— Le `unsubscribe-success` message indique que l'annulation est terminée, après quoi aucun autre enregistrement de mesure ne sera accepté.
**Note**
Si un acheteur se désabonne puis se réabonne immédiatement avant que le `unsubscribe-success` message final ne soit envoyé, le message final ne sera pas envoyé et un `unsubscribe-success` `subscribe-success` message sera envoyé à la place.
Pour les contrats à date future (FDAs), l'`subscribe-success`action est initiée à la date de début de l'accord (et non à la date de signature de l'accord).
Les produits assortis d'un tarif d'abonnement (y compris les contrats avec pay-as-you-go) doivent répondre à ces messages. Pour plus d'informations sur la manière de répondre, consultez les rubriques suivantes :
+ [Intégrer votre abonnement ou Pay-As-You-Go produit SaaS avec AWS Marketplace](saas-integrate-subscription.md)
+ [Intégrer votre produit SaaS basé sur un contrat avec AWS Marketplace](saas-integrate-contract-with-pay.md)
## Abonnement d'une file d'attente SQS à la rubrique SNS
Nous vous recommandons de souscrire une file d'attente Amazon SQS aux rubriques SNS fournies. *Pour obtenir des instructions détaillées sur la création d'une file d'attente SQS et l'abonnement de la file d'attente à une rubrique Amazon [SQS, consultez la section Abonnement d'une file d'attente Amazon SQS à une rubrique Amazon SNS dans](https://docs.aws.amazon.com/sns/latest/dg/subscribe-sqs-queue-to-sns-topic.html) le manuel du développeur Amazon Simple Notification Service.*
**Note**
Vous ne pouvez vous abonner à des rubriques AWS Marketplace SNS qu'à partir du Compte AWS site utilisé pour vendre les produits. Vous pouvez toutefois transférer les messages vers un autre compte. Pour plus d'informations, consultez la section [Envoyer des messages Amazon SNS à une file d'attente Amazon SQS d'un autre compte dans](https://docs.aws.amazon.com/sns/latest/dg/sns-send-message-to-sqs-cross-account.html) le manuel *Amazon Simple Notification* Service Developer Guide.
### Interrogation de la file d'attente SQS pour accéder aux notifications
Une fois que vous avez inscrit votre file d'attente SQS à une rubrique SNS, les messages sont stockés dans SQS. Vous devez définir un service qui interroge en permanence la file d'attente, recherche les messages et les traite en conséquence.