Tutorial: Vorgehensweise zum Vermarkten eines API-Produkts

Vorbereitende Schritte

Info zu diesem Tutorial

IBM® API Connect enthält eine Abonnement-Abrechnungsfunktion, die es API-Anbietern ermöglicht, Preispläne in ihren API-Produkten zu definieren und ihre API-Angebote zu monetarisieren. Wenn ein Produkt einen Preistarif enthält, müssen API-Konsumenten ihre Zahlungsinformationen in das eingeben, bevor sie diesen Plan abonnieren können. API Connect unterstützt die Integration mit Stripe Subscription Billing, einem unabhängigen Cloud-Dienst, der monetisierte Produktpläne, Kunden, deren Zahlungsinformationen und deren Abonnementverlauf verwaltet, um monatliche Rechnungen zu erstellen und Kunden automatisch zu belasten. Mit dieser Integration dient Stripe als Abonnementabrechnungssystem und zugleich als Zahlungsverarbeitungssystem.

Richten Sie Ihre Rechnungsressource ein

Führen Sie die folgenden Schritte aus, um eine Integrationsressource für die Stripe-Abrechnung für Ihre Provider-Organisation zu erstellen.

1. Melden Sie sich beim API-Manager an.
2. Klicken Sie auf der Start seite auf die Kachel „Ressourcen verwalten “.
   
   
3. Führen Sie auf der Seite „Ressourcen“ die folgenden Aufgaben aus.
   1. Wählen Sie im linken Bereich „Abrechnung“ aus.
   2. Klicken Sie im rechten Fensterbereich auf „Hinzufügen “.
      
      
      

      Die Seite „Abrechnungsintegration hinzufügen“ für die Stripe-Integration wird angezeigt.

4. Führen Sie auf der Seite „Abrechnungsintegration hinzufügen “ die folgenden Schritte aus.
   1. Geben Sie im Feld „Titel “ den Titel Ihrer Rechnungsintegration ein. Beispiel: My Stripe Billing.
      Hinweis: Das Feld „Name“ wird automatisch anhand des von Ihnen eingegebenen Titels ausgefüllt.
   2. Geben Sie im Feld „Publishable Key “ den Testschlüssel für Ihr Stripe-Konto ein.
   3. Geben Sie im Feld „Geheimer Schlüssel “ den Testschlüssel für Ihr Stripe-Konto ein.
      Tipp: Falls Sie noch kein Stripe-Konto haben, können Sie hier eines erstellen: https://dashboard.stripe.com/register. Rufen Sie Ihr Stripe-Dashboard auf, um Ihre Test-API-Schlüssel abzurufen. Weitere Informationen finden Sie unter https://dashboard.stripe.com/apikeys.
      Hinweis : Jedes Stripe-Konto wird mit zwei Sätzen von API-Schlüsseln geliefert, einem für Testzwecke und einem für die Produktion. Jeder Satz von API-Schlüsseln hat einen bestimmten Namensbereich für Stripe-Objekte. Test-API-Schlüssel können keine Objekte erkennen, die von Produktions-API-Schlüsseln erstellt wurden, und umgekehrt. Sie können die API-Schlüssel einer Ihrer Rechnungsintegrationen nicht mit den Schlüsseln eines anderen Kontos austauschen oder Ihre Test- und Produktionsschlüssel vertauschen, da dies API Connect daran hindern würde, die Stripe-Objekte aufzulösen, die mit den alten Schlüsseln erstellt wurden. In diesem Tutorial sollten Sie Ihre Stripe-Test-API-Schlüssel verwenden.
   
   
   
5. Klicken Sie auf Hinzufügen, um Ihre Abrechnungsintegrationsressource zu erstellen. Die My Stripe Billing -Integration wird nun als Abrechnungsressource angezeigt.
   
   

Stripe-Test-Katalog konfigurieren

