Auszahlungsabgleich

Wissen, welche Transaktionen in einer bestimmten Auszahlung enthalten sind.

Wenn Sie Gelder von Ihrem verfügbaren Stripe-Saldo an Ihr Bankkonto senden, wird ein Auszahlungsobjekt generiert. Automatische Auszahlungen erfolgen routinemäßig entsprechend Ihrem Auszahlungsplan und können Gelder aus mehreren Transaktionen umfassen.

Stripe bietet die folgenden Möglichkeiten, die in einer automatischen Auszahlung enthaltenen Transaktionen zu überprüfen:

Öffnen Sie eine Auszahlung im Stripe-Dashboard.
Zeigen Sie den Bericht zum Auszahlungsabgleich an oder laden Sie ihn herunter.
Rufen Sie die Auszahlungsdetails über die Stripe-API ab, wie in diesem Leitfaden dokumentiert.

Abgleich für manuelle Auszahlungen

Sie steuern den Zeitpunkt und die Höhe der manuellen Auszahlungen, sodass Stripe nicht erkennen kann, welche Transaktionen in jeder Auszahlung enthalten sind. Sie sind dafür verantwortlich, die von Ihnen erstellten Auszahlungen mit Ihrem Transaktionsverlauf abzugleichen.

Auszahlungs-ID suchen

Sie benötigen die id einer Auszahlung (po_xxx), um Informationen zu den Transaktionen der Auszahlung abzurufen. So erhalten Sie sie:

Überwachen Sie das Webhook-Ereignis payout.reconciliation_completed.
Rufen Sie Auszahlungen auflisten auf, um eine Liste mit Auszahlungen zu überprüfen.
Rufen Sie sie aus Ihrer eigenen Datenbank ab.

Sie können die Auszahlung abrufen, um auf ihre Eigenschaften zuzugreifen. Dies gilt jedoch nicht für die einzelnen Transaktionen, aus denen sich der Gesamtbetrag zusammensetzt.

Retrieve payout sample response
{
  "id": "po_001",
  "amount": 8000,
  "currency": "usd",
  "status": "paid",
  ...
}

BalanceTransactions auflisten

Jede Geldbewegung in oder aus Ihrem Stripe-Konto erstellt eine BalanceTransaction. Geben Sie die Auszahlungs-ID in Ihrer BalanceTransaction-Liste an, um die Ergebnisse nur nach Transaktionen zu filtern, die mit dieser Auszahlung verknüpft sind.

Wenn Sie mehr Ergebnisse als die standardmäßigen 10 benötigen, setzen Sie den Parameter limit in der Anfrage oder verwenden Sie die Automatische Paginierung von Stripe.

Die Antwort gibt ein Array von BalanceTransactions-Objekten für die angegebene Auszahlung zurück:

List balance transactions sample response
{
  "object": "list",
  "data": [
    {
      "id": "txn_001",
      "amount": 10000,
      "type": "charge",
      "source": "ch_001",
      ...
    },
    {
      "id": "txn_002",
      "amount": -2000,
      "type": "refund",
      "source": "re_001",
      ...
    },
    ...

Die Eigenschaft type gibt die zugrunde liegende Aktivität an, die die Transaktion erzeugt hat. Beispiel:

charge: Eine Zahlung von Ihrem Kunden/Ihrer Kundin.
refund: Rückerstattungen, die Sie an Ihre Kundinnen/Kunden zurückgesendet haben.
stripe_fee: Eine von Ihnen bezahlte Stripe-Gebühr.
payout: Die Auszahlung selbst, bei der es sich auch um eine Transaktion handelt, mit der Gelder von Ihrem Stripe-Konto zu Ihrem Bankkonto bewegt wurden.

Eine vollständige Liste finden Sie unter Arten von Saldo-Transaktionen.

Saldo der Transaktionsressourcen erweitern

Die source-Eigenschaft jeder BalanceTransaction gibt das zugrunde liegende Objekt an, das den Transaktionstyp darstellt, beispielsweise ch_xxx für eine Zahlung oder re_xxx für eine Rückerstattung. Um diese Objekte abzurufen, ohne zusätzliche API-Aufrufe durchzuführen, aktualisieren Sie den vorherigen Code mithilfe von expand.

Die Antwort enthält das erweiterte source-Objekt für jede BalanceTransaction in der Auszahlung:

Expanded source sample response
{
  "object": "list",
  "data": [
    {
      "id": "txn_001",
      "amount": 10000,
      "type": "charge",
      "source": {
        "id": "ch_001",
        "amount": 10000,
        "metadata": { ... },
        ...
      },
      ...
    },
    {
      "id": "txn_002",
      "amount": -2000,
      "type": "refund",
      "source": {
        "id": "re_001",
        "amount": 2000,
        "reason": "requested_by_customer",
        ...
      },
      ...

Verwenden Sie den folgenden Code, um auf die Eigenschaften des source-Objekts wie id und amount zuzugreifen.