Stripe Connect のテスト

本番環境に移行する前に、アカウント作成、本人確認、入金を対象に Connect の組み込みをテストします。

Connect の機能が各フローを正しく処理しているか、テストで確認します。サンドボックスでは、Stripe が提供する特別なトークンをテストで使用して、本番環境の動作をシミュレートできます。支払いや不審請求の申し立てなどのテストについては、支払いテストガイドをご確認ください。

テスト用アカウントを作成する

テスト対象の複数のテストアカウントを、さまざまなアカウントタイプまたはコントローラープロパティで作成できます。

テストアカウントは、Accounts API を使用して、または Stripe ダッシュボードで作成できます。

指示に従って、000-000 をテストアカウントの SMS コードとして使用します。

OAuth フローをテストする

テスト用の client_id を使用して、Stripe ダッシュボードを使用する連結アカウントと OAuth の連携をテストできます。

テスト用の client_id は ca_FkyHCg7X8mlvCUdMDao4mMxagUfhIwXb です。これは、Connect OAuth 設定で確認できます。

テスト用の client_id を使用して、以下の操作を実行できます。

redirect_uri を HTTPS ではない URL に設定する
redirect_uri を localhost に設定する
アカウント申請書をすべて記入する代わりに、アカウントフォームを強制的にスキップする (Stripe ダッシュボードアカウントのみ)
連結アカウントのテスト用アクセストークンを取得する

OAuth フローをテストするには、OAuth リンクをクリックしてから新しいアカウントを作成します。また、メールアドレスとプラットフォームアカウントが異なっていれば、既存の Stripe アカウントの連結をテストすることもできます。

本人確認

テスト用の連結アカウントを作成したら、トークンを使用してさまざまな本人確認ステータスをテストし、多様な要件やアカウントの状態に対応していることを確認します。テストアカウントで本人確認をテストするには、以下のトークンを使用できます。

生年月日のテスト

以下の生年月日 (DOB) を使用して、特定の確認条件をトリガーします。

生年月日	タイプ
`1901-01-01`	Successful date of birth match. Any other DOB results in a no-match.
`1902-01-01`	Successful, immediate date of birth match. The verification result is returned directly in the response, not as part of a webhook event.
`1900-01-01`	この DOB は、外国資産管理局 (OFAC) のアラートをトリガーします。

住所のテスト

line1 に以下の住所を使用して、特定の確認条件をトリガーします。引数 city、state、および postal_code に正当な値を渡す必要があります。

トークン	タイプ
`address_full_match`	Successful address match.
`address_full_match_sync`	Successful, immediate address match.
`address_no_match`	Unsuccessful address match likely to trigger requirements in `currently_due`.
`address_line1_no_match`	Unsuccessful address match likely to trigger requirements in `currently_due`

身分証明書番号のテスト

以下の身分証明書番号を、Account の individual.id_number 属性または Person オブジェクトの id_number 属性に使用して、特定の確認条件をトリガーします。

番号	タイプ
`000000000`	Successful ID number match. 0000 also works for SSN last 4 verification.
`111111111`	Unsuccessful ID number match (identity mismatch) likely to trigger requirements in `currently_due`.
`222222222`	Successful, immediate ID number match. The verification result is returned directly in the response, not as part of a webhook event.

本人確認書類のテスト

テストには、自身の身分証明書をアップロードする代わりにテスト用の画像またはファイルトークンを使用します。詳細については、ファイルのアップロードを参照してください。

書類上の画像のテスト

You can use a verified image that causes the ID number to match successfully. You can use an unverified image that causes a mismatch on the ID number, leading to currently_due requirements.

注

Test images take precedence over test ID numbers. If you upload a verified image, the ID number matching succeeds, even if you also provide an unsuccessful test ID value. Similarly, an unverified image automatically fails ID matching regardless of the value of other test artifacts.

ファイルトークンのテスト

以下のファイルトークンを使用して、特定の本人確認条件をトリガーします。

トークン	タイプ
`file_identity_document_success`	確認済みの画像を使用して、その書類の要件が満たされていることをマークします。
`file_identity_document_failure`	未確認の画像を使用して、その書類の要件が満たされていないことをマークします。

