ReceivedCredit オブジェクトを使用して Treasury で送金

別の Treasury の金融口座または銀行口座から Treasury の金融口座に送金する方法をご紹介します。

資金が金融口座に送金されると、Stripe は対応する ReceivedCreditオブジェクトをその口座に作成します。ReceivedCredit には、可能な場合、資金の送金方法と送金元の口座の情報が含まれます。金融口座に資金を送金するには、ach および us_domestic_wire の場合、口座の金融番号と口座番号を使用します。金融口座間での送金の場合は金融口座 ID を使用します。

資金の送金元が別の Treasury の金融口座である場合、ReceivedCredit には元の資金移動への linked_flows.source_flow 参照が含まれます。この場合には、ソースの OutboundPayment には network 値として stripe が含まれます。

ReceivedCredit を取得する

GET /v1/treasury/received_credits/{{RECEIVED_CREDIT_ID}} を使用し、指定した ID の ReceivedCredit を取得します。

以下のリクエストは、指定された ID の ReceivedCredit を取得します。このリクエストのレスポンスには、展開されたTransaction オブジェクトの詳細が含まれます。

成功すると、リクエストされた ReceivedCredit オブジェクトがレスポンスで返されます。レスポンスの一部のパラメーターには、リクエストの expand[] パラメーターに値として追加した場合にのみ返される追加情報があります。次のレスポンス例で、拡張できるフィールドには、Expandable コメントが付いています。オブジェクトレスポンスの拡張の詳細については、レスポンスを拡張するをご覧ください。

JSON (コメント付き)
{
  "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

ReceivedCredit をリストする

GET /v1/treasury/received_credits を使用して、必須の financial_account パラメーターの ID の金融口座について、すべての ReceivedCredits を取得します。標準のリストパラメーター、status、linked_flows.source_flow_type でリストをフィルタリングできます。

{
  // 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"
}

以下のリクエストは、指定された金融口座についてステータスが failed の ReceivedCredits を取得します。

成功すると、レスポンスには、リクエストで指定された基準と一致する ReceivedCreditオブジェクトが含まれます。

ReceivedCredit をテストする

POST /v1/test_helpers/treasury/received_credits を使用して、金融口座での資金の受け取りをシミュレーションします。Stripe 以外の口座から金融口座への銀行振込をシミュレーションするには、initiating_payment_method_details を外部の銀行口座の値に設定し、network を ach または us_domestic_wire に設定します。

以下のリクエストは、同じプラットフォーム上の 2 つの金融口座間の OutboundPayment を使用し、外部銀行口座からのテスト環境用の ReceivedCreditを作成します。

成功すると、レスポンスで ReceivedCredit オブジェクトが返されます。以下の例は、銀行振込のレスポンスを示しています。

{
  "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 の Webhook

Stripe は、以下の ReceivedCredit イベントを Webhook エンドポイントに送信します。

ReceivedCredit 作成時の treasury.received_credit.created。
ReceivedCredit のステータス変更時の treasury.received_credit.{{new_status}}。使用可能なステータス値のオプションは以下のとおりです。
- treasury.received_credit.succeeded
- treasury.received_credit.failed
ReceivedCredit の差戻し時の treasury.received_credit.reversed。