ReceivedCredit オブジェクトを使用して Treasury で送金
別の Treasury の金融口座または銀行口座から Treasury の金融口座に送金する方法をご紹介します。
資金が金融口座に送金されると、Stripe は対応する ReceivedCreditオブジェクトをその口座に作成します。ReceivedCredit
には、可能な場合、資金の送金方法と送金元の口座の情報が含まれます。金融口座に資金を送金するには、ach
および us_
の場合、口座の金融番号と口座番号を使用します。金融口座間での送金の場合は金融口座 ID を使用します。
資金の送金元が別の Treasury の金融口座である場合、ReceivedCredit
には元の資金移動への linked_
参照が含まれます。この場合には、ソースの OutboundPayment
には network
値として stripe
が含まれます。
ReceivedCredit を取得する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
GET /v1/treasury/received_
を使用し、指定した ID の ReceivedCredit を取得します。
以下のリクエストは、指定された ID の ReceivedCredit
を取得します。このリクエストのレスポンスには、展開されたTransaction オブジェクトの詳細が含まれます。
成功すると、リクエストされた ReceivedCredit
オブジェクトがレスポンスで返されます。レスポンスの一部のパラメーターには、リクエストの expand[]
パラメーターに値として追加した場合にのみ返される追加情報があります。次のレスポンス例で、拡張できるフィールドには、Expandable
コメントが付いています。オブジェクトレスポンスの拡張の詳細については、レスポンスを拡張するをご覧ください。
ReceivedCredit をリストする![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
GET /v1/treasury/received_
を使用して、必須の financial_
パラメーターの ID の金融口座について、すべての ReceivedCredits
を取得します。標準のリストパラメーター、status
、linked_
でリストをフィルタリングできます。
{ // 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 をテストする![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
POST /v1/test_
を使用して、金融口座での資金の受け取りをシミュレーションします。Stripe 以外の口座から金融口座への銀行振込をシミュレーションするには、initiating_
を外部の銀行口座の値に設定し、network
を ach
または us_
に設定します。
以下のリクエストは、同じプラットフォーム上の 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![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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