Afficher en anglais

Partage via

APIs de traitement SaaS dans le marketplace commercial de Microsoft

  • Article

Les API de traitement SaaS permettent aux éditeurs, également appelés éditeurs de logiciels indépendants (ISV), de publier et de vendre leurs applications SaaS dans Microsoft AppSource, la Place de marché Azure et le portail Azure. Ces API permettent aux applications ISV de participer à tous les canaux activés pour le commerce : direct, animés par des partenaires (revente) et animés par le terrain. L’intégration à ces API est requise pour la création et la publication d’une offre SaaS transactionnelle dans l’Espace partenaires.

Pour en savoir plus sur 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 ajoutant dans leur code de service SaaS pour conserver le même état d’abonnement pour les éditeurs de logiciels indépendants 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 de 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é, du nombre de sièges achetés, ou des deux.
  • suspendre et rétablir le flux: suspendre l’offre SaaS achetée si le mode de paiement du client n’est plus valide. L’offre suspendue peut être rétablie lorsque le problème avec le mode de paiement est résolu.
  • Flux webhook : Microsoft informe l’éditeur des modifications et annulations d’abonnement SaaS 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 côté Microsoft.

L’intégration correcte avec les API de traitement SaaS est essentielle pour vous assurer que :

  • Les clients finaux qui ont acheté l’offre SaaS de l’éditeur sont facturés correctement par Microsoft.
  • Les clients finaux obtiennent l’expérience utilisateur appropriée lors de l’achat, de la configuration, de l’utilisation et de 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 activés pour le commerce :

  • Direct
  • Géré par un partenaire (revendeur, fournisseur de solutions cloud [CSP])
  • Sur le terrain

Dans le scénario de revendeur (CSP), un fournisseur csp achète l’offre SaaS pour le compte du client final. Un client doit utiliser l’offre SaaS, mais le fournisseur de solutions Cloud est l’entité qui effectue les tâches suivantes :

  • Facture le client
  • Modifier les plans d’abonnement/quantité de sièges 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).

Important

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 pensez avoir besoin d'y accéder, vous pouvez envoyer un e-mail à saas-api-v1@microsoft.com.

Remarque

Les API de traitement SaaS sont destinées uniquement à ê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 flux d’authentification de service à service doit être utilisé.

Contenu connexe

didacticiels vidéo