Transaktionsdaten abfragen

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

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

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

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

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 Saldo-Transaktion 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

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.