Weiter zum Inhalt
Konto erstellen
oder
anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellen
Anmelden
Jetzt starten
Zahlungen
Finanzautomatisierung
Plattformen und Marktplätze
Geldmanagement
Entwickler-Tools
Jetzt starten
Zahlungen
Finanzautomatisierung
Jetzt starten
Zahlungen
Finanzautomatisierung
Plattformen und Marktplätze
Geldmanagement
Übersicht
Billing
Steuer
Berichte
Daten
    Übersicht
    Schema
    Nutzerspezifische Berichte
    Sigma-API
    Nutzerspezifische Berichte erstellen
    Mit Sigma Abfragen schreiben
    Daten innerhalb einer Organisation abfragen
    Stripe-Daten synchronisieren
    Auf Daten innerhalb eines Data Warehouse zugreifen
    Daten in ein Data Warehouse exportieren
    Daten in Cloud-Speicher exportieren
    Datenverwaltung
    Datenaktualität
    Anwendungsszenarien für Geschäfts- und Produktdaten
      Transaktionsdaten
      Daten zu Anfechtungen und Betrug
      Daten zu allen Gebühren
      Abrechnungsdaten
      Steuerdaten
      Daten zu verbundenen Konten
      Daten zur Kartenausstellung
    Externe Daten importieren
Start-up-Gründung
StartseiteFinanzautomatisierungDataBusiness and product data use cases

Transaktionsdaten abfragen

Erstellen Sie nutzerdefinierte Berichte für Zahlungen, Rückerstattungen, Überweisungen und vieles mehr.

Seite kopieren

Verwenden Sie die Daten innerhalb des Schemas von Stripe Sigma für die Berichterstellung über die Aktivität Ihres Kontoguthabens. Der Abschnitt Zahlungstabellen enthält Tabellen, die die Geldbewegungen zwischen Ihren Kundinnen/Kunden und Ihrem Stripe-Konto darstellen, wie beispielsweise Zahlungen oder Rückerstattungen. Informationen zu Überweisungen von Ihrem Stripe-Kontoguthaben auf Ihre Bankkonto-(Auszahlungen) sind im Abschnitt Überweisungstabellen aufgeführt.

Verwenden Sie für die Abrechnung die Tabelle balance_transactions als Ausgangspunkt. Im Gegensatz zu separaten Tabellen (z. B. charges oder refunds) bietet sie für jede Art von Transaktion im Guthaben Ihres Stripe-Kontos einen Geschäftsbuch-ähnlichen Bericht. Verwenden Sie die Saldo-Transaktionen, um die am häufigsten verwendeten Berichte zu generieren und die Berichterstellung zu finanziellen Aktivitäten zu vereinfachen. Zu den gängigen Arten von Saldo-Transaktion gehören:

  • charges
  • refunds
  • transfers
  • payouts
  • adjustments
  • application_fees

Jede Zeile einer Saldo-Transaktion stellt ein einzelnes balance_transaction-Objekt dar, das sich nach der Erstellung nicht mehr ändert. Beispielsweise wird bei der Erstellung einer Zahlung auch eine entsprechende Saldo-Transaktion vom Typ charge erstellt. Wenn diese Zahlung zurückerstattet wird, wird außerdem eine separate Saldo-Transaktion vom Typ refund erstellt – wobei sich die ursprüngliche Saldo-Transaktion nicht ändert. Auf ähnliche Weise wird eine Saldo-Transaktion erstellt, wenn eine Auszahlung (Überweisung) auf Ihr Bankkonto erfolgt.

Die nachfolgende Beispielabfrage verwendet diese Tabelle, um bestimmte Informationen über die fünf letzten Saldo-Transaktionen abzurufen.

