Stripe Connect のテスト
テストを使用して、Connect のシステムがさまざまなフローを適切に処理できることを確認します。テスト環境を使用して、Stripe が提供するテスト用の特別なトークンを利用しながら本番環境をシミュレーションします。支払いや不審請求の申請などのテストについて、詳細は支払いのテストガイドをご覧ください。
テスト用アカウントを作成する
You can create multiple test accounts and use any account type or controller properties you might need (for example, representing multiple countries).
You can create test accounts using the Accounts API or in the Stripe Dashboard.
指示に従って、000-000
をテストアカウントの SMS コードとして使用します。
Test the OAuth flow
You can test your OAuth integration with connected accounts that use a Stripe-hosted dashboard using your test mode client_id
.
Your test mode client_id
is ca_FkyHCg7X8mlvCUdMDao4mMxagUfhIwXb
. You can find this in your Connect OAuth settings.
Your test mode client_id
allows you to:
redirect_uri
を HTTPS ではない URL に設定するredirect_uri
を localhost に設定する- Force-skip the account form instead of having to fill out an entire account application (Stripe Dashboard accounts only)
- 連結アカウントのテスト用アクセストークンを取得する
To test the OAuth flow, create a new account after clicking the OAuth link. You can also test connecting an existing Stripe account only if the email is different from your platform account.
本人確認
After creating a test connected account, you can use tokens to test different verification statuses to make sure you’re handling different requirements and account states. You can use the following tokens to test verification with test accounts.
生年月日のテスト
以下の生年月日 (DOB) を使用して、特定の確認条件をトリガーします。
生年月日 | タイプ |
---|---|
1901-01-01 | 本人確認成功。それ以外の DOB では本人確認は失敗します。 |
1902-01-01 | すぐに本人確認成功。確認結果は、Webhook イベントの一部としてではなく、応答で直接返されます。 |
1900-01-01 | この DOB は、外国資産管理局 (OFAC) のアラートをトリガーします。 |
住所のテスト
line1
に以下の住所を使用して、特定の確認条件をトリガーします。引数 city
、state
、および postal_code
に正当な値を渡す必要があります。
トークン | タイプ |
---|---|
address_full_match | 本人確認成功。 |
address_no_match | 本人確認の失敗。 |
address_line1_no_match | 住所の一部の不一致による本人確認の失敗。 |
身分証明書番号のテスト
以下の身分証明書番号を individual.id_number や、Person
オブジェクトの id_number 属性で使用して、特定の確認条件をトリガーします。
番号 | タイプ |
---|---|
000000000 | 本人確認成功。SSN の末尾 4 桁の確認には、0000 も使用できます。 |
111111111 | 本人確認の失敗 (ID の不一致)。 |
222222222 | すぐに本人確認成功。確認結果は、Webhook イベントの一部としてではなく、応答で直接返されます。 |
本人確認書類のテスト
テストには、自身のテスト用の身分証明書をアップロードする代わりにファイルトークンを使用します。詳細については、ファイルのアップロードを参照してください。
ファイルトークンのテスト
以下のファイルトークンを使用して、特定の本人確認条件をトリガーします。
トークン | タイプ |
---|---|
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 | 本人確認成功。 |
000000001 | 非営利として本人確認成功。 |
100000002 | カナダの登録された慈善機関として本人確認成功。 |
111111111 | 本人確認の失敗 (ID の不一致)。 |
111111112 | 本人確認の失敗 (納税者番号が発行されていない)。 |
222222222 | すぐに本人確認成功。確認結果は、Webhook イベントの一部としてではなく、応答で直接返されます。 |
管理者確認をテストする (カナダのみ)
次のトークンを individual.first_name. 属性で使用し、individual.relationship.director 属性を true に設定して、Account
オブジェクトの管理者の確認をトリガーします。
トークン | タイプ |
---|---|
mismatch_director | 管理者の確認の失敗。 |
会社名の確認をテストする
次のトークンを company.name 属性で使用して Account
オブジェクトの会社名の確認をトリガーします。
トークン | タイプ |
---|---|
mismatch_business_name | ビジネス名の不一致による確認の失敗。 |
disallowed_name | 汎用的なビジネス名またはよく知られているビジネス名による確認の失敗。 |
match_name_relationships | ビジネス名の確認の成功。 |
match_name_only | ビジネス名の不一致による確認の失敗。 |
明細書表記の確認をテストする
次のトークンを settings.payments.statement_descriptor 属性で使用して、Account
オブジェクトの明細書表記の確認をトリガーします。
トークン | タイプ |
---|---|
mismatch | invalid_statement_descriptor_business_mismatch 確認エラーをトリガーします。 |
disallowed | invalid_statement_descriptor_denylisted 確認エラーをトリガーします。 |
次のトークンを settings.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://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://accessible.stripe.com | URL の検証の成功をトリガーします。 |
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 確認エラーをトリガーします。 |
確認をトリガーするか、先に進める
トリガーカード
以下のカード番号を使用して、要件や階層別の確認のテストを行う際のさまざまな条件をトリガーします。トリガーアクションを有効にするには、on_behalf_of
を設定して、これらのカードを Connect の支払いで使用するか、連結アカウントで直接支払いを作成する必要があります。
番号 | トークン | タイプ |
---|---|---|
4000000000004202 | tok_visa_triggerNextRequirements | 今後期日を迎える次の一連の要件を、現在期日がきている状態に変更します。 |
4000000000004210 | tok_visa_triggerChargeBlock | 支払いブロックをトリガーします。 |
4000000000004236 | tok_visa_triggerPayoutBlock | 入金ブロックをトリガーします。 |
後続の要件をトリガーする
本番環境では、連結アカウントが一定の金額を処理すると、追加の確認情報が必要になる場合があります。このカードは、必要な追加の確認情報をすぐに設定します。追加情報が必要ない場合は、何も表示されません。
支払いブロックまたは入金ブロックをトリガーする
期日までに必要な情報が提供されなかった場合、Stripe は連結アカウントの支払いや入金を無効にします。これらのカードによって、連結アカウントは無効になり、現在期日を迎えている要件はすべて期限切れに移行されます。アカウントから支払いや入金を有効にするために必要な初期情報が提供されるまで、カードは機能しません。
銀行口座の所有権の確認をトリガーする
Connected accounts in the United States and India are subject to Bank account ownership verification. You can complete this verification by uploading supporting documents with the Connect Dashboard or with the API through the documents[bank_account_ownership_verification] hash.
テスト環境では、アメリカの銀行口座の所有権を確認するプロセスをシミュレーションできます。以下のテスト用の銀行口座番号を使用して、確認プロセスを開始します。1 つの番号は、確認の成功を前提としています。もう 1 つの番号は、確認プロセスを完了するためにテスト用画像またはファイルトークンをアップロードするように促します。これらのテスト用の口座は、アメリカのアカウントでのみ使用できます。
金融番号 | 口座番号 | タイプ |
---|---|---|
110000000 | 000999999991 | 少しの遅延の後、銀行口座の所有権の確認プロセスを起動し、完了します |
110000000 | 000999999992 | ベータ 少しの遅延の後、銀行口座の所有権の確認プロセスを起動し、ドキュメントの更新をリクエストします |
要件をシミュレーションする
プラットフォームに複数の国の連結アカウントがある場合、または今後そうする計画がある場合、国によっては本人確認だけでなく住所の確認も必要になることがあります。Stripe では、この要件をテストできるように、サンプルの生年月日 (DOB) とサンプルの住所を用意しています。
提供する情報 | 個人の本人確認ステータス | requirements.currently_due |
---|---|---|
確認済みの生年月日と確認済みの住所 | 確認済み | なし |
確認済みの生年月日と未確認の住所 | 未確認 | verification.additional_document |
未確認の生年月日と確認済みの住所 | 未確認 | verification.document |
未確認の生年月日と未確認の住所 | 未確認 | verification.additional_document 、verification.document |
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 コードで失敗 |
Payouts
Use the following test bank and debit card numbers to trigger certain events during payout testing. You can only use these values in test mode with test secret keys.
Test mode payouts simulate a live payout but aren’t processed with the bank. Test mode accounts with Stripe Dashboard access always have payouts enabled, as long as valid external bank information and other relevant conditions are met, and never requires real identity verification.
注
You can’t use test bank and debit card numbers in the Stripe Dashboard on a live mode connected account. If you’ve entered your bank account information on a live mode account, you can still use test mode, and test mode payouts will simulate a live payout without processing actual money.
銀行口座番号
以下のテスト用の銀行口座番号を使用して、入金をテストします。これらの銀行口座番号には、テスト用のシークレットキーのみを使用できます。
デビットカード番号
以下のテスト用のデビットカード番号を使用して、デビットカードへの入金をテストします。これらのカード番号は、テスト用のシークレットキーとのみ併用できます。