Zum Hauptinhalt springen

Stripe-Einrichtung

Die Verbindung Ihres Stripe-Kontos mit Envoix ist essenziell für den automatischen Abgleich Ihrer Transaktionen. Sie haben zwei Hauptoptionen, um diese Verbindung herzustellen: über OAuth oder mittels eines API-Schlüssels.

1. Verbindung via OAuth (Empfohlen)

Die OAuth-Verbindung ist der einfachste und sicherste Weg, Ihr Stripe-Konto zu verknüpfen. Wir empfehlen diese Methode, wenn:

  • Sie eine einfache und schnelle Einrichtung wünschen.
  • Sie keine Erfahrung mit der Erstellung und Verwaltung von API-Schlüsseln haben.
  • Ihr Stripe-Konto noch nicht mit anderen Anwendungen über API-Schlüssel verbunden ist. Siehe auch Hinweise.

So funktioniert's:

  1. Im Envoix-Dashboard wählen Sie die Option zur Verbindung via OAuth.
  2. Sie werden sicher zu Stripe weitergeleitet, wo Sie sich anmelden und Envoix die Berechtigung erteilen, auf die notwendigen Daten zuzugreifen.
  3. Nach erfolgreicher Autorisierung werden Sie automatisch zu Envoix zurückgeleitet, und Ihr Stripe-Konto ist verbunden.

Hinweise

Stripe erlaubt nur einer App den Zugriff auf den Stripe Account, via OAuth:

"Starting in July 2021 […] In addition, Stripe will begin to enforce a single platform connection policy: Only one Platform can be connected to a platform-controlled Stripe account at any one time."

Ob ihr Account betroffen ist, sehen Sie, wenn Sie versuchen, eine Verbindung aufzubauen. Wird ihr Account unter "ineligible-accounts" gelistet, erstellen Sie bitte einen API-Schlüssel.

Ein Beispiel, für Accounts, die nicht verbunden werden können, sehen Sie hier:

stripe-ineligible-accounts

2. Verbindung via API-Schlüssel

Die Verbindung über einen API-Schlüssel ist notwendig, wenn Ihr Stripe-Konto bereits mit einer anderen Anwendung verbunden ist, die ebenfalls einen API-Schlüssel nutzt. In solchen Fällen kann die OAuth-Verbindung zu Konflikten führen.

Wichtiger Hinweis: Für die Verbindung via API-Schlüssel benötigen Sie einen beschränkten API-Schlüssel mit spezifischen Berechtigungen, um die Sicherheit Ihrer Daten zu gewährleisten.

So funktioniert's:

  1. Erstellen Sie in Ihrem Stripe-Dashboard einen neuen, beschränkten API-Schlüssel mit den erforderlichen Berechtigungen.
  2. Kopieren Sie den generierten API-Schlüssel.
  3. Fügen Sie den API-Schlüssel im entsprechenden Feld in Ihrem Envoix-Dashboard ein.
  4. Envoix validiert den Schlüssel umgehend. Nach erfolgreicher Validierung ist Ihr Stripe-Konto verbunden und in Envoix sichtbar.

Unabhängig von der gewählten Methode ist Ihr Stripe-Konto nach erfolgreicher Einrichtung in Envoix ersichtlich und bereit für den Datenabgleich.