Notifications Amazon SNS pour les produits SaaS

Pour recevoir des notifications, vous devez vous abonner aux rubriques AWS Marketplace Amazon Simple Notification Service (Amazon SNS) qui vous ont été fournies lors de 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. Exemples :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— 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— 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égrez votre produit d'abonnement SaaS

• Intégrez votre produit contractuel SaaS

• Intégrez votre contrat SaaS au pay-as-you-go produit

Rubrique Amazon SNS : aws-mp-entitlement-notification

Le format de chaque message de la aws-mp-entitlement-notification rubrique est le suivant.

{
    "action": "<action-name>",
    "customer-identifier": " X01EXAMPLEX",
    "product-code": "n0123EXAMPLEXXXXXXXXXXXX",
}

Ils le <action-name>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-notificationSNS 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 accords à date future (FDA), 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, consultezScénario : surveiller les modifications apportées aux abonnements des utilisateurs.

Rubrique Amazon SNS : aws-mp-subscription-notification

Le format de chaque message de la aws-mp-subscription-notification rubrique est le suivant.

{
    "action": "<action-name>",
    "customer-identifier": " X01EXAMPLEX",
    "product-code": "n0123EXAMPLEXXXXXXXXXXXX",
    "offer-identifier": "offer-abcexample123",
    "isFreeTrialTermPresent":"true"
}

Il offer-identifier n'apparaît dans la notification que s'il s'agit d'une offre privée.

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.

Elles <action-name>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.

• 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 (FDA), l'action de réussite de l'abonnement est lancé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égrez votre produit d'abonnement SaaS

• Intégrez votre contrat SaaS au pay-as-you-go produit

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 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 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.