Reporting und AbgleichPrivate Vorschau

Erfahren Sie, wie Sie Berichte über Capital-Transaktionen erstellen und diese abgleichen.

Der gesamte Lebenszyklus eines Capital-Finanzierungsangebots umfasst drei Arten von Transaktionen:

Auszahlung: Eine Auszahlung erfolgt, wenn Gelder in Übereinstimmung mit der akzeptierten Finanzierungsvereinbarung an das verbundene Konto ausgezahlt werden.
Rückzahlung: Eine Rückzahlung ist eine Abzahlung des finanzierten Betrags.
Storno: Ein Storno tritt auf, wenn eine Auszahlungs- oder Rückzahlungstransaktion rückgängig gemacht wird.

Stripe macht Capital-Transaktionen verfügbar, damit Sie verbundenen Konten (Nutzer/innen) Berichte zur Verfügung stellen können. Sie können Capital-Transaktionen in Ihre Plattform oder Buchhaltungssoftware einbinden, damit Ihre Nutzer/innen ihre Transaktionen abgleichen können.

Wir bieten zwei Optionen zum Abrufen von Transaktionen:

Financing Transactions API: Wir empfehlen die Verwendung der Financing Transactions API, die zusätzliche, für Capital spezifische Transaktionsinformationen enthält.
Balance Transactions API: Wenn Sie bereits eine Integration mit der Balance Transactions API haben, gibt Capital Balance Transactions die meisten Transaktionstypen zurück, es fehlen jedoch zusätzliche Details (z. B. das zugehörige Capital Finanzierungsangebot).

Auszahlungstransaktionen

Wenn Sie einen automatischen Zeitplan für Auszahlungen aktivieren, erhält Ihr verbundenes Konto die Finanzierungsauszahlung automatisch. Andernfalls müssen Sie eine Auszahlung vom Typ source_type=financing erstellen, um die Finanzierung des Nutzers/der Nutzerin manuell auszuzahlen.

Finanzierungsauszahlungen haben eine entsprechende Finanzierungstransaktion vom Typ payout. Nachdem eine payout-Finanzierungstransaktion erstellt wurde, sendet Stripe den Webhook capital.financing_transaction.created webhook. Es kann jedoch mehrere Werktage dauern, bis die ACH-Gelder auf dem Bankkonto des verbundenen Kontos eingehen.

Rückzahlungstransaktionen

Capital unterscheidet drei Arten von Rückzahlungstransaktionen:

Rückzahlungen einbehalten: Wenn verbundene Konten (Nutzer/innen) einen Finanzierungsantrag stellen, erklären sie sich damit einverstanden, dass Stripe einen festen Prozentsatz ihrer zukünftigen Einnahmen einbehalten kann, bis sie den gesamten Finanzierungsbetrag zurückgezahlt haben.
Von Nutzern/Nutzerinnen veranlasste Rückzahlungen: Nutzer und Nutzerinnen können auf der Gehosteten Berichtsseite von Capital manuell eine Zahlung für ihre Finanzierung vornehmen.
Inkassoversuche: Das Servicing-Team von Stripe kann Rückzahlungen gemäß der Inkassorichtlinie von Capital veranlassen.

Alle Rückzahlungen haben eine entsprechende Finanzierungstransaktion vom Typ payment. Sie können Finanzierungstransaktionen abrufen und nach Transaktionstyp filtern, wenn Sie einbehaltene Transaktionen in Ihrer Nutzeroberfläche anzeigen möchten. Achten Sie darauf, die Konto-ID des verbundenen Kontos in der Kopfzeile Stripe-Account anzugeben.

Wenn die Liste der Finanzierungstransaktionen erfolgreich abgerufen wurde, erhalten Sie eine Antwort ähnlich der folgenden:

