Stripe

Verbinden Sie Stripe mit einem schreibgeschützten eingeschränkten Schlüssel und fügen Sie dann einen Webhook hinzu, damit neue Zahlungen sofort erscheinen.

RevGlance liest Ihr Stripe-Konto über die API von Stripe mit einem Schlüssel, den Sie erstellen. Es liest Zahlungen, Rückerstattungen, Gebühren, Anfechtungen und Abonnements und belastet, erstattet oder ändert nie etwas.

Bevor Sie beginnen

Sie müssen Inhaber oder Administrator des Unternehmens in RevGlance sein. Betrachter können keine Quellen hinzufügen.
Verwenden Sie einen eingeschränkten Schlüssel statt Ihres geheimen Schlüssels. RevGlance akzeptiert beide (rk_… oder sk_…), aber ein eingeschränkter Schlüssel kann nur lesen, was Sie erlauben.
Schlüssel aus dem Testmodus funktionieren auch, praktisch für einen ersten Blick. Verbinden Sie eine zweite Quelle mit Ihrem Live-Schlüssel, wenn Sie so weit sind.

Verbinden

Öffnen Sie im Stripe Dashboard Developers › API keys und wählen Sie Create restricted key. Nennen Sie ihn RevGlance.
Geben Sie ihm Read-Zugriff auf Balance, Charges, Customers, Disputes, Invoices, Checkout Sessions, Subscriptions und Coupons. Lassen Sie alles andere auf None.
Erstellen Sie den Schlüssel und kopieren Sie ihn. Er beginnt mit rk_live_.
Fügen Sie ihn unter Eingeschränkter Schlüssel ein und wählen Sie Stripe verbinden. Die erste Synchronisierung liest Ihre gesamte Historie.

Was das Formular abfragt

Feld	Sieht so aus
Eingeschränkter SchlüsselVerschlüsselt gespeichert	`rk_live_…`

Das Feld Name ist optional. Damit unterscheiden Sie zwei Stripe-Konten in einem Unternehmen.

Den Webhook hinzufügen

Ohne Webhook synchronisiert RevGlance Stripe stündlich. Mit einem Webhook stellt eine neue Zahlung, Rückerstattung oder Kündigung innerhalb von Sekunden eine Synchronisierung in die Warteschlange.

Öffnen Sie in RevGlance Einstellungen › Quellen, suchen Sie die Stripe-Quelle, öffnen Sie ihr Menü und wählen Sie Webhook. Kopieren Sie die URL.
Öffnen Sie in Stripe Developers › Webhooks und fügen Sie einen Endpunkt mit dieser URL hinzu.
Wählen Sie die Ereignisse aus, die Ihre Zahlen verändern: charge.succeeded, charge.failed, charge.refunded, charge.dispute.closed, customer.subscription.created, customer.subscription.updated, customer.subscription.deleted und invoice.paid. Jedes Ereignis funktioniert: Jedes startet einfach eine Synchronisierung.
Kopieren Sie das signing secret des Endpunkts (whsec_…), fügen Sie es in RevGlance unter Signing Secret ein und speichern Sie.

Was RevGlance synchronisiert

Saldotransaktionen: jede Zahlung, Rückerstattung, Anfechtung und Stripe-Gebühr, in der Währung, in der Stripe sie abgerechnet hat.
Fehlgeschlagene Zahlungen, für die Kennzahl fehlgeschlagener Zahlungen und für Zurückholen.
Abonnements jedes Status, mit Kunde, Positionen, Rabatten und letzter Rechnung, für MRR, Pläne, Testphasen und Kündigungen. Der Kündigungsgrund von Stripe und der Kommentar des Kunden kommen mit, wenn Stripe sie hat.

Die erste Synchronisierung liest Ihre gesamte Historie. Danach liest jede Synchronisierung ab drei Tagen vor der letzten, damit späte Änderungen erfasst werden, und Abonnements werden jedes Mal vollständig gelesen.

Wie Stripe gezählt wird

Zahlungen, Rückerstattungen und Stripe-Gebühren stammen aus Ihren Saldotransaktionen, in der Währung, in der Stripe sie abgerechnet hat.
Kartenrückerstattungen zählen an dem Tag, an dem Stripe sie verbucht. Bankzahlungen (ACH, SEPA und andere lokale Methoden) zählen ebenfalls; eine Rückerstattung, die die Bank zurücksendet, senkt Ihre Rückerstattungen wieder.
Eine Anfechtung zählt als Rückerstattung, sobald Stripe das Geld zurückholt, und die Rückerstattung entfällt, wenn Sie gewinnen. Die Anfechtungsgebühr von Stripe wird als Gebühr erfasst.
Gutscheine auf das Abonnement und auf einzelne Positionen werden vom MRR abgezogen. Ein Gutschein mit festem Betrag zählt nur in seiner eigenen Währung.
Pausierte und unbezahlte Abonnements zählen als Abwanderung; ein überfälliges zählt weiter, solange Stripe die Karte erneut belastet.
Zahlungen, Rückerstattungen und Anfechtungen zählen vor Steuern, im Steueranteil ihrer Rechnung oder Checkout Session. Ohne Lesezugriff auf Checkout Sessions bleibt die Steuer auf Verkäufe außerhalb einer Rechnung enthalten.
Ein Bruttopreis zählt im MRR vor Steuern, im Steueranteil der letzten Rechnung.
Das Pausieren des Zahlungseinzugs zählt als Abwanderung ab dem Tag, an dem RevGlance es zum ersten Mal sieht, weil Stripe es nicht datiert.

Unter So zählen wir finden Sie die Regeln, die für jeden Anbieter gelten.

Rückhol-E-Mails

Zurückholen verlinkt eine fehlgeschlagene Abo-Zahlung mit ihrer offenen Rechnungsseite in Stripe, wo der Kunde mit einer neuen Karte bezahlen kann. Gibt es keine offene Rechnung, öffnet es stattdessen eine Sitzung im Stripe-Kundenportal. Dieser Ausweichweg setzt voraus, dass das Portal in Stripe aktiviert ist und der Schlüssel Customer portal-Sitzungen schreiben darf; ohne das verlinkt die E-Mail auf Ihre eigene Seite zum Aktualisieren der Karte.

Fehlerbehebung

„Fügen Sie einen geheimen oder eingeschränkten Stripe-Schlüssel ein.“ Der Schlüssel muss mit rk_ oder sk_ beginnen. Ein veröffentlichbarer Schlüssel (pk_) kann nichts lesen.
„Stripe refused that key.“ Der Schlüssel wurde widerrufen oder hat keinen Lesezugriff auf Balance.
„Stripe refused the failed-charge request“ oder „the subscription request“: Der Schlüssel kann Charges oder Subscriptions nicht lesen. Zahlungen werden weiterhin synchronisiert; fügen Sie die fehlende Berechtigung hinzu und synchronisieren Sie erneut.