API de traitement SaaS dans la Place de marché commerciale Microsoft
Les API de traitement SaaS permettent aux éditeurs de logiciels indépendants (ISV) de publier et vendre leurs applications SaaS dans Microsoft AppSource et Place de marché Azure. Ces API permettent aux applications d’éditeurs de logiciels indépendants d’utiliser tous les canaux commerciaux : directs, gérés par des partenaires (revendeurs) et gérés par des acteurs de terrain. L’intégration avec ces API est une condition requise pour la création et la publication d’une offre SaaS dans l’espace partenaires.
Pour découvrir les API de traitement SaaS, nous vous recommandons également de lire les articles suivants :
- Gestion du cycle de vie de l’abonnement SaaS
- API d’abonnement au traitement SaaS v2
- API d’opérations de traitement SaaS v2
- Implémentation d’un webhook sur le service SaaS
- Questions courantes sur les API de traitement SaaS
Flux d’API
Les éditeurs de logiciels indépendants doivent implémenter les flux d’API suivants en les ajoutant à leur code de service SaaS pour conserver le même état d’abonnement pour les éditeurs de logiciels indépendants (ISV) et Microsoft :
- Flux de page d’accueil : Microsoft informe l’éditeur que l’offre SaaS de l’éditeur a été achetée par un client sur la Place de marché.
- Flux d’activation : Publisher informe Microsoft qu’un compte SaaS nouvellement acheté a été configuré côté éditeur.
- Flux de mise à jour : modification du plan acheté ou du nombre de sièges achetés ou les deux.
- Suspendre et rétablir le flux : suspension de l’offre SaaS achetée si le mode de paiement du client n’est plus valide. L’offre interrompue peut être rétablie lorsque le problème de mode de paiement est résolu.
- Flux de webhook : Microsoft avertit l’éditeur des modifications d’abonnement SaaS et de l’annulation déclenchées par le client côté Microsoft.
Pour l’annulation de l’abonnement SaaS acheté, l’intégration est facultative, car elle peut être effectuée par le client du côté Microsoft.
Une intégration correcte avec les API de réalisation SaaS est essentielle pour s’assurer que :
- Les clients finaux qui ont acheté l’offre SaaS de l’éditeur sont facturés correctement par Microsoft.
- Les clients finaux bénéficient de la bonne expérience utilisateur pour l’achat, la configuration, l’utilisation et la gestion des abonnements SaaS achetés sur la place de marché.
Ces API permettent aux offres de l’éditeur de participer à tous les canaux de commerce activés :
- Direct
- Géré par un partenaire (revendeur, fournisseur de solutions Cloud [CSP])
- Initiative d’un partenaire
Dans le scénario revendeur (CSP), un CSP achète l’offre SaaS au nom du client final. Un client est supposé utiliser l’offre SaaS, mais le CSP est l’entité qui effectue les tâches suivantes :
- Facture le client.
- Modifie les plans d’abonnement ou la quantité de postes achetés.
- Annule les abonnements.
Le serveur de publication n’est pas tenu d’implémenter les flux d’appels d’API différemment pour ce scénario.
Pour plus d’informations, consultez Fournisseur de solutions cloud (CSP).
Avertissement
Les API de traitement SaaS version 1 ont été déconseillées ; utilisez plutôt V2. V1 est actuellement en cours de maintenance uniquement pour traiter les éditeurs existants, et la documentation pour V1 n’est plus disponible. Si vous sentez que vous avez besoin de l’accéder, vous pouvez envoyer un e-mail saas-api-v1@microsoft.com.
Remarque
Les API de traitement SaaS sont uniquement destinées à être appelées à partir d’un service principal de l’éditeur. L’intégration avec les API directement à partir de la page web de l’éditeur n’est pas prise en charge. Seul le workflow d’authentification de service à service doit être utilisé.
Contenu connexe
- Si ce n’est déjà fait, inscrivez votre application SaaS dans le Portail Azure, comme expliqué dans Inscrire une application Microsoft Entra. Ensuite, utilisez la version la plus récente de cette interface pour le développement : API d’abonnement au traitement SaaS v2 et API d’opérations de traitement SaaS v2.
Tutoriels vidéos