ビジネス情報の確認

ビジネスの住所の確認

一部の国では、連結アカウントで支払い、入金、またはその両方を有効にする前に、連結アカウントに関連付けられたビジネスの住所を確認する必要があります。

ビジネスの住所のテスト

line1 に以下の住所を使用して、特定の確認条件をトリガーします。引数 city、state、および postal_code に正当な値を渡す必要があります。

まず、テストを行う検証条件の許容レベルが最小である住所トークンから始めます。これは、以前に使用したトークンよりも制限の厳しい検証条件を持つ住所トークンを使用できないためです。たとえば、支払いと入金のいずれも有効になるように address_full_match を指定した場合、後でトークンを無効なトークンに変更して入金や支払いを無効化することはできません。この問題を解決するには、関連するトークンを使用して、新しいアカウントを作成します。

トークン	タイプ
`address_full_match`	このアカウントでは、支払いと入金のいずれも有効になっています。
`address_no_match`	このアカウントでは、支払いのみが有効になっています。`line1` 属性で検証に失敗したため、requirements ハッシュに再度表示されます。
`address_line1_no_match`	このアカウントでは、支払いと入金のいずれも有効になっていません。検証に失敗したため、住所属性が requirements ハッシュに再度表示されます。

ビジネスの納税番号のテスト

以下のビジネスの納税者番号をcompany.tax_id に使用して、特定の確認条件をトリガーします。テストの動作は、連結アカウントの国とそれらの国の規制に応じて異なる場合があります。国の規制によっては、これらの国で有効な税務書類があれば、納税者番号を確認済みとしてマークすることができます。

番号	タイプ
`000000000`	Successful business ID number match.
`000000001`	Successful business ID number match as a non-profit.
`111111111`	Unsuccessful business ID number match (identity mismatch).
`111111112`	Unsuccessful business ID number match (tax ID not issued).
`222222222`	Successful, immediate business ID number match. The verification result is returned directly in the response, not as part of a webhook event.

管理者確認をテストする

Stripe は、現地の登記簿から取得したリストと Account オブジェクトのリストを比較して、取締役の確認を行います。お客様の国で確認が必要な場合は、関連付けられた Person の first_name 属性にこれらのトークンを使用し、Person の relationship.director 属性を true に設定して、Account オブジェクトの確認をトリガーできます。

トークン	タイプ
`mismatch_director`	Unsuccessful match due to a mismatched name. This can trigger a `verification_directors_mismatch` verification error.
`missing_director`	Unsuccessful match due to directors missing on the account. This can trigger a `verification_missing_directors` verification error.
`extraneous_director`	Unsuccessful match due to too many directors on the account. This can trigger a `verification_extraneous_directors` verification error.

確認エラーは、Account オブジェクトの複数の取締役がこれらのマジックトークンを使用するとトリガーされます。

会社名の確認をテストする

company.name 属性で次のトークンを使用して、Account オブジェクトの会社名の確認をトリガーします。

トークン	タイプ
`mismatch_business_name`	Unsuccessful match due to a mismatched business name.
`disallowed_name`	Unsuccessful match due to a generic or well-known business name.
`match_name_relationships`	Successful match of the business name.
`match_name_only`	Unsuccessful match due to a business name discrepancy.

明細書表記の確認をテストする

settings.payments.statement_descriptor 属性で次のトークンを使用して、Account オブジェクトの明細書表記の確認をトリガーします。

トークン	タイプ
`mismatch`	`invalid_statement_descriptor_business_mismatch` 確認エラーをトリガーします。
`disallowed`	`invalid_statement_descriptor_denylisted` 確認エラーをトリガーします。

settings.card_payments.statement_descriptor_prefix 属性で次のトークンを使用して、Account オブジェクトの明細書表記のプレフィックスの確認をトリガーします。

トークン	タイプ
`mismatch`	`invalid_statement_descriptor_prefix_mismatch` 確認エラーをトリガーします。
`disallowed`	`invalid_statement_descriptor_prefix_denylisted` 確認エラーをトリガーします。

ビジネス URL の確認をテストする

