プラットフォームの金融アカウント
Stripe Treasury への API アクセスを獲得した後、お使いのプラットフォームに 2 つの金融口座が自動的に提供されます。1 つはテスト環境用で、もう 1 つは本番環境用です。
テスト環境用のプラットフォームの金融口座を使用すると、プラットフォームアカウントの残高や本番環境のプラットフォームの金融口座の残高に実際に影響をもたらすことなく、組み込みを設定してテストすることができます。
本番環境のプラットフォームの金融口座は、Treasury プログラムの運転資金としてご自身の資金を保管できる場所です。本番環境プラットフォームの金融口座には、それ独自の金融番号と口座番号があり、プラットフォームの連結アカウントに関連付けられた金融口座と同種の資金移動のほとんどをサポートしています。
プラットフォームの金融口座の違い
プラットフォームの金融口座 (本番環境とテスト環境) は、プラットフォームの連結アカウントに関連付けられた金融口座と基本的に同じです。いずれの金融口座の場合でも、同じ API リクエストを使用します。ただし、プラットフォームの金融口座に対する API コールを行う際には、Stripe-Account
ヘッダーを含めません。Stripe-Account
ヘッダーは、プラットフォームではなく、関連付けられた連結アカウントの金融口座に対するリクエストを示します。
以下のリストは、プラットフォームの金融口座と連結アカウントに関連付けられた金融口座の間を違いをまとめたものです。
- Stripe Issuing カードを、プラットフォームの金融口座に関連付けることはできません。
- Stripe Issuing カードを、連結アカウントに関連付けられた金融口座に関連付けることができます。
- プラットフォームの金融口座の残高から連結アカウントのアカウント残高に直接送金することはできません。
- プラットフォームの金融口座の残高から連結アカウントに関連付けられた金融口座の残高には直接送金できます。
- Stripe API を使用してプラットフォームの金融口座を解約することはできません。
- ベータ ベータの Closure API メソッドにアクセスできる場合は、
POST /v1/treasury/financial_accounts/{{FINANCIAL_ACCOUNT_ID}}/close
を使用して、連結アカウントに関連付けられた金融口座を解約することができます。Closure API メソッドは、プラットフォームの金融口座を解約する機能は提供していません。
- ベータ ベータの Closure API メソッドにアクセスできる場合は、
- プラットフォームの金融口座を、プラットフォームの支払い残高からの入金またはプラットフォームの支払い残高へのトップアップ (資金の追加) に使用できる
BankAccount
オブジェクトとして設定するには、(API ではなく) Stripe ダッシュボードを使用する必要があります。- 詳細については、入金およびトップアップガイドをご覧ください。
- プラットフォームアカウントの残高からプラットフォームの金融口座の残高への入金をスピードアップすることはできません。
プラットフォームの金融口座詳細を取得する
プラットフォームの金融口座の金融番号、口座番号、および残高は、Stripe ダッシュボードの 残高タブにある Treasury の残高セクションにあります。プラットフォームの金融口座のその他の詳細は、API を使用して確認できます。
Treasury の残高
GET /v1/treasury/financial_accounts
を使用し、API を通じてプラットフォームの金融アカウントのあらゆる詳細をリストできます。このリクエストはプラットフォームの金融アカウントに対するリクエストのため、Stripe-Account
ヘッダーは含まれません。
成功すると、レスポンスには、プラットフォームの金融口座の id
が含まれます。その金融口座 ID を使用し、GET /v1/treasury/financial_accounts/{{FINANCIALACCOUNT_ID}}
でプラットフォームの金融口座の詳細を直接取得することができます。
FinancialAccount
オブジェクトは、残高と保留中の取引の残高を含む、金融口座を定義するデータを表示します。
プラットフォームの金融口座機能を取得する
GET /v1/treasury/financial_accounts/{{FINANCIALACCOUNT_ID}}/features
を使用して、プラットフォームの金融口座機能の情報を取得できます。
成功すると、レスポンスには、プラットフォームの金融口座に割り当てられた機能がリストされています。
{ "object": "treasury.financial_account_features", "card_issuing": { "requested": true, "status": "active", "status_details": [] }, "deposit_insurance": { "requested": true, "status": "active",
プラットフォームの Treasury 金融口座と連結アカウントの Treasury 金融口座の間で資金を移動する
stripe
ネットワーク上で OutboundPayments
を使用して、プラットフォームの Treasury 金融口座と、同じプラットフォームに関連付けられた連結アカウントの Treasury 金融口座の間で資金を即座に移動します。詳細については、金融口座に対する OutboundPayment を作成するをご覧ください。