Um vermarktete Produktionspläne veröffentlichen zu können, müssen Sie eine Abrechnungsintegrationsressource zu Ihrem Katalog hinzufügen. Während dieser Aktivität erstellen Sie einen neuen Katalog mit dem Namen "stripe-test", sodass Sie den Katalog am Ende des Tutorials löschen können, wenn Sie möchten.

1. Klicken Sie im API-Manager in der seitlichen Navigationsleiste auf das Symbol „Verwalten “.
2. Klicken Sie auf „Hinzufügen“ > „Katalog erstellen “ und erstellen Sie einen neuen Katalog mit dem Namen stripe-test.
3. Klicken Sie auf die Katalogkachel stripe-test und klicken Sie dann auf die Registerkarte Katalogeinstellungen. Wählen Sie Gateway-Dienste aus und stellen Sie sicher, dass der Katalog so konfiguriert ist, dass er entweder DataPower® Gateway (v5 compatible) oder DataPower API Gateway oder beide verwendet. Wählen Sie dann "Portal" und erstellen Sie ein Entwicklerportal. Wenn Sie sich nicht sicher sind, wie Sie diese Einstellungen vornehmen sollen, lesen Sie den Abschnitt „Kataloge erstellen und konfigurieren “.
4. Um die Ressource für die Abrechnungsintegration zum Katalog hinzuzufügen, wählen Sie „Abrechnung “ aus und klicken Sie anschließend auf „Bearbeiten “.
   
   
5. Wählen Sie die Ressource Meine Stripe-Abrechnung aus, die Sie zuvor erstellt haben, und klicken Sie auf Speichern.
   
   „My Stripe Billing“ ist nun als Abrechnungsintegrationsressource für den Katalog „stripe-test“ aufgeführt.
   
   

Aktivieren Sie die Zahlungsmethode "Stripe" im Entwicklerportal

Damit API-Verbraucher Produkte mit kostenpflichtigen Plänen abonnieren können, müssen Sie die Stripe-Zahlungsmethode im Entwicklerportal für den stripe-test-Katalog konfigurieren.

1. Melden Sie sich als Administrator beim Entwicklerportal an.
2. Wenn das Administrator-Dashboard nicht angezeigt wird, klicken Sie auf Verwalten, um es anzuzeigen.
3. Klicken Sie im Administrator-Dashboard auf "Erweitern ". Die Registerkarte Liste für die Seite Erweitern wird geöffnet und die Liste der installierten Module wird angezeigt.
4. Geben Sie Stripe in den Suchfilter ein, wählen Sie APIC-Vermarktung - Stripe-Integration aus und klicken Sie auf Aktivieren.
   
   Die Standardeinstellungen für das Modul „APIC Monetization Stripe Integration“ sind nun aktiviert, und Sie müssen diese Einstellungen nun bearbeiten.
5. Klicken Sie auf „Konfiguration“ > „System“ > „ IBM API Connect -Abrechnung “.
6. Ändern Sie die Auswahl im Dropdown-Menü für die Zuordnung des Abrechnungsanbietermoduls auf die neu aktivierte APIC-Monetarisierungs-Stripe-Integration (ibm_stripe_payment_method) und klicken Sie auf „Konfiguration speichern “.
   
   
7. Klicken Sie auf „Konfiguration “ > „System “ > „ IBM “ > „APIC Stripe Integration“ und geben Sie dieselben Anmeldedaten für die Stripe-Test-API ein, die Sie in Schritt 4 unter „Einrichten Ihrer Abrechnungsressource“ für die „My Stripe Billing “-Integrationsressource eingegeben haben. Klicken Sie anschließend auf „Konfiguration speichern “.
   
   Die Zahlungsmethode „Stripe“ ist nun im Entwickler portal konfiguriert.

Vermarktetes Produkt erstellen und veröffentlichen

Erstellen Sie ein Produkt, das einen Preisplan enthält, und veröffentlichen Sie das Produkt im Entwicklerportal.

