Geld mit Treasury mithilfe von ReceivedCredit-Objekten bewegen

Erfahren Sie, wie Sie Geld von einem anderen Finanzkonto des Treasury Finanzkonten oder einem Bankkonto auf ein Treasury Finanzkonto übertragen können.

Wenn Gelder auf ein Finanzkonto übertragen werden, erstellt Stripe ein entsprechendes ReceivedCredit-Objekt auf dem Konto. Ein ReceivedCredit enthält Informationen darüber, wie die Gelder gesendet wurden und, falls möglich, von welchem Konto. Gelder können mit den Bankleitzahlen und Kontonummern für ach- und us_domestic_wire-Überweisungen oder mit der Finanzkonto-ID für Überweisungen zwischen Finanzkonten gesendet werden.

Wenn die Gelder von einem anderen Treasury-Finanzkonto stammen, enthält der ReceivedCredit eine Referenz vom Typ linked_flows.source_flow zur ursprünglichen Geldbewegung. In diesem Fall ist der network-Wert der OutboundPayment stripe.

Eine ReceivedCredit abrufen

Verwenden Sie GET /v1/treasury/received_credits/{{RECEIVED_CREDIT_ID}}, um das ReceivedCredit mit der angegebenen ID abzurufen.

Die folgende Anfrage ruft den ReceivedCredit mit der angegebenen ID ab. Die Antwort auf diese Anfrage enthält erweiterte Details zum Transaktions-Objekt.

Bei Erfolg stellt die Antwort das angeforderte ReceivedCredit-Objekt bereit. Einige der Parameter in der Antwort verfügen über zusätzliche Details, die nur zurückgegeben werden, wenn Sie sie als Werte zum Parameter expand[] Ihrer Anfrage hinzufügen. Die Felder, die Sie erweitern können, haben im folgenden Antwortbeispiel den Kommentar Expandable. Weitere Informationen zum Erweitern von Objektantworten finden Sie unter Erweitern von Antworten.

JSON (mit Kommentar)
{
  "id": "{{RECEIVED_CREDIT_ID}}",
  "object": "received_credit",
  "livemode": true | false,
  "created": "{{Timestamp}}",
  // The FinancialAccount that received the funds
  "financial_account": "{{FINANCIAL_ACCOUNT_ID}}", // Expandable
  "amount": 1000,
  "currency": "usd",
  // The description of this movement sent by the originator

ReceivedCredits auflisten

Verwenden Sie GET /v1/treasury/received_credits, um alle ReceivedCredits mit der ID des erforderlichen financial_account-Parameters abzurufen. Sie können die Liste mit den Standard-Listenparametern oder nach status oder nach linked_flows.source_flow_type sortieren.

{
  // Standard list parameters
  "limit", "starting_after", "ending_before",
  // Filter by FinancialAccount (required)
  "financial_account": "{{FINANCIAL_ACCOUNT_ID}}",
  // Filter by status
  "status": "succeeded" | "failed",
  // Filter by `source_flow_type`
  "linked_flows.source_flow_type": nil | "payout" | "outbound_payment"
}

Mit der folgenden Anfrage werden die ReceivedCredits mit dem Status failed für das angegebene Finanzkonto abgerufen.

Bei Erfolg enthält die Antwort die ReceivedCredit-Objekte, die den in der Anfrage angegebenen Kriterien entsprechen.

ReceivedCredits testen

Verwenden Sie POST /v1/test_helpers/treasury/received_credits, um den Eingang von Geldern auf einem Finanzkonto zu simulieren. Um eine Banküberweisung von einem Konto außerhalb von Stripe auf Ihr Finanzkonto zu simulieren, setzen Sie initiating_payment_method_details auf die Werte des externen Bankkontos, und setzen Sie network auf ach oder us_domestic_wire.

Die folgende Anfrage erstellt eine ReceivedCredit im Test-Modus von einem externen Bankkonto unter Verwendung einer OutboundPayment zwischen zwei Finanzkonten auf derselben Plattform.

Bei Erfolg gibt die Antwort ein ReceivedCredit-Objekt zurück. Nachfolgend ist ein Beispiel einer Antwort für eine Banküberweisung dargestellt.

{
  "financial_account": "{{FINANCIAL_ACCOUNT_ID}}",
  "network": "ach",
  "amount": "1234",
  "currency": "usd",
  "description": "Test",
  "source_details": {
    "type": "aba",
    "aba": {
      "country": "US",
      "routing_number": "12341234",
      "account_number": "0123456789",
      "account_holder_name": "Jenny Rosen",
    }
  }
}

ReceivedCredit-Webhooks

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

treasury.received_credit.created bei der ReceivedCredit-Erstellung.
treasury.received_credit.{{new_status}}, wenn sich der Status eines ReceivedCredit ändert. Folgende Statuswertoptionen sind verfügbar:
- treasury.received_credit.succeeded
- treasury.received_credit.failed
treasury.received_credit.reversed bei ReceivedCredit Storno.