金融口座の組み込みをテストする

金融口座が正しく機能していることを確認する方法をご紹介します。

Stripe Treasury には本番環境とテスト環境があります。ダッシュボードの右上隅にある切り替え機能を使用し、モードを切り替えることができます。

テスト環境の切り替え

注

本番環境の金融口座にアクセスするには、Treasury への API アクセスを獲得するガイドの本番環境ステップを完了する必要があります。

API でテスト環境にアクセスするには、リクエストでテスト環境用の API キーを使用します。テスト環境用 API キーは、大半のドキュメントのコード例に含まれていますが、ダッシュボードの開発者ページにもあります。テストには、本番キーではなく、必ずテストキーを使用してください。テストキーは sk_test_xxx の形式で、本番キーは sk_live_xxx の形式です。

テスト用の金融口座を作成する前に、POST /v1/accounts を使用してテスト用の連結アカウントを作成します。レスポンスで受け取った連結アカウント ID を使用し、次のステップで作成する金融口座をこのアカウントに割り当てます。Treasury はアメリカのみでサポートされているため、country パラメーターに US を指定します。Treasury が正しく機能するために必要な、連結アカウントのケイパビリティもリクエストします。レスポンスの id 値をメモしておいてください。前述のように、以下のコード例では、その ID を Stripe-Account ヘッダーの値として使用します。

成功すると、新しい連結アカウントの Account (アカウント) オブジェクトがレスポンスで返されます。

{
  "id": "{{CUSTOM_ACCOUNT_ID}}",
  "livemode": false,
  ...
}

次に、POST /v1/treasury/financial_accounts を使用して金融口座を作成します。前の手順で作成した連結アカウントの ID の値に設定した Stripe-Account ヘッダーを含めます。本文で唯一必要なのは、supported_currencies[] を usd に設定することです。金融口座の詳細については、金融口座を使用する、または Stripe API リファレンスの FinancialAccounts オブジェクトの説明をご覧ください。

成功すると、新しく作成された FinancialAccount オブジェクトがレスポンスで返されます。

{
  "id": "{{FINANCIAL_ACCOUNT_ID}}",
  "livemode": false,
  "active_features": [],
  "pending_features": [],
  "restricted_features": ["financial_addresses.aba"],
  ...
}

これで、テスト環境の連結アカウントに関連付けられた、テスト環境の金融口座ができました。ただし、その連結アカウントはまだアカウント登録されていないため、requirements ハッシュに必須情報がありません。前の手順の JSON レスポンスの金融口座 ID を使用して GET /v1/treasury/financial_accounts/{{FINANCIAL_ACCOUNT_ID}} を呼び出すと、ハッシュの financial_addresses 配列に、リクエストされた aba が restricted の status で含まれています。これは、連結アカウントに requirements_past_due があるためです。

{
  …
  "financial_addresses": {
    "aba": {
      "requested": true,
      "status": "restricted",
      "status_details": [
        {
          "code": "requirements_past_due",
          "resolution": "provide_information"
        }
      ]
    }
  }
  …
}

連結アカウントのアカウント登録を済ませる前に、テスト環境の金融口座でリクエストされた機能を有効にするには、以前に作成した連結アカウントを使用して必要とされるアカウント詳細を適用する次のリクエストのように、POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} を使用して、必要なすべての要件を満たすテスト値を提供する必要があります。

注

本番環境の連結アカウントに関連付けられた、テスト環境の金融口座を作成することはできません。