1. Zuerst müssen Sie eine Test-API herunterladen, die Sie mit Ihrem Produkt verwenden können:
   • Wenn Ihr Katalog für Streifen-Tests eine DataPower Gateway (v5 compatible) verwendet, laden Sie die findbranch.txt datei auf Ihr lokales Dateisystem herunter. Benennen Sie diese Datei in findbranch.yaml um.
   • Wenn Ihr Katalog für Streifen-Tests eine DataPower API Gateway verwendet, laden Sie die findbranch_v6.txt datei auf Ihr lokales Dateisystem herunter. Benennen Sie diese Datei in findbranch.yaml um.
   Oder wenn Sie es bevorzugen, können Sie eine Ihrer eigenen APIs verwenden.
2. Um die API in den API-Manager zu importieren, klicken Sie in der seitlichen Navigationsleiste auf das Symbol „Entwickeln“ und anschließend auf „Hinzufügen“ > „API“ (aus REST, GraphQL oder SOAP).
   
   
3. Stellen Sie sicher, dass „ OpenAPI “ ( 2.0 ) ausgewählt ist, wählen Sie dann im Abschnitt „Import“ die Option „Existing“ ( OpenAPI ) aus und klicken Sie auf „Next“ (Weiter ).
   
   
4. Klicken Sie auf Drag and drop files here or click to upload, und wählen Sie die Datei findbranch.yaml auf Ihrem lokalen Dateisystem aus, um sie hochzuladen. Klicken Sie dann auf „Weiter “.
   
   
5. Lassen Sie die Option API aktivieren nicht aktiviert, da Sie die API aktivieren, wenn Sie das monetarisierte Produkt später in diesem Abschnitt veröffentlichen. Klicken Sie auf „Weiter“, um fortzufahren.
6. Die Seite „Zusammenfassung“ wird angezeigt und bestätigt, dass die API-Definition generiert wurde.
   
   
7. Klicken Sie auf „API bearbeiten“, um Ihre generierte API-Definition anzuzeigen, und klicken Sie anschließend in der seitlichen Navigationsleiste auf das Symbol „Entwickeln“, um mit der Erstellung eines monetarisierten Produkts fortzufahren. Die „ FindBranch “-API sollte nun in Ihrer API-Liste angezeigt werden – falls dies nicht der Fall ist, klicken Sie einfach auf das Symbol „Aktualisieren“, um Ihren Browser zu aktualisieren.
8. Klicken Sie auf „Hinzufügen“ > „Produkt“
   
   
9. Wählen Sie "Neues Produkt" aus und klicken Sie auf "Weiter ".
10. Geben Sie FindBranches in das Feld „Titel“ ein und klicken Sie auf „Weiter “.
    
    
11. Wählen Sie die FindBranch-API, die Sie importiert haben, oder Ihre eigene API aus und klicken Sie auf Weiter.
12. Akzeptieren Sie die Standardwerte für Pläne und klicken Sie auf Weiter. Sie fügen später einen kostenpflichtigen Tarif hinzu.
    
    
13. Übernehmen Sie auch die Standardeinstellungen für „Veröffentlichen“, „Sichtbarkeit “ und „Abonnierbarkeit“ und klicken Sie auf „Weiter “.
    
    
14. Die Übers ichtsseite wird angezeigt und bestätigt, dass das neue Produkt angelegt wurde.
    
    
15. Klicken Sie auf Produkt bearbeiten, um die Konfiguration fortzusetzen.
16. Wenn die Registerkarte „Design“ ausgewählt ist, klicken Sie im Navigationsmenü auf „Pläne “.
    
    
17. Wählen Sie im Abschnitt Billing-Integration die Option my-stripe-billing als Abrechnungsintegrationsressource aus.
18. Klicken Sie im Abschnitt Pläne auf Hinzufügen , um einen neuen Plan mit Preisgestaltung zu erstellen.
19. Geben Sie einen Titel für den neuen Plan ein, zum Beispiel Gold, aber lassen Sie das Kontrollkästchen Genehmigung nicht ausgewählt.
20. Ändern Sie die Umschaltfläche auf Ein für Planpreisgestaltung und der Definitionsabschnitt Planpreisgestaltung wird angezeigt.
21. Wählen Sie Include free trial days(kostenlose Testtage einschließen) aus und lassen Sie den Standardwert 1 für die Anzahl der Testtage, dass ein Subskribent den Plan ohne Gebühren verwenden kann, nach dem der Abrechnungszyklus beginnt.
22. Behalten Sie auch hier die Standardeinstellungen bei: USD - US Dollar für die Währung und 10 für den monatlichen Preis, der dem Abonnenten in Rechnung gestellt wird.
    
    
23. Ändern Sie im Abschnitt Planratenbegrenzungen die Aufrufe auf 1000 pro Stunde, um diesen Plan aus dem Standardplan zu unterscheiden. Klicken Sie auf „Speichern“, um den neuen Preisplan zu speichern.
    
    
24. Jetzt können Sie das monetarisierte Produkt im „stripe-test“-Katalog veröffentlichen, indem Sie auf das Options symbol für das Produkt klicken und dann auf „Veröffentlichen“ klicken.
    
    
25. Stellen Sie sicher, dass der Katalog stripe-test ausgewählt ist, und klicken Sie dann auf Veröffentlichen.
26. Sie können überprüfen, ob das Produkt „ FindBranches “ nun veröffentlicht ist, indem Sie in der seitlichen Navigationsleiste auf das Symbol „Verwalten“ klicken und die Kachel „stripe-test“ auswählen. Das Produkt „ FindBranches “ ist nun unter dem Reiter „Produkte“ aufgeführt.
    
    
    Tipp: Denken Sie daran, auf das Symbol „Aktualisieren“ zu klicken, falls das Produkt nicht angezeigt wird.

