API-Einrichtung + Automatisiertes Auftragsmanagement (AOM) + Automatisierte Nutzungsberichterstattung
Teil 0: Einrichtung
WeTransact sendet Ereignisse an den Event Grid-Themenendpunkt , den Sie in den Einstellungen im WeTransact Portal konfigurieren.
3.1 API-Zugriff
Wenn Sie die Aktivierung programmatisch steuern möchten, benötigen Sie einen API-Schlüssel.
So generieren Sie einen Schlüssel:
- Gehen Sie zu Ihrem WeTransact-Portal: yourcompany.wetransact.io
- Gehen Sie zu Einstellungen → Integrationen → scrollen Sie zum Abschnitt API-Zugriff
- Klicken Sie auf Generieren
- Kopieren Sie den Schlüssel sofort und speichern Sie ihn in einem Secrets Manager

Teil 1: Automated Order Management (AOM)
1. Einführung
📖 API-Referenz: https://apidocs.wetransact.io/openapi/subscriptions
Wenn Marketplace-Herausgeber über einen automatisierten Bereitstellungsprozess verfügen, möchten die meisten von ihnen den Marketplace-Kaufkanal in diesen Prozess integrieren. Über die WeTransact Platform kann dies durch Befolgen dieser Anleitung erreicht werden.
2. Bestellprozess
Beim Verkauf über Microsoft Marketplace gibt Microsoft den Bestellablauf vor. Wenn AOM aktiviert ist, fungiert WeTransact als Middleware zwischen Microsoft Marketplace und Ihrem Auftragsverwaltungssystem.
So funktioniert es:
- Der Kunde tätigt einen Kauf → Weiterleitung zur WeTransact Landing Page
- Der Käufer klickt auf Kauf bestätigen → Bestellung wird an das WeTransact Portal gesendet
- WeTransact sendet ein CreateSubscription-Ereignis an Ihren Event Grid-Endpunkt
- Ihr System stellt das Abonnement bereit und aktiviert es
- WeTransact benachrichtigt Microsoft Marketplace zur Bestätigung der Aktivierung

Nachfolgende Lifecycle-Ereignisse — nach der Aktivierung leitet WeTransact auch diese weiter:
Ereignis | Beschreibung |
|---|---|
Kündigung | Der Kunde kündigt; der Dienst endet am Ende der Vertragslaufzeit |
Sperrung | Microsoft konnte die Zahlung nicht einziehen; ziehen Sie eine Sperrung des Dienstes in Betracht |
Wiederherstellung | Zahlung nach Sperrung eingezogen; Dienst wiederherstellen |
Verlängerung | Abonnement manuell oder über automatische Verlängerung erneuert |
Planänderung | Der Kunde hat die Tarifstufe geändert (z. B. Basic → Standard) |
Änderung der Anzahl der Benutzerlizenzen | Der Kunde hat die Anzahl der Benutzer geändert (nur Per-User-Pläne) |
3 Aktivierung des Abonnements
Publisher müssen ein Abonnement innerhalb von 30 Tagen aktivieren, andernfalls wird Microsoft es automatisch kündigen.
Es gibt drei Möglichkeiten zur Aktivierung:
Option 1 — Manuell (Portal) Gehen Sie zu Bestellungen → klicken Sie auf Maßnahmen ergreifen → genehmigen oder ablehnen.

Option 2 — Automatische Genehmigung Gehen Sie zu Produktliste → Preisplan → aktivieren Sie Neue Bestellungen automatisch genehmigen (verfügbar für alle Pläne oder einen bestimmten Plan).
Für alle Pläne

Für einen bestimmten Plan

