Wie Sie auf dem Stripe App Marktplatz veröffentlichen
Erfahren Sie, wie Sie Ihre App für den Stripe App Marktplatz zulassen können.
Verwenden Sie diesen Leitfaden, wenn Sie eine App erstellt haben und sie öffentlich zugänglich machen möchten. Wenn Ihre App nur für Ihre eigenen Teammitglieder verfügbar sein soll, lernen Sie stattdessen, wie Sie Ihre App hochladen und installieren. In diesem Leitfaden wird beschrieben, wie Sie den Stripe App Marktplatz erreichen und wie Sie den App-Prüfungsprozess abschließen, um zu überprüfen, ob Ihre App den Stripe-App-Standards entspricht. Wenn Sie Ihre App nur auf wenigen Konten installieren möchten, lesen Sie den Abschnitt Externe Tests.
Anforderungen und Einschränkungen
- Sie müssen Ihr Konto aktivieren.
- Sie können nur eine App pro Konto veröffentlichen.
- Stripe kann nur englischsprachige Angebote unterstützen.
- Kontaktieren Sie Stripe, wenn Sie Ihre App aus dem Stripe App Marktplatz entfernen möchten.
- Ihr Geschäftszweck darf nicht unter die Verbotenen und eingeschränkten Geschäftsbereiche von Stripe fallen.
Schritte zur Veröffentlichung Ihrer App
- Aktualisieren Sie Ihr Manifest
- Bereiten Sie Ihre App vor
- Schreiben Sie Ihren Eintrag
- Submit your app for review (then wait 4 business days)
- Publish your app
Möglicherweise senden wir Ihnen eine E-Mail mit der Bitte um Änderungen an Ihrem Eintrag, bevor Sie ihn veröffentlichen können. Wenn Sie Änderungen an Ihrer App oder Ihrem Eintrag vornehmen, müssen Sie diese erneut einreichen und die Überprüfung bestehen.
Aktualisieren Sie Ihr Manifest
Legen Sie den Verteilungstyp fest
stripe apps set distribution public
Dadurch wird Ihr Manifest aktualisiert:
{ "id": "com.example.app", "version": "1.2.3", "name": "Example Tool", "icon": "./example_icon_32.png", "distribution_type": "public" }
Erforderliche Berechtigungen hinzufügen
Berechtigungen hinzufügen mit:
stripe apps grant permission "PERMISSION_NAME" "EXPLANATION"
Im Test-Modus hochladen
stripe apps upload
Wählen Sie Ihre App-Version
Wählen Sie Ihre App-Version auf der Apps-Seite im Dashboard aus.
Fügen Sie die UI-Erweiterung nur für die Nutzeroberfläche des Stripe-Dashboards hinzu.
Wenn Ihre Anwendung keine Nutzeroberfläche im Stripe Dashboard benötigt, lassen Sie das Feld ui_
in stripe-app.
leer:
"ui_extension": []
Bereiten Sie Ihre App vor
Als nächstes erstellen Sie einen Installationsprozess für Installateure auf anderen Konten.
- Wenn Sie OAuth von Drittanbietern verwenden, stellen Sie sicher, dass Ihre App von allen Drittanbietern (z.B. Google, Facebook, LinkedIn), die Sie anbieten, vollständig verifiziert und genehmigt ist. Wenn Ihre App nicht verifiziert ist, sehen Sie normalerweise eine Meldung wie “Google hat diese App nicht verifiziert”. Fordern Sie von diesen Anbietern keine Berechtigungen an, die über das hinausgehen, was Sie benötigen.
- Wenn Ihre App über eine Schaltfläche für die Kasse verfügt, leiten Sie die Installateure von Ihrer Stripe-App zu Ihrer Plattform weiter, bevor Sie zur Stripe-Kasse navigieren.
- Wenn Ihre App eine Nutzeroberfläche-Komponente hat, verwenden Sie unbedingt das Stripe design Nutzeroberfläche
- Wenn Ihre Plattform über eine Schaltfläche für die OAuth-Verbindung zu Stripe verfügt:
- Verwenden Sie den öffentlichen Installationslink zur Weiterleitung. Sie finden dies auf der Registerkarte Einstellungen (nicht über den Link zur Kanalinstallation) und der Pfad sieht wie folgt aus: https://marketplace.stripe.com/oauth/v2/athorize?client_id=$(clientId)&redirect_uri=$(redirect_uri)&state=$(state). Stripe hat die Connect Stripe-Authentifizierungsmethode eingestellt, verwenden Sie stattdessen diese OAuth-Methode.
- Bieten Sie eine Möglichkeit, die Verbindung zu Stripe zu trennen, die sichtbar wird, wenn der Installateur die App mit Stripe verbindet. Sie können diese Option zum Trennen der Verbindung entweder auf der Seite mit den App-Einstellungen oder auf einer Seite auf Ihrer Plattform (im Bereich Integration) anzeigen, auf der Nutzer/innen die Verbindung trennen und die App neu installieren können. Wenn Sie darauf klicken, muss ein Popup-Fenster mit den Schaltflächen Bestätigen und Abbrechen angezeigt werden und die App muss in einen Zustand zurückkehren, in dem der Nutzer/innen die Verbindung zu Stripe wiederherstellen kann.
Schreiben Sie Ihren Eintrag
Die Art der App bestimmt, wie Sie Ihr App-Angebot präsentieren. Es gibt zwei Haupttypen von Apps: solche mit einer Nutzeroberfläche im Stripe Dashboard und solche ohne.
Beispiel-App-Typen
Ein Beispiel für eine App mit einer Nutzeroberfläche im Stripe Dashboard ist Mailchimp. Ein Beispiel für eine App ohne Nutzeroberfläche im Stripe Dashboard ist Hubspot.
Wie Sie ein überzeugendes Angebot schreiben
Die Seite zum Einreichen von App-Einträgen besteht aus drei Hauptabschnitten:
- Im ersten Abschnitt werden das Hauptversprechen Ihrer App und das Hauptproblem, das sie für Stripe-Nutzer/innen löst, klar dargelegt.
- Der zweite und dritte Abschnitt enthalten weitere Details zu den wichtigsten Use cases Ihrer App und erläutern, wie Ihre App jeden einzelnen davon abdeckt.
Erforderliche Felder
Inhalte | Spezifikationen | Richtlinien | Beispiel |
---|---|---|---|
Name | Maximal 35 Zeichen. Darf keines der folgenden Wörter oder Namen enthalten: “Stripe”, “App”, “kostenlos” oder “bezahlt”. | Wird neben dem Logo Ihrer App im Marktplatz und auf der Seite für Ihren App-Eintrag angezeigt. Muss derselbe Name sein, der in stripe-app hochgeladen wurde. Er darf nicht die Wörter “Stripe”, “App”, “RAK”, “Generator”, “API Key”, “Authenticator”, “kostenlos” oder “bezahlt” enthalten. | EmailWorld |
Logo | Bilder müssen hochauflösend sein, mindestens 300x300 Pixel groß mit einem Seitenverhältnis von 1:1 (quadratisch), im PNG- oder JPG-Format vorliegen und kleiner als 10 MB sein. Es muss dasselbe Logo sein, das im App-Manifest verwendet wird. | Wird neben dem Namen Ihrer App auf dem App-Marktplatz und auf der Seite für Ihren App-Eintrag angezeigt. | |
Erstellt von | Maximal 80 Zeichen | Name der Einzelperson oder des Unternehmens, die/das für die Entwicklung und Wartung der App verantwortlich ist. | EmailWorld, Inc |
Kategorie | Wählen Sie die Kategorie, die Ihre App am besten beschreibt. | Wenn eine andere Kategorie besser geeignet ist, passt Stripe diese an und benachrichtigt Sie während der App-Prüfung. |
|
Untertitel | Maximal 80 Zeichen | Erscheint neben Ihrem App-Namen auf dem Marktplatz und auf Ihrer App-Seite. Dies ist eine prägnante Formulierung, die den Wert Ihrer App zusammenfasst. Vermeiden Sie die Verwendung von Schlüsselwörtern, Marketing-Jargon und Übertreibungen. | Im Strip-Dashboard können Sie die Support-Historie einer/eines Kundin/Kunden einsehen und bearbeiten. |
Über | Maximal 1.000 Zeichen. | Beschreiben Sie kurz, was Ihr Unternehmen tut, für wen Ihre Produkte bestimmt sind und welchen Mehrwert sie haben. Eine ideale Beschreibung besteht aus ein bis zwei Sätzen, die einen Überblick über Ihr Hauptprodukt oder Ihr Unternehmen insgesamt geben, gefolgt von einer kurzen Beschreibung Ihrer Stripe-App. Vermeiden Sie Übertreibungen, Marketing-Jargon, die übermäßige Nutzung von Schlagwörtern oder nicht belegbare Behauptungen (z.B. “Das beste Support-Produkt der Welt”). | EmailWorld ist ein E-Mail-Versanddienst für wachsende E-Commerce-Unternehmen. Die EmailWorld-App bringt unsere fortschrittlichen Messaging-Funktionen in Stripe, so dass Sie Ihr Publikum mit nur wenigen Klicks erreichen können. |
Funktioniert mit | Automatisch ausgefüllt | Ihr App-Manifest wird automatisch ausgefüllt, sodass Nutzer/innen wissen, mit welchen Teilen des Stripe-Dashboards Ihr App-Drawer funktioniert. |
|
Funktionen | Fügen Sie bis zu drei wichtige App-Funktionen hinzu, die bestimmte Use cases Ihrer App hervorheben. | Jede Funktion erklärt, wie die App mit Stripe interagiert und es verbessert. Verwenden Sie klare, wertorientierte Titel und hochwertige Screenshots, die keine echten Kundendaten zeigen. Achten Sie darauf, dass die Bilder von hoher Qualität und richtig zugeschnitten sind und Ihr Unternehmen nicht pauschal beschreiben. | |
Titel | Maximal 80 Zeichen | Erscheint neben Ihrer wichtigsten Funktion und Beschreibung. Dies ist ein prägnanter Satz, der den Use case für Ihre App in einfacher Sprache zusammenfasst. | Erhalten Sie per E-Mail Einblicke in die Stripe-Kunden. |
Beschreibung | Maximal 300 Zeichen. | Eine Beschreibung der Arbeitsweise der Funktion und ihrer Vorteile für die Nutzer/innen. Beschreiben Sie etwaige Einschränkungen. Fügen Sie optional eine kurze Beschreibung des Unternehmens hinzu. | Sehen Sie sich die E-Mail-Aktivitäten Ihrer Stripe-Kunden an, z. B. Öffnungen und Klicks. So können Sie beurteilen, wie gut Ihre Kampagnen zu Verkäufen führen, ohne zwischen den Registerkarten hin- und herschalten zu müssen. |
Abbildung | Hohe Auflösung mit einer Mindestbreite von 1600 Pixeln (keine Mindesthöhe) und 10 MB oder weniger, im PNG- oder JPG-Format. | Verwenden Sie das Figma UI toolkit, um ein hochwertiges Feature-Bild zu entwerfen und zu exportieren. Zeigen Sie Ihre App im Kontext des Stripe Dashboards. Verwenden Sie keine Screenshots, die echte Kundendaten oder Screenshots Ihrer App zeigen, während Sie testen. | |
Preisgestaltung | Geben Sie an, ob Ihre App kostenlos ist oder ob ein kostenpflichtiges Abonnement erforderlich ist. Die Preise müssen ohne versteckte Gebühren angegeben werden und mit den Preisen außerhalb des Marktes übereinstimmen. Bewerben Sie Ihre Dienste nicht als kostenlos und verlangen Sie dann, dass die Nutzer nach der Installation der App bezahlen. |
| |
Seite mit Preisangaben | Muss angegeben werden, wenn für Ihre App ein kostenpflichtiges Abonnement erforderlich ist. | Stellen Sie einen Link zu einer Seite mit Preisangaben zur Verfügung, auf der Ihr Preismodell für potenzielle Nutzer/innen erläutert wird. | |
Support-Kanal | 1-2 Kanäle, über die Nutzer/innen mit Ihnen in Kontakt treten können. | Geben Sie auch eine Schätzung für die Reaktionszeit an. |
|
Niederlassung in | Wählen Sie jeden Standort aus, an dem Ihr Unternehmen einen Hauptsitz hat. | Vereinigten Staaten | |
Unterstützte Sprachen | Englisch ist vorausgewählt und erforderlich. Stripe unterstützt nur Englisch. Wenn Sie weitere Sprachen unterstützen möchten, wenden Sie sich an Stripe. | Englisch | |
Datenschutzerklärung | Geben Sie einen Link zu Ihrer Datenschutzerklärung an. Dies ist eine URL, unter der Nutzer/innen die Datenschutzerklärung für Ihr Unternehmen und Ihre App lesen können. | emailworld. | |
Allgemeine Geschäftsbedingungen | Optional | Geben Sie einen Link zu Ihren Allgemeinen Geschäftsbedingungen an. Dies muss eine URL sein, unter der die Nutzer die Nutzungsbedingungen sowohl für Ihr Unternehmen als auch für Ihre App einsehen können. | |
Website des Unternehmens | Optional | Stellen Sie einen Link zur Website Ihres Unternehmens zur Verfügung. Ihre Website muss Ihren Geschäftszweck und Ihre Identität klar darstellen. | |
FAQ-Seite | Optional | Stellen Sie einen Link zur FAQ-Seite Ihrer App zur Verfügung. | |
Technische Dokumentation | Optional | Geben Sie einen Link zur Seite mit der technischen Dokumentation Ihrer App an. Die Dokumentation muss alles erklären, von der Installation Ihrer Stripe-App bis zur optimalen Nutzung der Funktionen. | |
Berechtigungen | Automatisch ausgefüllt | Ihr App-Manifest füllt dies automatisch aus. Es informiert die Nutzer/innen darüber, welche Berechtigungen die App benötigt. | |
Besondere Merkmale der Funktion | Nennen Sie 1 bis 3 zentrale Funktionen, damit Nutzer/innen schnell verstehen, was Ihre App kann. Geben Sie den Wert der Funktion in einfacher Sprache im Titel der Funktion an. Zum Beispiel: “Tickets von Stripe bearbeiten.” Verwenden Sie hochwertiges Bildmaterial, das keine echten Kundendaten zeigt. | ||
Anleitung zum Testen | Muss alle wichtigen Funktionen für die Produktionsumgebung abdecken. Denken Sie daran, den Onboarding-Ablauf mit einzubeziehen. Um die Überprüfung der App zu beschleunigen, fügen Sie Bildschirmaufzeichnungen der komplexeren Abläufe bei und kommentieren Sie die Video-Links im Video nach Bedarf. | Beispiel-Testszenario | |
Anmeldeinformationen von Testkonten | Fügen Sie ein oder mehrere Sätze von Testzugangsdaten bei, die Stripe zur Installation und Nutzung Ihrer App verwenden kann. Geben Sie Zugangsdaten für die höchste rollenbasierte Zugriffsebene in Ihrer App an, z. B. „Admin“. Stellen Sie sicher, dass die Testlinks, die Sie für die App-Prüfung bereitstellen, über die App-Installation und nicht über das Connect-Onboarding mit Stripe verbunden sind. Geben Sie detaillierte Schritte an, wie Ihre App mit Stripe verbunden wird. Deaktivieren Sie die Multi-Faktor-Authentifizierung oder geben Sie Anweisungen, wie Prüfer diese umgehen können. Wenn Ihre Testkonten bestimmte Daten zur Nutzung Ihrer App erfordern (z. B. eine CSV-Datei), müssen Sie diese mit dem Konto bereitstellen. Wenn Ihre App regionsspezifisch ist oder geografische Einschränkungen hat, geben Sie an, welche Regionen unterstützt werden und stellen Sie Testzugangsdaten für ein Stripe-Konto mit der neuesten Version Ihrer App bereit. Stripe erlaubt nicht, echte (Nicht-Test-)Konten für den App-Prüfungsprozess zu verwenden. Wenn Sie andere Möglichkeiten benötigen, uns Zugang zu einem bestimmten Konto für Testzwecke zu gewähren, wenden Sie sich bitte an den Stripe Support. | Beispiel Test-Zugangsdaten |
Beispiel für einen Testnachweis
Test-Kontoname | Nutzername | Passwort |
---|---|---|
Google Sheets | teststripeapps@stripe. | teststripeapps |
Stripe | teststripeapps@stripe. | teststripeapps |
Beispiel-Benutzerszenario für Stripe mit Google Sheets Beispiel-App
Nutzerszenario | Schritt-für-Schritt-Anleitung |
---|---|
Als Nutzer/in anmelden |
|
Daten aus Stripe in Google Sheets exportieren |
|
Submit App for review
Auf der Seite Anforderungen für die App-Überprüfung finden Sie die Qualitätsanforderungen für die Einreichung.
Die häufigsten Probleme, die wir bei der Überprüfung feststellen, sind die folgenden:
- Wenn es sich um eine Wiedervorlage mit einem App-Update handelt, stellen Sie sicher, dass Ihre Testrichtlinien alles abdecken, was neue Nutzer/innen sehen könnten.
- Vergewissern Sie sich, dass Ihre Berechtigungen im Manifest gründlich beschrieben sind und eine ausführliche Begründung für die Erteilung von Berechtigungen enthalten.
- Stellen Sie sicher, dass Links, wie z.B. die
allowed_
in derredirect_ uris stripe-app.
keine defekten oder localhost URLs sind.json - Überprüfen Sie die Qualität der Bilder und die Einhaltung der Markenkennzeichnung.
- Überprüfen Sie alle Authentifizierungsabläufe und geben Sie klare Anweisungen für die Zeit nach der Installation:
- Überprüfen Sie, ob die Testanmeldedaten korrekt sind und keine 2FA erfordern.
- Entfernen Sie hart kodierte API-Schlüssel aus der App.
- Testen Sie Funktionen sowohl in einer Sandbox als auch im Live-Modus, mit verschiedenen Nutzerrollen.
- Für OAuth-Apps: Vergewissern Sie sich, dass Sie den öffentlichen Link auf der Registerkarte Einstellungen angeben und nicht den Authentifizierungslink auf der Registerkarte Externer Test.
- Für Anwendungen mit einer Nutzeroberfläche: Vergewissern Sie sich, dass die Bilder der wichtigsten Funktionen die App-Oberfläche im Stripe Dashboard zeigen.
- Für Apps, die Checkout verwenden: Vergewissern Sie sich, dass die Zahlungslinks die Nutzer/innen zunächst über Ihre externe Zahlungsseite leiten und nicht direkt zu Stripe Checkout.
Nachdem Sie im Angebotsformular auf Senden geklickt haben, erhalten Sie innerhalb von 4 Werktagen eine E-Mail mit einer Bestätigung oder einer Rückmeldung.
Entscheidung zur App-Überprüfung und Veröffentlichung
Wenn wir Ihre App ablehnen, erhalten Sie ein detailliertes Feedback, das Ihnen hilft, die Überprüfung bei der nächsten Einreichung zu bestehen.
Nachdem Sie die Genehmigungs-E-Mail erhalten haben, gehen Sie auf die Seite Apps im Stripe Dashboard. Von dort aus können Sie eine Vorschau Ihres Eintrags anzeigen, indem Sie auf Prüfen und veröffentlichen klicken. Wenn Sie weitere Änderungen vornehmen möchten, ohne sie zu veröffentlichen, klicken Sie auf Abbrechen und bearbeiten, um Ihre App zu ändern und erneut zur Überprüfung einzureichen.
Um Ihre App auf dem Stripe App Marktplatz zu veröffentlichen, klicken Sie auf Publizieren. Die Veröffentlichung Ihrer App bedeutet:
- Jede/r Nutzer/in kann Ihre App auf dem Stripe App Marketplace entdecken.
- Jede/r Nutzer/in eines Stripe-Kontos kann Ihre App installieren und nutzen.
- Sie können App Analytics bereits 24 Stunden nach der Veröffentlichung einsehen.