{
  "object": "list",
  "url": "/v1/capital/financing_transactions?financing_offer=financingoffer_1NAdVWJQ3aJgxqz5nh90Zqrs&charge=ch_1HoZftJQ3aJgxqz50EbvL8zU",
  "has_more": false,
  "data": [
    {
      "id": "cptxn_1NAdVWJQ3aJgxqz5FSScvJaF",
      "object": "capital.financing_transaction",
      "account": "acct_1HLGiXJQ3aJgxqz5",
      "created_at": 1684780258,
      "details": {
        "advance_amount": 10000,
        "currency": "usd",
        "fee_amount": 1000,
        "linked_payment": "ch_1HoZftJQ3aJgxqz50EbvL8zU",
        "reason": "automatic_withholding",
        "total_amount": 11000,
        "transaction": {
          "charge": "ch_1HoZftJQ3aJgxqz50EbvL8zU"
        }
      },
      "financing_offer": "financingoffer_1NAdVWJQ3aJgxqz5nh90Zqrs",
      "livemode": true,
      "type": "payment",
      "user_facing_description": "Paydown of your loan"
    },
    {...},
    {...}
  ]
}

Die Antwort enthält Informationen darüber, wie sich diese bestimmte Rückzahlung auf den ausstehenden Finanzierungsbetrag ausgewirkt hat. Wenn die Rückzahlung aufgrund von "details.reason": "automatic_withholding" erfolgt ist, enthält das Feld details.transaction auch einen Verweis auf die ursprüngliche Stripe-Zahlung.

Destination Charges

Wenn Ihre Plattform Zahlungen unter Verwendung von Destination Charges verarbeitet und Sie die Rückzahlung der Finanzierungstransaktion mit der ursprünglichen Zahlung abgleichen möchten, die auf Ihrer Plattform erfolgt ist, können Sie dies tun, indem Sie zunächst die Zahlungs-ID aus dem Feld details.transaction der Finanzierungstransaktion extrahieren. Diese wird auf die Zahlungs-ID festgelegt, die als Ergebnis der automatischen Übertragung auf das verbundene Konto erfolgt ist.

{
  "id": "cptxn_1NBJQR2eZvKYlo2CBUy2GQ1S",
  "object": "capital.financing_transaction",
  "details": {
    "reason": "automatic_withholding",
    "transaction": {
      "charge": "py_1NBJI62c99H72o8MUEN0fIZx"
    },
    ...
  },
  "type": "payment",
  ...
}

Sie können dann die Retrieve Charge API verwenden, um das Zahlungsobjekt wiederherzustellen:

{
  "id": "py_1NBJI62c99H72o8MUEN0fIZx",
  "object": "charge",
  "source_transfer": "tr_3NBJGW2eZvKYlo2C1jQOxNwF",
  ...
}

Da es sich um eine Destination Charge handelt, wird source_transfer mit der Transfer-ID ausgefüllt. Schließlich können Sie die Retrieve Transfer API verwenden, um das Transfer-Objekt wiederherzustellen:

{
  "id": "tr_3NBJGW2eZvKYlo2C1jQOxNwF",
  "object": "transfer",
  "source_transaction": "ch_3NBJGW2eZvKYlo2C17oDFajw",
  ...
}

Das Feld source_transaction enthält die ID der Zahlung, die auf Ihrer Plattform erfolgt ist und eine Übertragung auf das verbundene Konto ausgelöst hat.

Stornotransaktionen

Auszahlung und Rückzahlungstransaktionen können aus folgenden Gründen storniert werden:

Fehlgeschlagene ACH-Lastschrift: Das Bankkonto eines verbundenen Kontos ist möglicherweise nicht ausreichend gedeckt, um die Abbuchung durchzuführen.
Stornierung der Finanzierung: Wenn ein verbundenes Konto das Finanzierungsangebot nach der Annahme storniert, stellen wir eine Lastschrift aus, um die Gelder zurückzuerhalten und die Auszahlung der Finanzierung zu stornieren.
Einmalige manuelle Stornos: Wenn eine Zahlung zurückerstattet wird, wird die Rückzahlung der Finanzierungstransaktion nicht rückgängig gemacht. Nutzer/innen können sich jedoch an capital-support@stripe.com wenden, um die Rückzahlung zu stornieren. Je nach Art der Rückzahlung können wir dies berücksichtigen. In diesem Fall bitten wir Sie, uns genaue Details zur ursprünglichen Abbuchung mitzuteilen und den Grund für die Rückerstattung anzugeben.

Das Storno einer Tilgungs- oder Auszahlungstransaktion erstellt eine Finanzierungstransaktion vom Typ reversal.