business_profile.url 属性で次のトークンを使用して、Account オブジェクトの URL の確認をトリガーします。

トークン	タイプ
`https://disallowed.stripe.com`	`invalid_url_denylisted` 確認エラーをトリガーします。
`https://geoblocked.stripe.com`	確認エラー `invalid_url_website_inaccessible_geoblocked` をトリガーします。
`https://problem.stripe.com`	`invalid_url_website_other` 確認エラーをトリガーします。
`https://missing.stripe.com`	`invalid_url_website_incomplete` 確認エラーをトリガーします。
`https://mismatch.stripe.com`	`invalid_url_website_business_information_mismatch` 確認エラーをトリガーします。
`https://passwordprotected.stripe.com`	確認エラー `invalid_url_website_inaccessible_password_protected` をトリガーします。
`https://accessible.stripe.com`	URL の検証の成功をトリガーします。
`https://underconstruction.stripe.com`	確認エラー `invalid_url_website_incomplete_under_construction` をトリガーします。
`https://inaccessible.stripe.com`	`invalid_url_website_inaccessible` 確認エラーをトリガーします。

商号 (DBA) の確認をテストする

business_profile.name 属性で次のトークンを使用して、Account オブジェクトの DBA の確認をトリガーします。

トークン	タイプ
`disallowed_dba`	`invalid_business_profile_name_denylisted` 確認エラーをトリガーします。
`invalid_dba`	`invalid_business_profile_name` 確認エラーをトリガーします。

商品の説明の確認をテストする

business_profile.product_description 属性で次のトークンを使用して、Account オブジェクトの商品説明の確認をトリガーします。

トークン	タイプ
`require_url`	`invalid_url_web_presence_detected` 確認エラーをトリガーします。

電話番号認証をテストする

Account オブジェクトの電話番号認証をクリアするには、次の属性にこのトークンを使用します。

このトークンを phone 属性で使用して、Person オブジェクトの電話番号認証をクリアします。

トークン	タイプ
`0000000000`	検証の成功

Test ケイパビリティが無効になった理由

アカウントの business_profile.url 属性に次のトークンを使用して、特定の requirements.disabled_reason をすべての Account オブジェクトの無効な Capability オブジェクトに割り当てます。

トークン	タイプ
`https://inactivity.stripe.com`	アカウントを非アクティブに設定し、そのアカウントに対するすべての確認を一時停止します。非アクティブなケイパビリティの無効の理由を `paused.inactivity` (`2024-06-20` より前の API バージョンの場合は `rejected.other`) に設定します。

確認をトリガーするか、先に進める

トリガーカード

以下のカード番号を使用して、要件と階層別確認のテストを行う際のさまざまな条件をトリガーします。トリガーアクションを有効にするには、on_behalf_of を設定して、これらのカードを Connect の支払いで使用するか、連結アカウントで直接支払いを作成する必要があります。

番号	トークン	タイプ
4000000000004202	`tok_visa_triggerNextRequirements`	最終的に期限が到来することになる次の一連の要件を、現在期日が到来している状態に変更します。
4000000000004210	`tok_visa_triggerChargeBlock`	支払いブロックをトリガーします。
4000000000004236	`tok_visa_triggerPayoutBlock`	入金ブロックをトリガーします。

後続の要件をトリガーする

本番環境では、連結アカウントが一定の金額を処理すると、追加の確認情報が必要になる場合があります。このカードは、必要な追加の確認情報をすぐに設定します。追加情報が必要ない場合は、何も表示されません。

支払いブロックまたは入金ブロックをトリガーする

期日までに必要な情報が提供されなかった場合、Stripe は連結アカウントの支払いや入金を無効にします。これらのカードによって連結アカウントが無効になり、現在期日を迎えている要件はすべて期限切れに移行されます。アカウントから支払いや入金を有効にするために必要な初期情報が提供されるまで、カードは機能しません。

銀行口座の所有権の確認をトリガーする

アメリカとインドの連結アカウントは、銀行口座の所有権の確認の対象となります。この確認は、Connect ダッシュボードを使用するか、API で documents[bank_account_ownership_verification] ハッシュを使用して、裏付けとなる書類をアップロードして実行します。