select date_format(created, '%m-%d-%Y') as day, id, amount, currency, source_id, type from balance_transactions order by day desc limit 5
TagIDBetragWährungsource_idTyp
16.5.2025txn_WPpvjvTugVNb7QD-1.000USDre_CBc1OhVzzJF4nQDRückerstattung
16.5.2025txn_EWdmtBXBVNkEJHz1.000USDch_KOtxnFdh2rRzfyYZahlung
16.5.2025txn_tVwYG0zw5Sm4gKo1.000USDch_kJjcKsZmJ82JDxcZahlung
16.5.2025txn_ixscxUEr0IKi2Ty1.000EURch_nHQrAsxlzLIzOzfZahlung
16.5.2025txn_T06ftURzJdwgT18-1.000USDre_FDV0dcmDzO8ATQDRückerstattung

Die gängigsten Finanzübersichten können durch Zusammenfügen der Tabelle balance_transactions mit anderen Tabellen, die die entsprechenden Informationen enthalten, berechnet werden. Einige unserer Abfragevorlagen (z. B. Tagessaldo oder Monatliche Zusammenfassung und Saldo) lassen sich durch Verbinden dieser Tabelle mit anderen Tabellen berechnen.

Details zu Saldo-Transaktionsgebühren

Informationen zu den Transaktionsgebühren für jede einzelne Saldo-Transaktion werden in der Tabelle balance_transaction_fee_details bereitgestellt. Durch das wie unten beschriebene Zusammenfügen dieser Tabelle mit balance_transactions können Sie die Informationen zu den Transaktionsgebühren für jede Saldo-Transaktion zurückgeben.

Die nachfolgende Abfrage verbindet die Tabellen balance_transactions und balance_transaction_fee_details miteinander. Jeder zurückgegebene Saldo-Transaktionsposten umfasst den Betrag, die Transaktionsgebühr, die Art der erhobenen Transaktionsgebühr und eine Beschreibung der Transaktionsgebühr.

select date_format(date_trunc('day', balance_transactions.created), '%m-%d-%Y') as day, balance_transactions.id, balance_transactions.amount, balance_transactions.fee, balance_transaction_fee_details.type from balance_transactions inner join balance_transaction_fee_details on balance_transaction_fee_details.balance_transaction_id=balance_transactions.id order by day desc limit 5
TagIDBetragGebührTyp
16.5.2025txn_yAIKkn1tdwN5ZV61.00059stripe_fee
16.5.2025txn_jHp9DUBobFzE3nL1.00059stripe_fee
16.5.2025txn_9KEizSW6nUlaKUQ1.00059stripe_fee
16.5.2025txn_kqixFroyJ7VErZ01.00059stripe_fee
16.5.2025txn_tyRufgCpkp5411R1.00059stripe_fee

Zahlungen

Die Tabelle charges enthält Daten über Charge-Objekte. Diese Tabelle eignet sich besonders für Abfragen, die sich auf Informationen zu Zahlungen konzentrieren und weniger für Abrechnungs- oder Abgleichungszwecke gedacht sind. Gleichzeitig ergänzt sie die Abrechnungsberichte mit weiteren Kundendaten. Die Vorlagenabfrage für die Zahlungskartenaufschlüsselung nutzt beispielsweise die Tabelle charges, um Berichte über die verschiedenen von Ihren Kundinnen/Kunden verwendeten Kartentypen zu erstellen.

Sie können die Tabelle charges mit mehreren anderen Tabellen zusammenfügen, um mehr Informationen mit Ihren Abfragen abrufen zu können.

Das folgende Beispiel verwendet die Tabelle charges, um Berichte über fehlgeschlagene Zahlungen zu erstellen, und gibt dabei sowohl die Kartenmarke als auch den Fehlercode und die Fehlermeldung zurück.

select date_format(date_trunc('day', created), '%m-%d-%Y') as day, id, card_brand, failure_code, failure_message from charges where status = 'failed' order by day desc limit 5
TagIDcard_brandfailure_codefailure_message
16.5.2025ch_Emj5FIqugTIlZOOVisacard_declinedIhre Karte wurde abgelehnt.
16.5.2025ch_346jFw86ciGveHsMasterCardcard_declinedDieser Einkauf wird von Ihrer Karte nicht unterstützt.
16.5.2025ch_zVJVTJskP8xQ7s9Visacard_declinedDas Guthaben auf Ihrer Karte ist nicht ausreichend.
16.5.2025ch_CBrpWOcv03HqaZWVisacard_declinedIhre Karte wurde abgelehnt.
16.5.2025ch_Imc0NSo4G7G1NZIMasterCardcard_declinedIhre Karte wurde abgelehnt.

