Geld mit Treasury mithilfe von ReceivedDebit-Objekten bewegen

Erfahren Sie, wie externe Kontoinhaber Gelder von einem Treasury Finanzkonto abrufen können.

Bestimmte außerhalb von Stripe Treasury initiierte Prozesse führen dazu, dass Geld von einem Treasury-Finanzkonto abgezogen wird. Dies beinhaltet:

Geld mit einer Karte über Stripe Issuing ausgeben
Mit ACH-Lastschriften Geld von einem Finanzkonto auf ein externes Konto abziehen
Geld von Finanzkonten einer Plattform auf das Stripe Payments-Guthaben dieser Plattform mittels Aufstockungen übertragen

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.

Eine ReceivedDebit abrufen

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

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.

JSON (mit Kommentar)
{
  "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.

ReceivedDebits testen

Stripe Treasury stellt Test-Endpoints für ReceivedDebit-Objekte bereit. Verwenden Sie POST /v1/test_helpers/treasury/received_debits, um die Erstellung von ReceivedDebit im Test-Modus zu simulieren. Da Sie im Live-Modus keine ReceivedDebit-Objekte erstellen können, ermöglicht Ihnen die Verwendung dieses Endpoints, den Geldstrom zu testen, wenn eine Drittpartei die Erstellung einer ReceivedDebit initiiert. Setzen Sie financial_account auf die ID des Finanzkontos, von dem Geld gesendet werden soll. Legen Sie network auf ach fest und geben Sie optional die ABA-Finanzadresse für den Parameter source_details.aba an. Wie im Live-Modus schlägt ReceivedDebits im Test-Modus bei unzureichender Deckung fehl.

ReceivedDebit-Webhooks

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

treasury.received_debit.created bei der Erstellung von ReceivedDebit.