Reporting und Abgleich
Verwenden Sie Stripe, um Finanzberichte zu generieren und den Abgleich durchzuführen.
Erfahren Sie mehr über die verschiedenen Auszahlungsarten, SaldoTransaktionen und die erweiterten Berichtsfunktionen innerhalb der Sigma-Plattform.
Auszahlungen und Berichte
Um Berichterstattung und Abgleich zu vereinfachen, verwenden Sie automatische Auszahlungen, da sie die Zuordnung zwischen jeder Transaktion und der Auszahlung, in der sie enthalten sind, aufrechterhalten.
Wenn Sie mithilfe der APIs nutzerdefinierte Berichte erstellen, können Sie den Saldo-Transaktions-Endpoint und den Parameter payout verwenden, um alle Transaktionen aufzulisten, die in einer automatischen Auszahlung enthalten sind. Eine Best Practice ist es, Auszahlungen automatisch und asynchron abzurufen, wenn das Ereignis payout.paid oder payout.reconciliation_completed von Ihrem Webhook-Handler empfangen wird.
Die Anzahl der Saldo-Transaktionen kann die maximal zulässige Grenze überschreiten. In diesem Fall empfehlen wir die Verwendung der automatischen Paginierung, um die Liste aller Saldo-Transaktionen abzurufen, ohne die Ergebnisse manuell paginieren und weitere Anfragen durchführen zu müssen.
Hier ist ein Beispiel für einen Saldenhistorie-API-Aufruf zum Abrufen von Transaktionen aus einer Auszahlung:
Automatische Auszahlungen unterstützen Instant Payouts, worüber sofort Gelder an eine unterstützte Debitkarte gesendet werden. Sie können sofortige Auszahlungen mit Instant Payouts rund um die Uhr, auch an Wochenenden und Feiertagen, anfordern. Die Gelder werden üblicherweise innerhalb von 30 Minuten auf dem zugehörigen Bankkonto angezeigt. Sehen Sie in der Dokumentation zu Instant Payouts nach, um herauszufinden, ob diese Funktion in Ihrer Region verfügbar ist.
Manuelle Auszahlungen
Auf Wunsch können Sie manuelle Auszahlungen durchführen. Stripe unterstützt jedoch keine Berichte auf Transaktionsebene für die Gelder, aus denen sich Ihre manuellen Auszahlungen zusammensetzen, da Sie den Betrag angeben, der ausgezahlt werden soll.
Nachfolgend finden Sie ein Beispiel einer manuellen Auszahlung auf Ihrem Konto:
curl https://api.stripe.com/v1/payouts \ -u: \ -X "POST" \ -d "amount"=1000 \ -d "currency"="usd"sk_test_4eC39HqLyjWDarjtT1zdp7dc
Finanzberichte
Stripe unterstützt zahlreiche vorkonfigurierte Berichte für Finanzanalysen:
- Saldo: Sie können zusammengefasste und aufgeschlüsselte Saldo-Transaktionsdaten anzeigen und herunterladen, die Sie dabei unterstützen, Ihre Bücher auf täglicher, wöchentlicher oder monatlicher Basis abzuschließen. Diese Berichte helfen Ihnen dabei, Änderungen an Ihrem Stripe-Saldo zu verstehen.
- Abgleich: Anhand dieses Berichts können Sie sehen, welche Transaktionen bereits ausgezahlt wurden und welche noch ausgezahlt werden müssen. Auf der Registerkarte „Abgleich“ werden dieselben Arten von Daten angezeigt wie auf der Registerkarte „Guthaben“. Sie werden jedoch auf andere Weise gruppiert, um Ihnen den Abgleich von Auszahlungen zu erleichtern.
Alle Berichte sind im Stripe-Dashboard und über die API verfügbar. Mit der Reporting API können Sie alle vorgefertigten Berichte von Stripe programmgesteuert anfordern und herunterladen.
Wir empfehlen Ihnen, unser aus vier Schritten bestehendes Integrationsmuster zu befolgen, um diesen Prozess vollständig zu automatisieren. Dazu gehört auch, auf Ereignisse zu überwachen, die Sie darüber informieren, wann neue Berichtsdaten verfügbar sind, und Ihre Berichte zu diesem Zeitpunkt auszuführen.
Nachfolgend finden Sie ein Beispiel für einen API-Aufruf zur Erstellung eines „Auszahlungsabgleichs für einzelne Auszahlung“ (d. h. einer „Zahlungsabwicklungsdatei“). Führen Sie diesen API-Aufruf durch, wenn Sie darüber benachrichtigt wurden, dass neue Daten verfügbar sind:
curl https://api.stripe.com/v1/reporting/report_runs \ -u: \ -X "POST" \ -d "report_type"="payout_reconciliation.by_id.itemized.4" \ -d "parameters[interval_start]"=1577865600 \ -d "parameters[interval_end]"=1580544000sk_test_4eC39HqLyjWDarjtT1zdp7dc
Saldo-Transaktionen
Saldo-Transaktionen sind die Bausteine sämtlicher Aktivitäten bei Stripe. Diese Objekte:
- Stellen alles dar, was sich auf Ihren Stripe-Saldo auswirkt (Abbuchungen und Gutschriften).
- Werden automatisch von Stripe erstellt (zum Beispiel generiert jeder erfolgreiche PaymentIntent ein separates BalanceTransaction-Objekt, wie auch jede Auszahlung).
- Sind unveränderlich (eine Rückerstattung ist einer neuen BalanceTransaction zugeordnet, die die ursprüngliche Transaktion negiert).
- Können als Ihr Hauptbuch fungieren (um sich zu einem beliebigen Zeitpunkt ein Bild von Ihrem Saldo zu machen, können Sie alle BalanceTransactions bis zu diesem Zeitpunkt wiedergeben).
BalanceTransactions (txn_-Objekte) sind auch die Basis sämtlicher Berichte – bei den meisten Berichten ist der Datenpunkt auf Zeilenebene ein txn_-Objekt.
Erweiterte Berichterstattung mit Sigma
Mit Sigma werden Ihre sämtlichen Geschäftsdaten in einer interaktiven SQL-Umgebung im Dashboard verfügbar. Sie können Abfragen erstellen, die das umfangreiche Schema nutzen, und so vollständig angepasste Berichte mit Informationen über Ihre Transaktionen erstellen.
Mit Sigma können Sie Daten direkt in das CSV-Format exportieren und Abfragen so planen, dass die Ergebnisse per E-Mail oder Webhook geliefert werden. Sie können Datensätze für Ihre Business-Intelligence-Tools erstellen, Transaktionsdaten abgleichen und benutzerdefinierte Berichte erstellen.
Um Sigma zu aktivieren, navigieren Sie im Dashboard zu Einstellungen > Sigma. Nach der Aktivierung dauert es maximal 24 Stunden, bis die Daten geladen sind und abgefragt werden können. Sigma verwendet standardmäßig ANSI-SQL und eine breite Palette von Berichtsfunktionen. Alle Nutzer/innen Ihres Kontos mit Berechtigungen zum Anzeigen von Berichten können Abfragen erstellen und ausführen.