Kund/innen

Daten über Customer-Objekte sind in der Tabelle customers enthalten (gehört nicht zur Gruppe Zahlungstabellen). Verwenden Sie diese Tabelle, wenn Sie Zahlungen mit Kundinnen/Kunden (beispielsweise mit gespeicherten Zahlungsinformationen) erstellen. Die Tabelle ist ebenfalls hilfreich, wenn Sie Abonnements nutzen.

Das folgende Beispiel ruft eine Liste fehlgeschlagener Zahlungen mit Angabe der ID und E-Mail-Adresse für die jeweiligen Kund/innen ab.

select date_format(date_trunc('day', charges.created), '%m-%d-%Y') as day, customers.id, customers.email, charges.id from charges inner join customers on customers.id=charges.customer_id where charges.status = 'failed' order by day desc limit 5

Rückerstattungen

Zahlungen und Rückerstattungen sind separate Objekte innerhalb der API. Bei der Rückerstattung einer Zahlung wird immer ein Refund-Objekt erstellt. Diese Daten sind in der Tabelle refunds verfügbar und liefern detaillierte Informationen über erfolgte Rückerstattungen. Wie auch bei der Erstellung von Berichten über Zahlungen sollten zunächst Informationen über Saldo-Transaktionen herangezogen werden. Bei Bedarf können Sie anschließend weitere Einzelheiten mithilfe der Tabelle refunds erfassen.

Sie können die Tabelle refunds mit den Tabellen balance_transactions und charges zusammenführen, um die Daten der Rückerstattung genauer zu untersuchen.

Im nachfolgenden Beispiel werden die Tabellen balance_transactions und refunds mithilfe der Spalten refunds.balance_transaction_id und balance_transactions.id miteinander verbunden. Jeder zurückgegebene Saldo-Transaktionsposten ist eine Rückerstattung und zeigt die entsprechende ID und den Betrag der Zahlung. Es werden nur Saldo-Transaktionen zurückgegeben, die nach einem bestimmten Datum erstellt wurden.

select date_format(date_trunc('day', balance_transactions.created), '%m-%d-%Y') as day, balance_transactions.source_id, refunds.charge_id, balance_transactions.amount from balance_transactions inner join refunds on refunds.balance_transaction_id=balance_transactions.id where balance_transactions.type = 'refund' order by day desc limit 5
Tagsource_idcharge_idBetrag
16.5.2025re_l6rHf4xV0tfi5Nhch_Pv1ZUozwKxO2mzn-1.000
16.5.2025re_u2AxVf1VZ0K9ZpNch_iYRbLcNiNLVQ8WU-1.000
16.5.2025re_hdTkGWmFLgHgd1Ych_IuT3DGs98mkZbuH-1.000
16.5.2025re_hzChEFkvF4RnAeNch_M1LYdKlIwpVR0T8-1.000
16.5.2025re_mmQi6W7eUabxQ5Zch_wJKe3vGf3WdW9Gi-1.000

Anteilig erfasste Rückerstattungen

Wenn Sie die separate Autorisierung und Erfassung nutzen und nur einen Teil des autorisierten Betrags erfassen, werden sowohl eine Zahlung als auch eine Rückerstattung erstellt. Eine autorisierte Zahlung erzeugt eine charge und eine zugehörige Saldotransaktion für den vollständigen Betrag. Sobald eine anteilige Erfassung abgeschlossen ist, wird der nicht erfasste Betrag freigegeben und ein refund mit dem Feld reason von partial_capture und einer entsprechenden Saldo-Transaktion wird erstellt.

Wenn Sie beispielsweise eine Zahlung in Höhe von 10 USD autorisieren, aber nur 7 USD erfassen, wird zunächst eine charge in Höhe von 10 USD erstellt. So wird für die verbliebenen 3 USD zudem ein refund mit dem Grund partial_capture erstellt.