テスト中に、アメリカの銀行口座の保有者確認プロセスをシミュレートできます。次のテスト用銀行口座番号を使用して、確認プロセスを開始します。番号の 1 つは確認の成功をシミュレートするものであり、もう 1 つの番号は確認プロセスの完了に必要なテスト画像またはファイルトークンのアップロード要求をシミュレートするものです。これらのテストアカウントは、アメリカのアカウントのみ使用できます。

ルーティング	アカウント	タイプ
`110000000`	`000999999991`	少しの遅延の後、銀行口座の所有権の確認プロセスを起動し、完了します
`110000000`	`000999999992`	少し遅れて銀行口座の所有権確認プロセスがトリガーされ、書類のアップロードを要求します。

Stripe 残高に資金を追加する

ダッシュボードで銀行口座から Stripe 残高への資金の追加をテストするには、サンドボックスを作成し、残高に追加ダイアログ内のドロップダウンメニューからテストしたい銀行口座を選択します。残高不足による成功または失敗をシミュレートできます。

API で資金の追加をテストするには、テスト中に次のテスト用銀行トークンをソースとして使用します。各トークンは、特定の種類のイベントをシミュレートします。

トークン	タイプ
`btok_us_verified`	成功
`btok_us_verified_noAccount`	`no_account` コードで失敗
`btok_us_verified_accountClosed`	`account_closed` コードで失敗
`btok_us_verified_insufficientFunds`	`insufficient_funds` コードで失敗
`btok_us_verified_debitNotAuthorized`	`debit_not_authorized` コードで失敗
`btok_us_verified_invalidCurrency`	`invalid_currency` コードで失敗

入金

次のテスト用の銀行番号とデビットカード番号を使用して、入金のテスト中に特定のイベントをトリガーします。これらの番号は、テスト用の秘密鍵でテストする場合にのみ使用できます。

テスト入金は、本番環境での入金をシミュレートしますが、銀行では処理されません。Stripe ダッシュボードにアクセスできるテストアカウントでは、有効な外部銀行情報とその他の関連条件が満たされている限り、入金は常に有効となり、実際の本人確認も必要ありません。

注

本番環境の連結アカウントの Stripe ダッシュボードでテスト用の銀行番号とデビットカード番号を使用することはできません。本番環境のアカウントに銀行口座情報を入力した場合でも、サンドボックスを使用することが可能です。テスト入金では実際の資金を扱わずに本番環境での入金をシミュレートできます。

銀行口座番号

以下のテスト用の銀行口座番号を使用して、入金をテストします。これらの銀行口座番号には、テスト用のシークレットキーのみを使用できます。

金融番号	口座	Type
`110000000`	`000123456789`	入金は成功します。
`110000000`	`000111111116`	入金は `no_account` コードで失敗します。
`110000000`	`000111111113`	入金は `account_closed` コードで失敗します。
`110000000`	`000222222227`	入金は `insufficient_funds` コードで失敗します。
`110000000`	`000333333335`	入金は `debit_not_authorized` コードで失敗します。
`110000000`	`000444444440`	入金は `invalid_currency` コードで失敗します。
`110000000`	`000888888883`	`method` が `instant` の場合、入金は失敗します。銀行口座は Instant Payouts には使用できません。

デビットカード番号

以下のテスト用のデビットカード番号を使用して、デビットカードへの入金をテストします。これらのカード番号は、テスト用のシークレットキーとのみ併用できます。

番号	トークン	タイプ
4000056655665556	`tok_visa_debit_us_transferSuccess`	Visa デビット。入金は成功します。
4000056655665572	`tok_visa_debit_us_transferFail`	Visa デビット。入金は `could_not_process` コードで失敗します。
4000056755665555	`tok_visa_debit_us_instantPayoutUnsupported`	Visa デビット。このカードは Instant Payouts の利用対象ではありません。
5200828282828210	`tok_mastercard_debit_us_transferSuccess`	Mastercard デビット。入金は成功します。
6011981111111113	`tok_discover_debit_us_transferSuccess`	ディスカバーデビット。入金は成功します。