Configuration de l’API + Gestion automatisée des commandes (AOM) + Rapport automatisé d’utilisation
Partie 0 : Configuration
WeTransact envoie des événements au Point de terminaison de la rubrique Event Grid que vous configurez dans Paramètres dans le portail WeTransact.
3.1 Accès API
Si vous souhaitez contrôler l’activation par programmation, vous avez besoin d’une clé API.
Pour générer une clé :
- Accédez à votre portail WeTransact : yourcompany.wetransact.io
- Accédez à Paramètres → Intégrations → faites défiler jusqu’à la section Accès à l’API
- Cliquez sur Générer
- Copiez immédiatement la clé et stockez-la dans un gestionnaire de secrets

Partie 1 : Gestion automatisée des commandes (AOM)
1. Introduction
📖 Référence API : https://apidocs.wetransact.io/openapi/subscriptions
Lorsque les éditeurs Marketplace disposent d’un processus de provisionnement automatisé, la plupart d’entre eux souhaitent connecter le canal d’achat Marketplace à ce processus. Grâce à la plateforme WeTransact, cela peut être réalisé en suivant ce guide.
2. Processus de commande
Lors de ventes via Microsoft Marketplace, Microsoft impose le flux de commande. Lorsque AOM est activé, WeTransact agit comme middleware entre Microsoft Marketplace et votre système de gestion des commandes.
Fonctionnement :
- Le client effectue un achat → redirection vers la page de destination WeTransact
- L’acheteur clique sur Confirmer l’achat → la commande est envoyée au portail WeTransact
- WeTransact envoie un événement CreateSubscription à votre point de terminaison Event Grid
- Votre système provisionne et active l’abonnement
- WeTransact informe Microsoft Marketplace pour confirmer l’activation

Événements de cycle de vie ultérieurs — après l’activation, WeTransact transmet également les événements suivants :
Événement | Description |
|---|---|
Annulation | Le client annule ; le service se termine à la fin de la période d’engagement |
Suspension | Microsoft n’a pas pu collecter le paiement ; envisagez de suspendre le service |
Rétablissement | Paiement collecté après suspension ; rétablissez le service |
Renouvellement | Abonnement renouvelé manuellement ou via le renouvellement automatique |
Changement de plan | Le client a changé de niveau de plan (par ex. Basic → Standard) |
Changement du nombre de licences | Le client a modifié le nombre d’utilisateurs (plans par utilisateur uniquement) |
3 Activation de l’abonnement
Les éditeurs doivent activer un abonnement dans les 30 jours ou Microsoft l’annulera automatiquement.
Il existe trois façons d’activer :
Option 1 — Manuel (portail) Accédez à Commandes → cliquez sur Passer à l’action → approuvez ou rejetez.

Option 2 — Approbation automatique Accédez à Liste des produits → Plan tarifaire → activez Approuver automatiquement les nouvelles commandes (disponible pour tous les plans ou un plan spécifique).
Pour tous les plans

Pour un plan spécifique