Berücksichtigen Sie diesen Punkt, wenn Ihr Unternehmen Zahlungen mittels separater Autorisierung und Erfassung abwickelt und Sie Berichte zur Prüfung der Rückerstattungsquote von Kund/innen erstellen. Andernfalls kann die Anzahl der Rückerstattungen in Ihrem Konto falsch dargestellt werden. Verwenden Sie das Feld reason der Rückerstattung, um beim Abrufen von Zahlungsinformationen unvollständig erfasste Rückerstattungen herauszufiltern.

select balance_transactions.id, balance_transactions.amount from balance_transactions inner join refunds on refunds.id=balance_transactions.source_id where reason != 'partial_capture' limit 5

Überweisungen und Auszahlungen

Die Tabelle transfers enthält Daten über Auszahlungen, die von Ihrem Stripe-Guthaben auf Ihr Bankkonto getätigt wurden. Sie können diese Tabelle verwenden, um jede Auszahlung mit den entsprechenden Zahlungen, Rückerstattungen und Anpassungen abzustimmen, sofern Sie automatische Auszahlungen verwenden.

Für Connect-Plattformen enthält diese Tabelle auch Daten zu Überweisungen auf verbundene Stripe-Konten.

Wenn Sie Auszahlungen manuell durchführen, ist der jeweilige Auszahlungsbetrag auf Ihr Bankkonto beliebig. Somit kann er nicht mit bestimmten Saldo-Transaktionen abgeglichen werden und gibt nur den von Ihnen zur Auszahlung auf Ihr Bankkonto angeforderten Betrag an.

Im folgenden Beispiel werden die Tabellen balance_transactions und transfers miteinander verbunden. Dabei werden eine Liste von Zahlungen und Rückerstattungen, die entsprechende Auszahlung und das Datum des planmäßigen Eintreffens der Auszahlung auf Ihrem Bankkonto übergeben.

select date_format(date_trunc('day', balance_transactions.created), '%m-%d-%Y') as bt_created, balance_transactions.source_id, balance_transactions.type, balance_transactions.net as net_amount, balance_transactions.automatic_transfer_id as transfer_id, date_format(date_trunc('day', transfers.date), '%m-%d-%Y') as transfer_date from balance_transactions inner join transfers on balance_transactions.automatic_transfer_id=transfers.id where balance_transactions.type = 'charge' and balance_transactions.type != 'refund' order by bt_created desc limit 5
Tagsource_idTypnet_amounttransfer_idtransfer_date
22.05.2017ch_kw7xsPSSNisBcR0Zahlung941po_TrtDrBdIc7zSn6R24.05.2017
22.05.2017ch_bgT2grZ1lL3v4ACZahlung941po_36zcmNcH2HT3rJW24.05.2017
21.05.2017ch_qqAvHzX7sV3bEBKZahlung941po_wfnb5H43G5DosQW23.05.2017
21.05.2017ch_32JUM6BFkVrtqwgZahlung941po_Vem6F7z4yvUPuDm23.05.2017
21.05.2017ch_8qkEJVXfHAq2rJhZahlung941po_JmZSX7OrY2zzSdc23.05.2017

Vorsicht

Auszahlungen vor dem 06.04.2017 haben eine TRANSFER_ID mit Präfix tr_.

Rückbuchungen von Überweisungen

Eine manuell erstellte Auszahlung (oder Überweisung auf ein verbundenes Stripe-Konto) kann rückgängig gemacht werden, wenn sie noch nicht ausgezahlt wurde. Dabei werden alle Gelder in das verfügbare Guthaben Ihres Kontos zurückgebucht. Sie werden als Transfer_reversal-Objekte dargestellt und sind in der Tabelle transfer_reversals zu finden.

Rückbuchungen von Überweisungen gelten nur für manuell erstellte Auszahlungen und Überweisungen – automatische Auszahlungen können nicht zurückgebucht werden.

War diese Seite hilfreich?
JaNein
Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
Schauen Sie sich unser Änderungsprotokoll an.
Fragen? Sales-Team kontaktieren.
LLM? Lesen Sie llms.txt.
Unterstützt von Markdoc