API de traitement SaaS dans la Place de marché commerciale Microsoft

  • Article

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 :

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

Étapes suivantes

Tutoriels vidéos