Stripe Connect のテスト

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

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

You can create multiple test accounts with different account types or controller properties that you want to test.

You can create test accounts using the Accounts API or in the Stripe Dashboard.

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

OAuth フローをテストする

You can test your OAuth integration with connected accounts that use a Stripe-hosted Dashboard using your test client_id.

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

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

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

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

本人確認

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

生年月日のテスト

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

住所のテスト

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

身分証明書番号のテスト

Use these personal ID numbers for the individual.id_number attribute on the Account or the id_number attribute on the Person object to trigger certain verification conditions.

本人確認書類のテスト

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

書類上の画像のテスト

確認済みの画像を使用すると、ユーザは自動的に verified とマークされます。未確認の画像を使用すると、ユーザは自動的に unverified とマークされます。

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

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

ビジネス情報の確認

ビジネスの住所の確認

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

ビジネスの住所のテスト

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

Make sure you start with an address token that has the least permissive validation condition you want to test for. This is because you can’t use an address token that has a more restrictive validation condition than the previous token used. For example, if you provided address_full_match to have both charges and payouts enabled, you can’t disable payouts or charges afterward by changing the token to an invalid one. You can work around this by creating a new account with the relevant token.

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

Use these business tax ID numbers for company.tax_id to trigger certain verification conditions. The test behavior might change depending on the Connected Account countries and the regulations in those countries. Depending on the country’s regulation, a valid tax document can mark tax ID verified in these countries.

管理者確認をテストする

Stripe performs directorship verification by comparing the list of directors on the Account object against a list retrieved from local registries. If the country requires it, you can trigger verification for an Account object by using these tokens for the first_name attribute on the associated Person and setting the relationship.director attribute on the Person to true.

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

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

Trigger company name verification for an Account object by using this token for the company.name attribute.

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

Trigger statement descriptor verification for an Account object by using this token for the settings.payments.statement_descriptor attribute.

Trigger statement descriptor prefix verification for an Account object by using this token for the settings.card_payments.statement_descriptor_prefix attribute.

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

Trigger URL verification for an Account object by using this token for the business_profile.url attribute.

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

Trigger DBA verification for an Account object by using this token for the business_profile.name attribute.

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

Trigger product description verification for an Account object by using this token for the business_profile.product_description attribute.

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

Clear phone number validation for an Account object by using this token for the following attributes:

• business_profile.support_phone
• company.phone
• individual.phone

Clear phone number validation for a Person object by using this token for the phone attribute.

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

Trigger assignment of a specific requirements.disabled_reason to all of an Account object’s inactive Capability objects by using this token for the account’s business_profile.url attribute.

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

トリガーカード

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

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

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

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

If required information isn’t provided by the deadline, Stripe disables the connected account’s charges or payouts. These cards disable the connected account and move any currently due requirements to overdue. These cards have no effect until an account provides the initial information that’s required to enable charges and payouts.

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

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 つの番号は確認プロセスの完了に必要なテスト画像またはファイルトークンのアップロード要求をシミュレートするものです。これらのテストアカウントは、アメリカのアカウントのみ使用できます。

要件をシミュレーションする

プラットフォームに複数の国の連結アカウントがある場合、または今後そうする計画がある場合、国によっては本人確認だけでなく住所の確認も必要になることがあります。Stripe では、この要件をテストできるように、サンプルの生年月日 (DOB) とサンプルの住所を用意しています。

Stripe 残高に資金を追加する

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

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

入金

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

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

銀行口座番号

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

デビットカード番号

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