Abgleichen und Bereitstellen von BerichtenÖffentliche Vorschau

Die folgenden Arten von Saldo-Transaktionen stehen im Zusammenhang mit der Finanzierung Ihrer verbundenen Konten, einschließlich Händlervorschüssen und Darlehen.

• Auszahlung: payout
• Anzahlung: payment
• Storno: reversal

Auszahlung

Jede Auszahlung der Finanzierung hat ein Objekt Finanzierungstransaktion mit dem Typ payout. Nach der Erstellung einer Auszahlungsfinanzierungstransaktion sendet Stripe einen Webhook capital.financing_transaction.created. Es kann einige Werktage dauern, bis die ACH-Gelder auf dem Bankkonto eines verbundenen Kontos eingehen.

Achten Sie auf das Webhook-Ereignis und aktualisieren Sie Ihre nutzerdefinierten Auszahlungsberichte, um den Finanzierungsbetrag anzuzeigen, der an das externe Bankkonto des verbundenen Kontos gesendet wurde.

Anzahlung

Um einbehaltene Transaktionen in Ihrer Nutzeroberfläche anzuzeigen:

1. Financing Transactions abrufen und nach Transaktionstyp filtern.
2. Geben Sie die Konto-ID des verbundenen Kontos im Header Stripe-Account an.

curl -G https://api.stripe.com/v1/capital/financing_transactions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d type=paydown

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.

Storno

Jede Stornierung hat ein Objekt Finanzierungstransaktion mit dem Typ reversal. Eine Stornierung kann aufgrund einer fehlgeschlagenen ACH-Transaktion, einer Finanzierungskündigung oder einer manuellen Stornierungsanfrage erfolgen. Die Bereitstellung von Stornotransaktionen dient zwei Zwecken:

• Sie können auf eine abgebrochene Finanzierung hinweisen. Wenn Sie die ursprüngliche Auszahlung der Finanzierung in Ihre Berichte aufgenommen haben, geben Sie auch alle Stornos an. Auf diese Weise können die verbundenen Konten sehen, dass sich beide Transaktionen gegenseitig aufheben.
• Sie können zuvor einbehaltene Gelder auf ein verbundenes Konto zurückführen. Wenn Sie Stornierungen in Ihren Berichten auslassen, kann dies zu Abgleichproblemen bei verbundenen Konten führen, da die Berichte möglicherweise eine ungenaue Finanzierung widerspiegeln.

Destination Charges

Wenn Ihre Plattform Zahlungen unter Verwendung von Destination Charges verarbeitet und Sie die Auszahlung der Finanzierungstransaktion mit der ursprünglichen Gebühr abgleichen möchten, die auf Ihrer Plattform angefallen ist, extrahieren Sie die ID der Gebühr in dem Feld details.transaction der Finanzierungstransaktion. Diese wird auf die Zahlungs-ID gesetzt, die als Ergebnis der automatischen Überweisung auf das verbundene Konto erfolgte:

{
  "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 abzurufen:

curl https://api.stripe.com/v1/charges/py_1NBJI62c99H72o8MUEN0fIZx \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

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

Da es sich um eine Destination Charges handelt, wird die ID Transfer in die Variable source_transfer eingetragen. Verwenden Sie die Retrieve Transfer API, um das Transfer-Objekt zu erhalten

curl https://api.stripe.com/v1/transfers/tr_3NBJGW2eZvKYlo2C1jQOxNwF \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

{
  "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.

Sie können Anzahlungen in jeder Liste von Finanzierungstransaktionen oder entsprechenden Modellen anzeigen, die Sie in der Nutzeroberfläche Ihrer Plattform haben. Beispiel:

• Vorhandene Berichte: Für vorhandene Berichte, die die einzelnen Transaktionen eines verbundenen Kontos (einschließlich der Plattformgebühr oder Verrechnungskosten) anzeigen, sollten Sie in Betracht ziehen, einen einbehaltenen Betrag in den Bericht aufzunehmen.
• Neue Berichte: Für neue Berichte zeigen Sie alle einbehaltenen Beträge für einen bestimmten Zeitraum an. Dadurch können Ihre verbundenen Konten sehen, wie viel ihrer Umsatzabwicklung für ihre Finanzierung verwendet wird. Für Auszahlungsberichte können Sie einen Gesamtbetrag angeben, der einbehalten wird. Auf diese Weisen können verbundene Konten ihren gesamten eingehenden Umsatz abzüglich der Einbehaltung (und etwaiger von Ihnen berechneter Plattformgebühren) abgleichen, um den Auszahlungsbetrag zu ermitteln, den sie auf ihrem externen Bankkonto erwarten…

curl https://api.stripe.com/v1/account_links \
  -u sk_test_26PHem9AhJZvU623DfE1x4sd: \
  -d account=acct_123 \
  -d refresh_url="https://example.com/reauth" \
  -d return_url="https://example.com/thanks" \
  -d type=capital_financing_reporting

Sie können eine Sandbox verwenden, um Finanzierungsangebote in verschiedenen Kontostatus für verbundene Konten zu erstellen.

Um Testszenarien zu erstellen:

1. Erstellen Sie eine Sandbox in Ihrer Testumgebung.

2. Generieren Sie Testangebote über das Capital-Dashboard.

3. Aktualisieren Sie Angebote als zugestellt und simulieren Sie die Annahme.

4. Testen Sie automatische Auszahlungen, indem Sie Gelder genehmigen und auszahlen lassen.

5. Testen Sie eine Auszahlung oder eine Anzahlung. Sie können eine Stornierung nicht testen, da diese nur von Stripe unter bestimmten Umständen initiiert wird.

   • Payouts:
     1. Vergewissern Sie sich, dass automatische Auszahlungen nach Annahme des Angebots erfolgen.
     2. Behalten Sie die capital.financing_transaction.created Webhooks im Auge.
     3. Bestätigen Sie, dass Auszahlungen in Ihrem Bericht erscheinen.
   • Anzahlungen:
     1. Testen Sie den automatischen Einbehalt, indem Sie Testzahlungen verarbeiten.
     2. Simulieren Sie manuelle Anzahlungen über das Capital-Dashboard.
     3. Vergewissern Sie sich, dass die Transaktionen der Anzahlung in Ihrer Integration für die Berichterstattung erscheinen.

6. Bestätigen Sie, dass die Transaktionsdetails in Ihrer Berichtsschnittstelle korrekt angezeigt werden.

7. Überprüfen Sie die Verarbeitung von Webhooks für Transaktionsbenachrichtigungen.

8. Testen Sie Links zu Konten oder eingebettete Komponenten (falls implementiert).

9. Validieren Sie die Prozesse zum Abgleich von Transaktionen.

Senden Sie nach dem Test manuell ein Live-Angebot, um Ihre Berichte zu überprüfen, bevor Sie automatische Angebote für alle in Frage kommenden verbundenen Konten aktivieren. Weitere Informationen finden Sie unter Testen.