Option 3 — Über API (empfohlen für AOM) Empfangen Sie das Ereignis CreateSubscription, schließen Sie die Bereitstellung ab und rufen Sie dann die API zur Aktivierung auf.
3.2 Aktivierung über API
| |
|---|---|
Methode | POST |
URL | https://[YOUR-SUBDOMAIN].wetransact.io/api/v1.0/subscriptions/[SUBSCRIPTION-ID]/actions/activate |
Kopfzeile | x-api-key: [YOUR API KEY] |
Antworten:
- 200 OK — erfolgreich verarbeitet
- 500 — fehlgeschlagen, kontaktieren Sie den WeTransact Support
4. Ereignisse & Nachrichten
4.1 CreateSubscription
Wird gesendet, wenn ein Abonnement erstellt wird. Enthält alles, was für die Bereitstellung und Aktivierung benötigt wird.
Feld | Typ | Beschreibung |
|---|---|---|
MarketplaceSubscriptionId | GUID | Von Microsoft zugewiesene ID. Als eindeutigen Bezeichner verwenden. |
Created | DATETIME | Zeitstempel der Subscription-Erstellung |
CompanyName | STRING | Name des kaufenden Unternehmens |
MarketplaceOfferId | STRING | Produkt-ID im Partner Center |
MarketplacePlanId | STRING | Plan-(SKU-)ID im Partner Center |
SeatQuantity | STRING (optional) | Anzahl der Seats — nur Per-User-Pläne |
TermUnit | STRING | P1M / P1Y / P2Y / P3Y |
InitialUserEmail | STRING | E-Mail des Käufers |
AdditionalDetails | STRING (optional) | Zusätzliche Landing-Page-Felder als JSON |
Channel | STRING | Direct oder Indirect (CSP) |
BeneficiaryEmail | STRING (optional) | E-Mail des Endbenutzers — unterscheidet sich vom Käufer bei CSP |
json
4.2 Subscription kündigen
Wird gesendet, wenn ein Kunde kündigt. Der Service bleibt bis zum Ende der vereinbarten Laufzeit aktiv.
Feld | Typ | Beschreibung |
|---|---|---|
MarketplaceSubscriptionId | GUID | ID des gekündigten Abonnements |
json
4.3 SuspendSubscription
Wird gesendet, wenn Microsoft keine Zahlung einziehen kann. Ziehen Sie in Betracht, den Dienst zu sperren oder den Kunden zu kontaktieren.
Feld | Typ | Beschreibung |
|---|---|---|
MarketplaceSubscriptionId | GUID | ID des gesperrten Abonnements |
json
4.4 ReinstateSubscription
Wird gesendet, wenn Microsoft nach einer Sperrung die Zahlung einzieht. Stellen Sie den Dienst wieder her, wenn er gesperrt wurde.
Feld | Typ | Beschreibung |
|---|---|---|
MarketplaceSubscriptionId | GUID | ID des wiederherzustellenden Abonnements |
json
4.5 RenewSubscription
Wird gesendet, wenn ein Abonnement manuell oder über die automatische Verlängerung erneuert wird.
Feld | Typ | Beschreibung |
|---|---|---|
MarketplaceSubscriptionId | GUID | ID des erneuerten Abonnements |
json
4.6 ChangePlan
Wird gesendet, wenn ein Kunde die Tarifstufe ändert. Aktualisieren Sie Feature-Flags, Berechtigungen oder Ressourcenzuweisungen.
Feld | Typ | Beschreibung |
|---|---|---|
MarketplaceSubscriptionId | GUID | ID des betroffenen Abonnements |
MarketplacePlanId | STRING | ID des neuen Plans (SKU) |
json
4.7 ChangeSeatQuantity
Wird gesendet, wenn ein Kunde die Anzahl der Seats ändert. Nur Per-User-Pläne. Aktualisieren Sie die Compute-/Ressourcenzuweisungen entsprechend.
Feld | Typ | Beschreibung |
|---|---|---|
MarketplaceSubscriptionId | GUID | ID des betroffenen Abonnements |
SeatQuantity | STRING | Neue Gesamtanzahl an Seats |
json
4.8 ActivateSubscriptionFailed
Wird gesendet, wenn die Aktivierung nachgelagert fehlschlägt, nachdem ein API-Aufruf 200 OK zurückgegeben hat. Kontaktieren Sie sofort den WeTransact Support.
Feld | Typ | Beschreibung |
|---|---|---|
MarketplaceSubscriptionId | GUID | ID des Abonnements, dessen Aktivierung fehlgeschlagen ist |
json
5. Nachrichtenrouting
Alle Nachrichten enthalten ein Subject-Feld zum Filtern in Ihrem Event Grid-Abonnement:
Betreff | Auslöser |
|---|---|
CreateSubscription | Neue Bestellung aufgegeben |
CancelSubscription | Kunde hat gekündigt |
SuspendSubscription | Zahlung fehlgeschlagen |
ReinstateSubscription | Zahlung geklärt |
RenewSubscription | Abonnement erneuert |
ChangePlan | Planstufe geändert |
ChangeSeatQuantity | Anzahl der Seats geändert |
ActivateSubscriptionFailed | Nachgelagerte Aktivierung fehlgeschlagen |
Teil 2: Automatisierte Nutzungsberichterstattung
Einführung
📖 API-Referenz: https://apidocs.wetransact.io/openapi/subscriptions
Einige Marketplace-Publisher müssen die Nutzung über eine API melden. Dies ist erforderlich, wenn die Berichtshäufigkeit hoch ist (mehr als einmal pro Monat). Dieser Abschnitt erklärt, wie die WeTransact API verwendet wird, um die Nutzung zu melden.
Die Meldung der Nutzung muss immer für ein aktives Abonnement erfolgen, das eindeutig durch eine GUID identifiziert wird. Sobald diese GUID erhalten wurde, kann der Publisher die Nutzung melden, indem die Mengen pro Zähler definiert werden. Die gesamte API-Dokumentation finden Sie unter:
https://apidocs.wetransact.io/openapi
Diese API-Spezifikation beschreibt alle weiteren zugehörigen API-Details, einschließlich Beispielanfragen und Antwortnachrichten. Abschnitt 7.1 erklärt, wie Sie Zugriff auf die WeTransact API erhalten.
In Schritt 1 ruft das Berichtssystem des Publishers die richtige Abonnement-ID ab (exakter Feldname: marketplaceSubscriptionId), indem zunächst alle Abonnements über den Endpunkt GET /subscriptions abgerufen werden. Um Informationen über Zähler einzuschließen, die für das Abonnement gültig sind, sollte der Abfrageparameter includeMeters=true hinzugefügt werden. Wenn die Abonnement-ID und die Zählerdetails bereits gespeichert sind, kann dieser Schritt übersprungen werden.
In Schritt 2, muss das System auf Seiten des Publishers eine Belastung für die Abonnement-ID durchführen. Dies geschieht durch Aufruf des Endpunkts POST /subscriptions/{id}/charge. Hier definiert das System die Abonnement-ID, für die die Belastung durchgeführt werden soll, sowie die Zähler-ID und den Betrag. Die WeTransact-Plattform übernimmt den Nachrichtenaustausch mit dem Microsoft Marketplace (Schritt 3).
7.1 API-Zugriff
Wenn Publisher die Nutzungsberichterstattung automatisieren möchten, wird API-Zugriff benötigt. Wenn noch kein API-Schlüssel erstellt wurde, zeigt der Abschnitt „Settings“ eine Schaltfläche „Generate“ an.