Bewegen von Geld mithilfe von ReceivedCredit-Objekten

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.

Stammen die Geldbeträge von einem anderen Finanzkonto, enthält der Wert ReceivedCredit enthält eine linked_flows.source_flow-Referenz auf die ursprüngliche Geldbewegung. In diesem Fall hat die Quell-OutboundPayment stripe als ihren network-Wert.

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.

curl -G https://api.stripe.com/v1/treasury/received_credits/{{RECEIVED_CREDIT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "expand[]"=transaction

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.

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

curl -G https://api.stripe.com/v1/treasury/received_credits \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d financial_account=
"{{FINANCIAL_ACCOUNT_ID}}" \
  -d status=failed

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.

curl https://api.stripe.com/v1/test_helpers/treasury/received_credits \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d financial_account={{DESTINATION_FINANCIAL_ACCOUNT_ID}} \
  -d network=ach \
  -d amount=1234 \
  -d currency=usd

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