Veröffentlichung in Ihrem Stripe-Account überprüfen

Sie können überprüfen, ob die Produktpläne in Ihrem Stripe-Account veröffentlicht wurden, indem Sie die folgenden Schritte ausführen.

1. Melden Sie sich bei Ihrem Stripe-Testaccount an.
2. Wählen Sie in der Entwicklernavigation "Events" aus.
3. Überprüfen Sie, ob Ereignisse erstellt wurden, als Sie die Produktpläne veröffentlicht haben.

Das monetarisierte Produkt im Entwicklerportal anzeigen

Sie können überprüfen, ob das monetarisierte Produkt jetzt im Entwicklerportal sichtbar ist, indem Sie die folgenden Schritte ausführen.

1. Öffnen Sie das Entwicklerportal für den Streifen-Testkatalog in Ihrem Webbrowser. Sie müssen sich nicht anmelden.
2. Auf der Startseite sollte das Produkt „ FindBranches “ angezeigt werden.
   
   
3. Klicken Sie auf die Kachel FindBranches, und die Pläne werden angezeigt, wobei sowohl die Standard-als auch die Gold-Pläne angezeigt werden. Sie können die Preisinformationen für den Gold-Plan anzeigen. Wenn Sie den Mauszeiger über den Text 2 ratenbegrenzungen bewegen, können Sie die Details der Ratenbegrenzung anzeigen. Ein API-Nutzer kann diesen monetarisierten Tarif nun abonnieren.
   
   

Die Themen dieses Tutorials

In diesem Tutorial haben Sie erfolgreich ein monetisiertes Produkt erstellt und veröffentlicht, das für API-Konsumentenabonnements bereit ist. Sie haben die folgenden Aktivitäten abgeschlossen:

• Eine Integrationsressource für die Stripe-Abrechnung erstellt.
• Einen stripe-test-Katalog konfiguriert.
• Aktivierte Stripe im Entwicklerportal.
• Ein vermarktetes Produkt erstellt und veröffentlicht.
• Die Veröffentlichung in Ihrem Stripe-Account überprüft.
• Das monetarisierte Produkt im Entwicklerportal angesehen.