Option 3 — Via API (recommandé pour AOM) Recevez l’événement CreateSubscription, terminez le provisionnement, puis appelez l’API pour activer.
3.2 Activation via API
| |
|---|---|
Méthode | POST |
URL | https://[YOUR-SUBDOMAIN].wetransact.io/api/v1.0/subscriptions/[SUBSCRIPTION-ID]/actions/activate |
En-tête | x-api-key: [YOUR API KEY] |
Réponses :
- 200 OK — traité avec succès
- 500 — échec, contactez le support WeTransact
4. Événements et messages
4.1 CreateSubscription
Envoyé lorsqu’un abonnement est créé. Contient tout le nécessaire pour le provisionnement et l’activation.
Champ | Type | Description |
|---|---|---|
MarketplaceSubscriptionId | GUID | ID attribué par Microsoft. Utilisez-le comme identifiant unique. |
Created | DATETIME | Horodatage de création de l’abonnement |
CompanyName | STRING | Nom de l’entreprise acheteuse |
MarketplaceOfferId | STRING | ID du produit dans Partner Center |
MarketplacePlanId | STRING | ID du plan (SKU) dans Partner Center |
SeatQuantity | STRING (facultatif) | Nombre de sièges — plans Per-User uniquement |
TermUnit | STRING | P1M / P1Y / P2Y / P3Y |
InitialUserEmail | STRING | E-mail de l’acheteur |
AdditionalDetails | STRING (facultatif) | Champs supplémentaires de la Landing Page, au format JSON |
Channel | STRING | Direct ou indirect (CSP) |
BeneficiaryEmail | STRING (facultatif) | E-mail de l’utilisateur final — différent de l’acheteur via CSP |
json
4.2 Annuler un abonnement
Envoyé lorsqu’un client annule. Le service reste actif jusqu’à la fin de la période d’engagement.
Champ | Type | Description |
|---|---|---|
MarketplaceSubscriptionId | GUID | ID de l’abonnement annulé |
json
4.3 SuspendSubscription
Envoyé lorsque Microsoft ne peut pas collecter le paiement. Envisagez de suspendre le service ou de contacter le client.
Champ | Type | Description |
|---|---|---|
MarketplaceSubscriptionId | GUID | ID de l’abonnement suspendu |
json
4.4 ReinstateSubscription
Envoyé lorsque Microsoft collecte le paiement après une suspension. Réactivez le service s’il a été suspendu.
Champ | Type | Description |
|---|---|---|
MarketplaceSubscriptionId | GUID | ID de l’abonnement à réactiver |
json
4.5 RenewSubscription
Envoyé lorsqu’un abonnement est renouvelé manuellement ou via le renouvellement automatique.
Champ | Type | Description |
|---|---|---|
MarketplaceSubscriptionId | GUID | ID de l’abonnement renouvelé |
json
4.6 ChangePlan
Envoyé lorsqu’un client change de niveau de plan. Mettez à jour les indicateurs de fonctionnalités, les droits ou les allocations de ressources.
Champ | Type | Description |
|---|---|---|
MarketplaceSubscriptionId | GUID | ID de l’abonnement concerné |
MarketplacePlanId | STRING | ID du nouveau plan (SKU) |
json
4.7 Changer la quantité de sièges
Envoyé lorsqu’un client modifie le nombre de sièges. Plans par utilisateur uniquement. Mettez à jour les allocations de calcul/ressources en conséquence.
Champ | Type | Description |
|---|---|---|
MarketplaceSubscriptionId | GUID | ID de l’abonnement concerné |
SeatQuantity | STRING | Nouveau nombre total de sièges |
json
4.8 Échec de l’activation de l’abonnement
Envoyé lorsque l’activation échoue en aval après qu’un appel API a renvoyé 200 OK. Contactez immédiatement le support WeTransact.
Champ | Type | Description |
|---|---|---|
MarketplaceSubscriptionId | GUID | ID de l’abonnement dont l’activation a échoué |
json
5. Routage des messages
Tous les messages incluent un champ Subject pour le filtrage dans votre abonnement Event Grid :
Sujet | Déclencheur |
|---|---|
CreateSubscription | Nouvelle commande passée |
CancelSubscription | Annulation par le client |
SuspendSubscription | Échec du paiement |
ReinstateSubscription | Paiement résolu |
RenewSubscription | Abonnement renouvelé |
ChangePlan | Niveau de plan modifié |
ChangeSeatQuantity | Nombre de sièges modifié |
ActivateSubscriptionFailed | Échec de l’activation en aval |
Partie 2 : Rapports d’utilisation automatisés
Introduction
📖 Référence API : https://apidocs.wetransact.io/openapi/subscriptions
Certains éditeurs Marketplace ont besoin de signaler l’utilisation via une API. Cela est nécessaire lorsque la fréquence de signalement est élevée (plus d’une fois par mois). Cette section explique comment l’API WeTransact est utilisée pour signaler l’utilisation.
Le signalement de l’utilisation doit toujours être effectué sur un abonnement actif, identifiable de manière unique par un GUID. Une fois ce GUID obtenu, l’éditeur peut signaler l’utilisation en définissant les quantités par compteur. Toute la documentation de l’API est disponible à l’adresse :
https://apidocs.wetransact.io/openapi
Cette spécification API décrit tous les autres détails liés à l’API, y compris des exemples de messages de requête et de réponse. La section 7.1 explique comment obtenir l’accès à l’API WeTransact.
À l’étape 1, le système de signalement de l’éditeur récupère le bon ID d’abonnement (nom exact du champ : marketplaceSubscriptionId) en récupérant d’abord tous les abonnements via le point de terminaison GET /subscriptions. Pour inclure des informations sur les compteurs valides pour l’abonnement, le paramètre de requête includeMeters=true doit être ajouté. Si l’ID d’abonnement et les détails du compteur sont déjà stockés, cette étape peut être ignorée.
À l’étape 2, le système du côté de l’éditeur doit effectuer une facturation sur l’ID d’abonnement. Cela se fait en appelant le point de terminaison POST /subscriptions/{id}/charge. Ici, le système définit l’ID d’abonnement à facturer, ainsi que l’ID du compteur et le montant. La plateforme WeTransact se charge de l’échange de messages avec Microsoft Marketplace (étape 3).
7.1 Accès à l’API
Lorsque les éditeurs souhaitent automatiser le signalement de l’utilisation, un accès API est nécessaire. Si aucune clé API n’a été créée, la section Settings affichera un bouton Generate.