Bewegen von Geld mithilfe von ReceivedDebit-Objekten

Bestimmte Prozesse, die außerhalb von Finanzkonten für Plattformen initiiert werden, führen dazu, dass Geld von einem Finanzkonto abgebucht wird. Dazu gehören Folgende:

• Geld zum Ausgeben auf einer Karte über Stripe-Issuing
• Mit ACH-Lastschriften Geld von einem Finanzkonto auf ein externes Konto abziehen
• Abheben von Geldbeträgen vom Finanzkonto einer Plattform in das Stripe Zahlungsguthaben dieser Plattform unter Verwendung von Aufstockungen

Diese Geldbewegungen führen zur Erstellung von ReceivedDebit-Objekten. Sie erstellen ReceivedDebits nicht direkt, sondern beobachten die Erstellung des ReceivedDebit-Objekts mit Webhooks. Wenn das Konto nicht ausreichend gedeckt ist, schlägt ReceivedDebit in den meisten Fällen fehl.

ReceivedDebit abrufen

Verwenden Sie GET /v1/treasury/received_debits/{{RECEIVED_DEBIT_ID}}, um die ReceivedDebit mit der zugehörigen ID abzurufen.

curl https://api.stripe.com/v1/treasury/received_debits/{{RECEIVED_DEBIT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
"

Bei Erfolg gibt die Antwort das ReceivedDebit Objekt mit der zugehörigen ID zurück. Einige der Parameter in der Antwort enthalten zusätzliche Details, die nur zurückgegeben werden, wenn Sie sie als Werte zum expand[]-Parameter hinzufügen. Die Felder, die Sie erweitern können, haben im folgenden Antwortbeispiel den Kommentar „Erweiterbar“. Weitere Informationen zum Erweitern von Objektantworten finden Sie unter Antworten erweitern.

{
  "id": "{{RECEIVED_DEBIT_ID}}",
  "object": "received_debit",
  "livemode": Boolean,
  "created": Timestamp,
  // The FinancialAccount funds have been pulled from
  "financial_account": "{{FINANCIAL_ACCOUNT_ID}}", // Expandable
  "amount": 1000,
  "currency": "usd",
  "description": "Testing",

ReceivedDebits auflisten

Verwenden Sie GET /v1/treasury/received_debits, um alle ReceivedDebits für ein Finanzkonto abzurufen. Sie müssen eine Finanzkonto-ID für den Parameter financial_account angeben. Sie können die Ergebnisse nach den Standardlistenparametern oder nach status filtern.

{
  // Standard list parameters
  "limit", "starting_after", "ending_before",
  // Filter by FinancialAccount (Required)
  "financial_account": "{{FINANCIAL_ACCOUNT_ID}}",
  // Filter by status
  "status": "succeeded" | "failed"
}

Die folgende Anfrage ruft das letzte erfolgreiche ReceivedDebit-Objekt ab, das vor der bereitgestellten ReceivedDebit für das erkannte Finanzkonto aufgetreten ist.

curl -G https://api.stripe.com/v1/treasury/received_debits \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d financial_account=
"{{FINANCIAL_ACCOUNT_ID}}" \
  -d limit=1 \
  -d ending_before={{RECEIVED_DEBIT_ID}}

ReceivedDebits testen

Finanzkonten für Plattformen bietet Test-Endpoints für ReceivedDebit-Objekte. Verwenden Sie in Testumgebungen POST /v1/test_helpers/treasury/received_debits, um die Erstellung einer ReceivedDebit zu simulieren. Sie können keine ReceivedDebit-Objekte im Live-Modus, erstellen. Daher ermöglicht Ihnen dieser Endpoint, den Geldfluss zu testen, wenn ein Dritter die Erstellung einer ReceivedDebit einleitet. Setzen Sie financial_account auf die ID des Finanzkontos, von dem Geld gesendet werden soll. Setzen Sie network auf ach und geben Sie optional die ABA-Finanzadressdaten für den Parameter source_details.aba ein. Wie im Live-Modus testen Sie das Fehlschlagen von ReceivedDebits, wenn nicht genügend Mittel zur Verfügung stehen.

ReceivedDebit-Webhooks

Stripe gibt die folgenden ReceivedDebit-Ereignisse an Ihren Webhook-Endpoint aus:

• treasury.received_debit.created bei der Erstellung von ReceivedDebit.