Stripe Connect のテスト
本番環境に移行する前に、アカウント作成、本人確認、入金を対象に Connect の組み込みをテストします。
Connect の機能が各フローを正しく処理しているか、テストで確認します。サンドボックスでは、Stripe が提供する特別なトークンをテストで使用して、本番環境の動作をシミュレートできます。支払いや不審請求の申し立てなどのテストについては、支払いテストガイドをご確認ください。
ケイパビリティのテスト
Sandboxes and test mode might not enforce some capabilities. In certain cases, they can allow an account to perform capability-dependent actions even when the associated capability’s status
isn’t active
.
テスト用アカウントを作成する
アカウントタイプまたはコントローラープロパティが異なるをテストできます。
テストアカウントは、Accounts API を使用して、または Stripe ダッシュボードで作成できます。
指示に従って、000-000
をテストアカウントの SMS コードとして使用します。
OAuth フローをテストする
テスト用の client_
を使用して、Stripe ダッシュボードを使用する連結アカウントと OAuth の連携をテストできます。
テスト用の client_
は ca_
です。これは、Connect OAuth 設定で確認できます。
テスト用の client_
を使用して、以下の操作を実行できます。
redirect_
を HTTPS ではない URL に設定するuri redirect_
を localhost に設定するuri - アカウント申請書をすべて記入する代わりに、アカウントフォームを強制的にスキップする (Stripe ダッシュボードアカウントのみ)
- 連結アカウントのテスト用アクセストークンを取得する
OAuth フローをテストするには、OAuth リンクをクリックしてから新しいアカウントを作成します。また、メールアドレスとプラットフォームアカウントが異なっていれば、既存の Stripe アカウントの連結をテストすることもできます。
本人確認
テスト用の連結アカウントを作成したら、トークンを使用してさまざまな本人確認ステータスをテストし、多様な要件やアカウントの状態に対応していることを確認します。テストアカウントで本人確認をテストするには、以下のトークンを使用できます。
生年月日のテスト
以下の生年月日 (DOB) を使用して、特定の確認条件をトリガーします。
生年月日 | タイプ |
---|---|
1901-01-01 | 生年月日の照合に成功しました。それ以外の DOB は一致しません。 |
1902-01-01 | 生年月日の即時照合に成功しました。確認結果は、Webhook イベントの一部としてではなく、レスポンスで直接返されます。 |
1900-01-01 | この DOB は、外国資産管理局 (OFAC) のアラートをトリガーします。 |
住所のテスト
line1
に以下の住所を使用して、特定の確認条件をトリガーします。引数 city
、state
、および postal_
に正当な値を渡す必要があります。
トークン | タイプ |
---|---|
address_ | 住所の照合に成功しました。 |
address_ | 住所の即時照合に成功しました。 |
address_ | 住所の照合失敗により、currently_ の要件がトリガーされる可能性が高くなります。 |
address_ | 住所の照合失敗により、currently_ の要件がトリガーされる可能性が高くなります |
身分証明書番号のテスト
以下の身分証明書番号を、Account
の individual.id_number 属性または Person
オブジェクトの id_number 属性に使用して、特定の確認条件をトリガーします。
番号 | タイプ |
---|---|
000000000 | 登録番号の照合に成功しました。SSN の末尾 4 桁の確認には、0000 も使用できます。 |
111111111 | 登録番号の照合失敗 (本人確認情報の不一致) により、currently_ の要件がトリガーされる可能性が高くなります。 |
222222222 | 登録番号の即時照合に成功しました。確認結果は、Webhook イベントの一部としてではなく、レスポンスで直接返されます。 |
本人確認書類のテスト
テストには、自身の身分証明書をアップロードする代わりにテスト用の画像またはファイルトークンを使用します。詳細については、ファイルのアップロードを参照してください。
書類上の画像のテスト
確認済みの画像を使用すると、登録番号が正常に一致します。未確認の画像を使用すると、登録番号の不一致が発生し、currently_
要件が発生する可能性があります。
注
テスト用の画像はテスト用の登録番号よりも優先されます。確認済みの画像をアップロードすると、失敗したテスト登録番号値を指定していても、登録番号の照合は成功します。同様に、未確認の画像は、他のテストアーティファクトの値に関係なく、自動的に登録番号の照合に失敗します。
ファイルトークンのテスト
以下のファイルトークンを使用して、特定の本人確認条件をトリガーします。
トークン | タイプ |
---|---|
file_ | 確認済みの画像を使用して、その書類の要件が満たされていることをマークします。 |
file_ | 未確認の画像を使用して、その書類の要件が満たされていないことをマークします。 |
ビジネス情報の確認
ビジネスの住所の確認
一部の国では、連結アカウントで支払い、入金、またはその両方を有効にする前に、連結アカウントに関連付けられたビジネスの住所を確認する必要があります。
ビジネスの住所のテスト
line1
に以下の住所を使用して、特定の確認条件をトリガーします。引数 city
、state
、および postal_
に正当な値を渡す必要があります。
まず、テストを行う検証条件の許容レベルが最小である住所トークンから始めます。これは、以前に使用したトークンよりも制限の厳しい検証条件を持つ住所トークンを使用できないためです。たとえば、支払いと入金のいずれも有効になるように address_
を指定した場合、後でトークンを無効なトークンに変更して入金や支払いを無効化することはできません。この問題を解決するには、関連するトークンを使用して、新しいアカウントを作成します。
トークン | タイプ |
---|---|
address_ | このアカウントでは、支払いと入金のいずれも有効になっています。 |
address_ | このアカウントでは、支払いのみが有効になっています。line1 属性で検証に失敗したため、requirements ハッシュに再度表示されます。 |
address_ | このアカウントでは、支払いと入金のいずれも有効になっていません。検証に失敗したため、住所属性が requirements ハッシュに再度表示されます。 |
ビジネスの納税番号のテスト
以下のビジネスの納税者番号をcompany.tax_id に使用して、特定の確認条件をトリガーします。テストの動作は、連結アカウントの国とそれらの国の規制に応じて異なる場合があります。国の規制によっては、これらの国で有効な税務書類があれば、納税者番号を確認済みとしてマークすることができます。
番号 | タイプ |
---|---|
000000000 | 事業登録番号の照合に成功しました。 |
000000001 | 事業登録番号の照合に成功しました (非営利として)。 |
111111111 | 事業登録番号の照合に失敗しました (登録番号の不一致)。 |
111111112 | 事業登録番号の照合に失敗しました (納税者番号が未発行)。 |
222222222 | 事業登録番号の即時照合に成功しました。確認結果は、Webhook イベントの一部としてではなく、レスポンスで直接返されます。 |
管理者確認をテストする
Stripe は、現地の登記簿から取得したリストと Account
オブジェクトのリストを比較して、取締役の確認を行います。お客様の国で確認が必要な場合は、関連付けられた Person
の first_name 属性にこれらのトークンを使用し、Person
の relationship.director 属性を true に設定して、Account
オブジェクトの確認をトリガーできます。
トークン | タイプ |
---|---|
mismatch_ | 氏名不一致が原因で、照合に失敗しました。これにより、verification_ 確認エラーがトリガーされることがあります。 |
missing_ | アカウントの取締役不在が原因で、照合に失敗しました。これにより、verification_ 確認エラーがトリガーされることがあります。 |
extraneous_ | アカウントの取締役過多が原因で、照合に失敗しました。これにより、verification_ 確認エラーがトリガーされることがあります。 |
確認エラーは、Account
オブジェクトの複数の取締役がこれらのマジックトークンを使用するとトリガーされます。
会社名の確認をテストする
company.name 属性で次のトークンを使用して、Account
オブジェクトの会社名の確認をトリガーします。
トークン | タイプ |
---|---|
mismatch_ | ビジネス名不一致が原因で、照合に失敗しました。 |
disallowed_ | 汎用的なビジネス名またはよく知られているビジネス名が原因で、照合に失敗しました。 |
match_ | ビジネス名の照合に成功しました。 |
match_ | ビジネス名食い違いが原因で、照合に失敗しました。 |
明細書表記の確認をテストする
settings.payments.statement_descriptor 属性で次のトークンを使用して、Account
オブジェクトの明細書表記の確認をトリガーします。
トークン | タイプ |
---|---|
mismatch | invalid_ 確認エラーをトリガーします。 |
disallowed | invalid_ 確認エラーをトリガーします。 |
settings.card_payments.statement_descriptor_prefix 属性で次のトークンを使用して、Account
オブジェクトの明細書表記のプレフィックスの確認をトリガーします。
トークン | タイプ |
---|---|
mismatch | invalid_ 確認エラーをトリガーします。 |
disallowed | invalid_ 確認エラーをトリガーします。 |
ビジネス URL の確認をテストする
business_profile.url 属性で次のトークンを使用して、Account
オブジェクトの URL の確認をトリガーします。
トークン | タイプ |
---|---|
https://disallowed. | invalid_ 確認エラーをトリガーします。 |
https://geoblocked. | 確認エラー invalid_ をトリガーします。 |
https://problem. | invalid_ 確認エラーをトリガーします。 |
https://missing. | invalid_ 確認エラーをトリガーします。 |
https://mismatch. | invalid_ 確認エラーをトリガーします。 |
https://passwordprotected. | 確認エラー invalid_ をトリガーします。 |
https://accessible. | URL の検証の成功をトリガーします。 |
https://underconstruction. | 確認エラー invalid_ をトリガーします。 |
https://inaccessible. | invalid_ 確認エラーをトリガーします。 |
Test ケイパビリティが無効になった理由
アカウントの business_profile.url 属性に次のトークンを使用して、特定の requirements.disabled_reason をすべての Account
オブジェクトの無効な Capability
オブジェクトに割り当てます。
トークン | タイプ |
---|---|
https://inactivity. | アカウントを非アクティブに設定し、そのアカウントに対するすべての確認を一時停止します。非アクティブなケイパビリティの無効の理由を paused. (2024-06-20 より前の API バージョンの場合は rejected. ) に設定します。 |
商号 (DBA) の確認をテストする
business_profile.name 属性で次のトークンを使用して、Account
オブジェクトの DBA の確認をトリガーします。
トークン | タイプ |
---|---|
disallowed_ | invalid_ 確認エラーをトリガーします。 |
invalid_ | invalid_ 確認エラーをトリガーします。 |
商品の説明の確認をテストする
business_profile.product_description 属性で次のトークンを使用して、Account
オブジェクトの商品説明の確認をトリガーします。
トークン | タイプ |
---|---|
require_ | invalid_ 確認エラーをトリガーします。 |
電話番号認証をテストする
Account
オブジェクトの電話番号認証をクリアするには、次の属性にこのトークンを使用します。
このトークンを phone 属性で使用して、Person
オブジェクトの電話番号認証をクリアします。
トークン | タイプ |
---|---|
0000000000 | 検証の成功 |
確認をトリガーするか、先に進める
トリガーカード
以下のカード番号を使用して、要件と階層別確認のテストを行う際のさまざまな条件をトリガーします。トリガーアクションを有効にするには、on_behalf_of を設定して、これらのカードを Connect の支払いで使用するか、連結アカウントで直接支払いを作成する必要があります。
番号 | トークン | タイプ |
---|---|---|
4000000000004202 | tok_ | 最終的に期限が到来することになる次の一連の要件を、現在期日が到来している状態に変更します。 |
4000000000004210 | tok_ | 支払いブロックをトリガーします。 |
4000000000004236 | tok_ | 入金ブロックをトリガーします。 |
後続の要件をトリガーする
本番環境では、連結アカウントが一定の金額を処理すると、追加の確認情報が必要になる場合があります。このカードは、必要な追加の確認情報をすぐに設定します。追加情報が必要ない場合は、何も表示されません。
支払いブロックまたは入金ブロックをトリガーする
期日までに必要な情報が提供されなかった場合、Stripe は連結アカウントの支払いや入金を無効にします。これらのカードによって連結アカウントが無効になり、現在期日を迎えている要件はすべて期限切れに移行されます。アカウントから支払いや入金を有効にするために必要な初期情報が提供されるまで、カードは機能しません。
銀行口座の所有権の確認をトリガーする
アメリカとインドの連結アカウントは、銀行口座の所有権の確認の対象となります。この確認は、Connect ダッシュボードを使用するか、API で documents[bank_account_ownership_verification] ハッシュを使用して、裏付けとなる書類をアップロードして実行します。
テスト中に、アメリカの銀行口座の保有者確認プロセスをシミュレートできます。次のテスト用銀行口座番号を使用して、確認プロセスを開始します。番号の 1 つは確認の成功をシミュレートするものであり、もう 1 つの番号は確認プロセスの完了に必要なテスト画像またはファイルトークンのアップロード要求をシミュレートするものです。これらのテストアカウントは、アメリカのアカウントのみ使用できます。
ルーティング | アカウント | タイプ |
---|---|---|
110000000 | 000999999991 | 少しの遅延の後、銀行口座の所有権の確認プロセスを起動し、完了します |
110000000 | 000999999992 | 少し遅れて銀行口座の所有権確認プロセスがトリガーされ、書類のアップロードを要求します。 |
Stripe 残高に資金を追加する
ダッシュボードで銀行口座から Stripe 残高への資金の追加をテストするには、サンドボックスを作成し、残高に追加ダイアログ内のドロップダウンメニューからテストしたい銀行口座を選択します。残高不足による成功または失敗をシミュレートできます。
API で資金の追加をテストするには、テスト中に次のテスト用銀行トークンをソースとして使用します。各トークンは、特定の種類のイベントをシミュレートします。
トークン | タイプ |
---|---|
btok_ | 成功 |
btok_ | no_ コードで失敗 |
btok_ | account_ コードで失敗 |
btok_ | insufficient_ コードで失敗 |
btok_ | debit_ コードで失敗 |
btok_ | invalid_ コードで失敗 |
入金
次のテスト用の銀行番号とデビットカード番号を使用して、入金のテスト中に特定のイベントをトリガーします。これらの番号は、テスト用の秘密鍵でテストする場合にのみ使用できます。
テスト入金は、本番環境での入金をシミュレートしますが、銀行では処理されません。Stripe ダッシュボードにアクセスできるテストアカウントでは、有効な外部銀行情報とその他の関連条件が満たされている限り、入金は常に有効となり、実際の本人確認も必要ありません。
注
本番環境の連結アカウントの Stripe ダッシュボードでテスト用の銀行番号とデビットカード番号を使用することはできません。本番環境のアカウントに銀行口座情報を入力した場合でも、サンドボックスを使用することが可能です。テスト入金では実際の資金を扱わずに本番環境での入金をシミュレートできます。
銀行口座番号
以下のテスト用の銀行口座番号を使用して、入金をテストします。これらの銀行口座番号には、テスト用のシークレットキーのみを使用できます。
デビットカード番号
以下のテスト用のデビットカード番号を使用して、デビットカードへの入金をテストします。これらのカード番号は、テスト用のシークレットキーとのみ併用できます。