コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成
サインイン
始める
支払い
売上
プラットフォームおよびマーケットプレイス
資金管理
開発者向けリソース
概要
バージョン管理
変更ログ
API バージョンのアップグレード
SDK バージョンをアップグレードする
Essentials
SDK
API
テスト
    概要
    テスト
    ユースケースをテストする
    サンドボックス
    Apple Pay と Google Pay のレンダリングをテストする
Stripe CLI
サンプルプロジェクト
ツール
ワークベンチ
開発者ダッシュボード
Stripe Shell
Visual Studio Code をご利用の場合
機能
ワークフロー
イベントの送信先
Stripe 健全性アラートファイルのアップロード
AI ソリューション
エージェントツールキット
モデルコンテキストプロトコル
セキュリティとプライバシー
セキュリティ
Stripebot ウェブクローラー
プライバシー
Stripe を拡張する
Stripe Appsを構築する
Stripe アプリを使用する
パートナー
Partner Ecosystem
パートナー認定
ホーム開発者向けリソースTesting

注

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

テスト

決済をシミュレーションして導入をテストします。

導入をテストするには、サンドボックスで特殊なテスト値を使用して、資金を移動せずに取引をシミュレーションします。サンドボックスにアクセスするには、ページの右上またはダッシュボードのアカウント選択機能を使用します。

テストカードは偽のクレジットカードとして機能し、以下のシナリオをシミュレーションできます。

  • カードブランドまたは国別の成功した決済
  • 決済拒否、不正利用、または無効なデータによるカードエラー
  • 不審請求の申し立てと返金
  • 3D セキュアと PIN による認証

非カード決済のテストも同様に機能します。非カード決済は、クレジットカードやデビットカードではない決済手段です。Stripe は、デジタルウォレットや銀行振込など、クレジットカード以外のさまざまな決済オプションをサポートしています。各決済手段には、独自の特別な値があります。

導入の負荷テストにはテスト環境を使用しないでください。レート制限に達する可能性があるためです。導入の負荷テストについては、負荷テストを参照してください。

テストカードの使用方法

テストカードを使用するときは必ず、すべての API コールでテスト API キーを使用します。これは、対話式でテストできる決済フォームを提供する場合にも、テストコードを作成する場合にも当てはまります。

よくある間違い

実際のカード詳細は使用しないでください。実際の決済手段の情報を使用して本番環境でテストすることは、Stripe 利用規約で禁止されています。テスト API キーと以下のカード番号を使用してください。

対話式でテストする

対話式でテストする場合は、4242 4242 4242 4242 などのカード番号を使用します。ダッシュボードまたは決済フォームにカード番号を入力します。

  • 有効な将来の日付を使用します (12/34 など)。
  • 任意の 3 桁 (American Express カードの場合は 4 桁) のセキュリティコードを使用します。
  • その他のフォームフィールドには任意の値を使用します。
テストカード番号の入力方法を示す決済フォームの例。カード番号は「4242 4242 4242 4242」、有効期限は「12/34」、セキュリティコードは「567」です。他のフィールドには、任意の値が入ります。たとえば、メールアドレスは「test@example.com」です。

テストカード番号 4242 4242 4242 4242 を使用したフォームの対話式のテスト

テストコード

テストコードを記述する際には、カード番号の代わりに pm_card_visa などの PaymentMethod を使用します。テスト環境であっても、API コールまたはサーバー側のコードで直接、カード番号を使用することはお勧めしません。使用すると、本番環境に移行するときにコードの PCI 準拠が損なわれる可能性があります。デフォルトでは、PaymentMethod は Customer に関連付けられていません。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d amount=500 \ -d currency=gbp \ -d payment_method=pm_card_visa \ -d "payment_method_types[]"=card

導入の大半では Token が使用されなくなっていますが、必要に応じて tok_visa などのテスト用 Token を使用できます。

導入を本番に移行する準備ができたら、テストの公開可能キーとシークレットAPI キーを本番用のものに置き換えます。導入でテスト用 API キーが使用されていると、本番の決済は処理されません。

ブランド別のカード

特定のカードブランドの決済の成功をシミュレーションするには、以下に記載されているテストカードを使用します。

注意

国際手数料はカード発行会社の国に基づいて評価されます。カード発行会社の国がアメリカではないカード (JCB やUnionPayなど) がテスト環境でも国際手数料の対象となる場合があります。

ブランド数字セキュリティコード日付
Visa任意の 3 桁の数字任意の将来の日付
Visa (デビット)任意の 3 桁の数字任意の将来の日付
Mastercard任意の 3 桁の数字任意の将来の日付
Mastercard (2 シリーズ)任意の 3 桁の数字任意の将来の日付
Mastercard (デビット)任意の 3 桁の数字任意の将来の日付
Mastercard (プリペイド)任意の 3 桁の数字任意の将来の日付
アメリカン・エキスプレス任意の 4 桁の数字任意の将来の日付
アメリカン・エキスプレス任意の 4 桁の数字任意の将来の日付
ディスカバー任意の 3 桁の数字任意の将来の日付
ディスカバー任意の 3 桁の数字任意の将来の日付
ディスカバー (デビット)任意の 3 桁の数字任意の将来の日付
ダイナースクラブ任意の 3 桁の数字任意の将来の日付
ダイナースクラブ (14 桁のカード)任意の 3 桁の数字任意の将来の日付
BCcard と DinaCard任意の 3 桁の数字任意の将来の日付
JCB任意の 3 桁の数字任意の将来の日付
UnionPay任意の 3 桁の数字任意の将来の日付
UnionPay (デビット)任意の 3 桁の数字任意の将来の日付
UnionPay (19 桁のカード)任意の 3 桁の数字任意の将来の日付

大半の Cartes Bancaires および eftpos のカードは Visa または Mastercard とブランド提携しています。次の表のテストカードは、ブランド提携カードによる決済の成功をシミュレーションします。

ブランド / 提携ブランド数字セキュリティコード日付
Cartes Bancaires/Visa任意の 3 桁の数字任意の将来の日付
Cartes Bancaires/Mastercard任意の 3 桁の数字任意の将来の日付
eftpos オーストラリア/Visa任意の 3 桁の数字任意の将来の日付
eftpos オーストラリア/Mastercard任意の 3 桁の数字任意の将来の日付

国別のカード

特定の国の決済の成功をシミュレーションするには、以降のセクションに記載されているテストカードを使用します。

国数字ブランド
アメリカ大陸
アメリカ (US)Visa
アルゼンチン (AR)Visa
ブラジル (BR)Visa
カナダ (CA)Visa
チリ (CL)Visa
コロンビア (CO)Visa
コスタリカ (CR)Visa
エクアドル (EC)Visa
メキシコ (MX)Visa
メキシコ (MX)Carnet
パナマ (PA)Visa
パラグアイ (PY)Visa
ペルー (PE)Visa
ウルグアイ (UY)Visa
ヨーロッパ・中東

セキュリティのヒント

強力な顧客認証 (SCA) 規制により、欧州経済領域 (EEA) 内のオンライン決済では 3D セキュア認証を行う必要があります。このセクションに記載されているテストカードは、認証を行わずに成功する決済をシミュレーションします。また、3D セキュアテストカードを使用して、認証が必要なシナリオもテストすることをお勧めします。

アラブ首長国連邦 (AE)Visa
アラブ首長国連邦 (AE)Mastercard
オーストリア (AT)Visa
ベルギー (BE)Visa
ブルガリア (BG)Visa
ベラルーシ (BY)Visa
クロアチア (HR)Visa
キプロス (CY)Visa
チェコ共和国 (CZ)Visa
デンマーク (DK)Visa
エストニア (EE)Visa
フィンランド (FI)Visa
フランス (FR)Visa
ドイツ (DE)Visa
ジブラルタル (GI)Visa
ギリシャ (GR)Visa
ハンガリー (HU)Visa
アイルランド (IE)Visa
イタリア (IT)Visa
ラトビア (LV)Visa
リヒテンシュタイン (LI)Visa
リトアニア (LT)Visa
ルクセンブルク (LU)Visa
マルタ (MT)Visa
オランダ (NL)Visa
ノルウェー (NO)Visa
ポーランド (PL)Visa
ポルトガル (PT)Visa
ルーマニア (RO)Visa
サウジアラビア (SA)Visa
スロベニア (SI)Visa
スロバキア (SK)Visa
スペイン (ES)Visa
スウェーデン (SE)Visa
スイス (CH)Visa
イギリス (GB)Visa
イギリス (GB)Visa (デビット)
イギリス (GB)Mastercard
アジア太平洋

地域的な考慮事項
インド

同意書と引き落としの事前通知が必要なサブスクリプションをテストするには、インド継続決済をご覧ください。

オーストラリア (AU)Visa
中国 (CN)Visa
香港 (HK)Visa
インド (IN)Visa
日本 (JP)Visa
日本 (JP)JCB
マレーシア (MY)Visa
ニュージーランド (NZ)Visa
シンガポール (SG)Visa
台湾 (TW)Visa
タイ (TH)Visa (クレジット)
タイ (TH)Visa (デビット)

HSA および FSA テストカード

以下は、HSA (医療貯蓄口座) と FSA (柔軟な支出口座) を使用して取引をシミュレーションするためのテスト用カード番号です。これらの口座は一般的に医療費に使用されます。これらの口座を使用してテストすることで、アプリケーション内で医療関連の取引が適切に処理されるようになります。

ブランド/タイプ数字セキュリティコード日付
Visa FSA任意の 3 桁の数字任意の将来の日付
Visa HSA任意の 3 桁の数字任意の将来の日付
Mastercard FSA任意の 3 桁の数字任意の将来の日付

拒否された決済

カード発行会社がさまざまな理由で拒否する決済をシミュレーションすることで導入のエラー処理ロジックをテストする場合は、このセクションに記載されているテストカードを使用します。これらのカードのいずれかを使用すると、特定のエラーコードと決済拒否コードによるカードエラーになります。

よくある間違い

セキュリティコードの誤りをシミュレーションするには、任意の 3 桁の数字を指定する必要があります。セキュリティコードを指定しない場合、Stripe はセキュリティコードのチェックを実行しないため、チェックが失敗することはありません。

説明数字エラーコード決済拒否コード
一般的な決済拒否card_declinedgeneric_decline
資金不足による決済拒否card_declinedinsufficient_funds
カードの紛失による決済拒否card_declinedlost_card
盗難カードによる決済拒否card_declinedstolen_card
有効期限切れクレジットカードによる決済拒否expired_card該当なし
セキュリティコードの誤りによる決済拒否incorrect_cvc該当なし
処理エラーによる決済拒否processing_error該当なし
番号の誤りによる決済拒否incorrect_number該当なし
利用頻度の上限を超過したことによる決済拒否card_declinedcard_velocity_exceeded

上記の表のカードを Customer オブジェクトに関連付けることはできません。正常に関連付けられたカードを使用した決済の拒否をシミュレーションするには、下記のカードを使用します。

説明数字詳細
関連付けた後の支払い拒否このカードを Customer オブジェクトに関連付けることはできますが、顧客への請求は失敗します。

不正利用防止

Stripe の不正利用防止システムである Radar により、リスクレベルが高い場合や検証チェックに失敗した場合に決済がブロックされることがあります。このセクションに記載されているカードを使用して、Radar の設定をテストできます。また、導入が、ブロックされた決済にどう対応するかをテストする場合にも使用できます。

各カードは特定のリスク要因をシミュレーションします。Radar の設定により、決済をブロックする原因となるリスク要因が決定されます。ブロックされた決済は、不正利用のエラーコードでカードエラーになります。

よくある間違い

セキュリティコードの確認の失敗をシミュレーションするには、任意の 3 桁の数字を使用してセキュリティコードを指定する必要があります。郵便番号チェックの失敗をシミュレーションするには、任意の有効な郵便番号を指定する必要があります。これらの値を指定しない場合、Radar は、対応するチェックを実行しないため、チェックが失敗することはありません。

説明数字詳細

常にブロック

決済のリスクレベルは「最高」です

Radar によって常にブロックされます。

非常に高いリスク

決済のリスクレベルは「最高」です

設定によっては、Radar でブロックされる場合があります。

比較的高リスク

請求のリスクレベルは「高」です

Radar for Teams を使用する場合、Radar で審査リストに追加されることがあります。

セキュリティコードチェックの失敗

セキュリティコードを指定した場合に、セキュリティコードのチェックが失敗します。

設定によっては、Radar でブロックされる場合があります。

郵便番号チェックの失敗

郵便番号を指定した場合に、郵便番号チェックが失敗します。

設定によっては、Radar でブロックされる場合があります。

セキュリティコードチェックが、高リスクで失敗する

セキュリティコード番号を指定すると、セキュリティコードのチェックはリスクレベル「elevated」で失敗します。

設定によっては、Radar でブロックされる場合があります。

郵便番号チェックが失敗してリスクが高い

郵便番号を指定すると、郵便番号チェックはリスクレベル「高」で失敗します

設定によっては、Radar でブロックされる場合があります。

住所 (1 行目) のチェックの失敗

住所 (1 行目) のチェックが失敗します。

カスタム Radar ルールでブロックしない限り、決済は成功します。

住所チェックの失敗

住所の郵便番号チェックと住所 (1 行目) のチェックのどちらも失敗します。

設定によっては、Radar でブロックされる場合があります。

住所を使用できない

住所の郵便番号チェックと住所 (1 行目) のチェックのどちらも使用できません。

カスタム Radar ルールでブロックしない限り、決済は成功します。

無効なデータ

無効なデータが原因のエラーをテストするには、無効な詳細を指定します。これに専用のテストカードは必要ありません。どの無効な値でも機能します。以下に例を示します。

  • invalid_expiry_month: 無効な月を使用する (13 など)。
  • invalid_expiry_year: 95 のように、過去 50 年までの年を使用します。
  • invalid_cvc: 2 桁の数字を使用する (99 など)
  • incorrect_number: のように、Luhn チェックに失敗したカード番号を使用します。

不審請求の申し立て

不審請求が申し立てられた取引をシミュレーションするには、このセクションに記載されているテストカードを使用します。また、不審請求の申し立てで勝訴または敗訴をシミュレーションするには、勝訴または敗訴の証拠を提出します。

説明数字詳細
不正利用デフォルトのアカウント設定では、請求は成功しますが、不正利用として不審請求を申し立てるだけです。このタイプの不審請求の申し立ては、3D セキュア認証後に保護されます。
未受領デフォルトのアカウント設定では、決済は成功し、商品未受領として不審請求が申し立てられるのみです。このタイプの不審請求の申し立ては、3D セキュア認証後は保護されません。
照会デフォルトのアカウント設定では、決済が成功し、照会として不審請求の申し立てがのみ行われます。
警告デフォルトのアカウント設定では、請求が成功し、不正利用の早期警告のみが返されます。
複数の不審請求の申し立てデフォルトのアカウント設定では、決済が成功し、複数回不審請求の申し立てが行われる結果となります。
Visa Compelling Evidence 3.0デフォルトのアカウント設定では、決済が成功し、Visa Compelling Evidence 3.0 の適格な不審請求としてのみ不審請求の申し立てが行われます。
Visa コンプライアンスデフォルトのアカウント設定では、請求が成功し、Visa コンプライアンス不審請求の申し立てとしてのみ不審請求の申し立てが行われます。

証拠

不審請求の申し立てに対する主張が認められる場合と認められない場合をシミュレーションするには、次の表のいずれかの反証資料の値で応答します。

  • API を使用して応答する場合は、表の値を uncategorized_text として渡します。
  • ダッシュボードまたはConnect 埋め込みコンポーネントで応答する場合は、表の値を追加情報フィールドに入力してから、反証資料を提出をクリックします。
証拠説明
winning_evidence不審請求の申し立てを勝訴としてクローズし、支払い額と関連手数料をアカウントに入金します。
losing_evidenceアカウントに入金せずに不審請求の申し立てを敗訴としてクローズします。照会の場合は、エスカレーションせずに照会がクローズされます。
escalate_inquiry_evidence照会をチャージバックにエスカレーションします。これにより照会が不審請求の申し立て全体に移行し、不審請求の申し立ての金額と関連手数料がアカウントから引き落とされます。

返金

本番環境では、返金は非同期で行われます。返金は、成功したように表示されてから失敗したり、最初は pending として表示され、後で成功したりする場合があります。このような動作の返金をシミュレーションするには、このセクションに記載されているテストカードを使用します。(その他のテストカードはすべて、返金が即時に成功して、その後はステータスが変わりません。)

説明数字詳細
非同期の成功請求は成功します。返金を開始する場合、ステータスは pending で始まります。しばらくすると、ステータスは succeeded に移行し、refund.updated イベントが送信されます。
非同期の失敗請求は成功します。返金を開始する場合、ステータスは succeeded で始まります。しばらくすると、ステータスは failed に移行し、refund.failed イベントが送信されます。

カードの返金は、ダッシュボードを使用する場合にのみキャンセルできます。本番環境では、特定でない短期間でカードの返金をキャンセルできます。テスト環境では、30分以内にカードの返金をキャンセルできるようにすることで、その期間をシミュレーションします。

利用可能な残高

テスト取引から利用可能残高に直接、資金を送金するには、このセクションに記載されているテストカードを使用します。他のテストカードでは、成功した決済から保留中の残高に資金が送金されます。

説明数字詳細
保留中の残高のバイパスアメリカでの請求は成功します。売上は利用可能残高に直接追加され、保留中の残高をバイパスします。
保留中の残高のバイパス国際決済は成功します。売上は利用可能残高に直接追加され、保留中の残高をバイパスします。

3D セキュア認証

3D セキュアでは、クレジットカード取引に追加の認証レイヤーが必要になります。このセクションに記載されているテストカードを使用して、各種決済フローにおける認証のトリガーをシミュレーションできます。

このセクションのカードのみが、定義された 3DS の動作 (チャレンジフローや未対応のカードなど) をシミュレーションすることによって、3D セキュアの導入を効果的にテストできます。他の Stripe テストカードでも 3DS がトリガーされる可能性がありますが、attempt_acknowledged が返され、追加のステップは迂回されます。これは、3DS テストがそれらのカード用には設計されていないためです。

ダッシュボードはサポート対象外

Stripe ダッシュボードで直接作成された決済では 3D セキュアのリダイレクトは行われません。代わりに、導入の独自のフロントエンドまたは API コールを使用してください。

認証と設定

認証を含む決済フローをシミュレーションするには、このセクションに記載されているテストカードを使用します。一部のカードは、将来の決済に備えた設定が可能であるか、すでに設定されていることもあります。

説明数字詳細
設定がない場合に認証このカードでは、将来の決済に備えて設定していない限り、オフセッションの決済で認証が必要です。設定した後は、オフセッションの決済で認証は不要になります。ただし、このカードを使用したオンセッション決済には常に認証が必要です。
常に認証このカードは、カードの設定にかかわらず、すべての取引で認証を必要とします。
すでに設定このカードはすでにオフセッションで使用するために設定されています。1 回限りの決済やその他のオンセッションの決済には認証が必要です。ただし、オフセッションの決済はすべて、カードが以前に設定されているものとして成功します。
資金不足このカードは 1 回限りの決済の場合、認証が必要です。認証に成功しても、以前に設定しても、すべての決済が insufficient_funds 失敗コードで拒否されます。

サポートおよび対応状況

規制により義務付けられている場合や、Radar ルールまたはカスタムコードによってトリガーされた場合に、Stripe は認証をリクエストします。ただし、認証がリクエストされた場合でも、必ず実行できるとは限りません。たとえば、顧客のカードが登録されていなかったり、エラーが発生したりして実行できない場合があります。このセクションに記載されているテストカードを使用して、このような要因のさまざまな組み合わせをシミュレーションしてください。

注

すべての 3DS リファレンスは、3D セキュア 2 を示します。

3D セキュアの使用状況結果数字詳細
3DS が必須OKこの決済を正常に完了させるには、3D セキュア認証を実行する必要があります。デフォルトの場合、Radar ルールによってこのカードの 3D セキュア認証がリクエストされます。
3DS が必須拒否3D セキュア認証が必要ですが、認証後に決済が card_declined エラーコードで拒否されます。デフォルトの場合、Radar ルールによってこのカードの 3D セキュア認証がリクエストされます。
3DS が必須エラー3D セキュア認証が必要ですが、3D セキュア検索リクエストが処理エラーで失敗します。決済は、card_declined 失敗コードで拒否されます。デフォルトの場合、Radar ルールでこのカードの 3D セキュア認証がリクエストされます。
3DS に対応OK3D セキュア認証を実行できますが、必須ではありません。デフォルトの場合、Radar ルールはこのカードの 3D セキュア認証をリクエストしません。
3DS に対応エラー3D セキュア認証を実行できますが、必須ではありません。ただし、3D セキュアを実行しようとすると、処理エラーが発生します。デフォルトの場合、Radar ルールでこのカードの 3D セキュア認証はリクエストされません。
3DS に対応未登録このカードでは 3D セキュアがサポートされていますが、このカードは 3D セキュアに登録されていません。Radar ルールによって 3D セキュアがリクエストされても、顧客は認証するように求められません。デフォルトの場合、Radar ルールではこのカードの 3D セキュア認証がリクエストされません。
3DS に未対応このカードでは 3D セキュアがサポートされていないため、呼び出すことができません。PaymentIntent または SetupIntent は、認証を行わずに続行されます。

3D セキュアのモバイルチャレンジフロー

モバイル決済の場合、顧客が UI プロンプトに対応するチャレンジフローをいくつか提供できます。テスト目的で特定のチャレンジフローを起動するには、このセクションに記載されているテストカードを使用します。このカードは、ブラウザベースの決済フォームまたは API コールでの使用には適しません。こうした環境では、機能はするものの、特定の動作を起動することはありません。API コールには適さないため、テスト用の PaymentMethod と Token の値は提供していません。

チャレンジフロー数字詳細
帯域外すべての取引で 3D セキュア 2 認証を実行する必要があります。帯域外 UI によってチャレンジフローが起動されます。
ワンタイムパスコードすべての取引で 3D セキュア 2 認証を実行する必要があります。ワンタイムパスコード UI によってチャレンジフローが起動されます。
単一選択すべての取引で 3D セキュア 2 認証を実行する必要があります。単一選択の UI によってチャレンジフローが起動されます。
複数選択すべての取引で 3D セキュア 2 認証を実行する必要があります。複数選択の UI を使用してチャレンジフローを起動します。

CAPTCHA チャレンジ

不正利用を防止するため、Stripe は、決済ページでユーザーに CAPTCHA チャレンジを表示する場合があります。以下のテストカードを使用して、このフローをシミュレーションします。

説明数字詳細
CAPTCHA チャレンジユーザーが CAPTCHA チャレンジに正しく回答すると、請求は成功します。
CAPTCHA チャレンジユーザーが CAPTCHA チャレンジに正しく回答すると、請求は成功します。

PIN を使用した決済

PIN が使用される対面決済の成功をシミュレーションするには、このセクションに記載されているテストカードを使用します。その他にも、シミュレーションされたリーダーやテスト用の物理カードなど、対面決済をテストするための多くのオプションがあります。詳細については、Stripe Terminal をテストするをご覧ください。

説明数字詳細
オフライン PINこのクレジットカードは、カード会員にプロンプトが表示され、オフライン PIN を入力する決済をシミュレーションします。生成される請求では、cardholder_verification_method が offline_pin に設定されます。
オフライン PIN の再試行SCA トリガーの再試行フローがシミュレーションされます。このフローでは、カード会員の初回の非接触型決済が失敗し、リーダーから、ユーザーにカードを挿入し、オフライン PIN を入力するように求めるプロンプトが表示されます。生成される決済では、cardholder_verification_method が offline_pin に設定されます。
オンライン PINこのクレジットカードは、カード会員がオンライン PIN の入力を求められる決済をシミュレーションします。生成される請求では、cardholder_verification_method が online_pin に設定されます。
オンライン PIN の再試行SCA トリガーの再試行フローがシミュレーションされます。このフローでは、カード会員の初回の非接触型請求が失敗し、リーダーから、ユーザーにクレジットカードを挿入し、オンライン PIN を入力するように求めるプロンプトが表示されます。生成される請求では、cardholder_verification_method が online_pin に設定されます。

イベントの送信先

Webhook エンドポイントまたはイベントの送信先をテストするには、次の 2 つのオプションのいずれかを選択します。

  1. サンドボックスでアクションを実行し、イベントの送信先に正規のイベントを送信します。たとえば、charge.succeeded イベントをトリガーするには、支払いを成功させるテストカードを使用できます。
  2. Stripe CLI を使用してイベントをトリガーするか、Stripe for Visual Studio Code を使用してイベントをトリガーします。

レート制限

テスト環境でリクエストが 429 HTTP エラーを受け取るようになった場合は、その頻度を下げてください。これらのエラーは、本番環境よりもテスト環境の方が厳しいレート制限から発生します。

テスト環境で Stripe API を使用して導入の負荷テストを行うことはお勧めしません。テスト環境の負荷制限機能は厳しいため、本番環境では表示されないエラーが表示される可能性があります。代替方法については、負荷テストをご覧ください。

カード以外の決済

テスト用のカード以外の決済方法を使用するときは必ず、すべての API コールでテスト用 API キーを使用します。これは、対話式でテストできる決済フォームを提供する場合にも、テストコードを作成する場合にも当てはまります。

テスト手順は決済手段ごとに異なります。

Financial Connections を使用して即時確認を行うシナリオをテストする方法をご紹介します。

サンドボックスで取引メールを送信する

銀行口座の詳細を収集し、同意書を受け付けたら、サンドボックスで同意書の確認メールと少額入金の確認メールを送信します。

ドメインが {domain} でユーザー名が {username} の場合、{username}+test_email@{domain} というメール形式を使用してテスト取引メールを送信してください。

たとえば、ドメインが example.com でユーザー名が info の場合、ACH Direct Debit 決済のテストには info+test_email@example.com という形式を使用します。この形式により、メールが正しくルーティングされます。+test_email サフィックスを含めない場合、メールは送信されません。

よくある間違い

テスト中にこれらのメールをトリガーするには、Stripe の本番環境利用の申請を行う必要があります。

テスト用口座番号

Stripe では、手動入力の銀行口座の組み込みが本番環境に移行する準備が整ったかどうかを確認するため、テスト用の口座番号と対応するトークンをいくつか用意しています。

口座番号トークン金融番号動作
000123456789pm_usBankAccount_success110000000支払いは成功します。
000111111113pm_usBankAccount_accountClosed110000000口座が解約済みであるため、支払いは失敗します。
000000004954pm_usBankAccount_riskLevelHighest110000000この支払いは、不正利用のリスクが高いため、Radar によってブロックされています。
000111111116pm_usBankAccount_noAccount110000000口座が見つからないため、支払いは失敗します。
000222222227pm_usBankAccount_insufficientFunds110000000残高不足のため、支払いは失敗します。
000333333335pm_usBankAccount_debitNotAuthorized110000000引き落としがオーソリされていないため、支払いは失敗します。
000444444440pm_usBankAccount_invalidCurrency110000000通貨が無効であるため、支払いは失敗します。
000666666661pm_usBankAccount_failMicrodeposits110000000支払いで少額入金の送金が失敗します。
000555555559pm_usBankAccount_dispute110000000支払いによって不審請求の申請が開始されています。
000000000009pm_usBankAccount_processing110000000支払いは無期限に処理中のままになります。これは PaymentIntent のキャンセルをテストするのに便利です。
000777777771pm_usBankAccount_weeklyLimitExceeded110000000支払い額がアカウントの週次支払い額の上限を超えているため、支払いが失敗しました。

テスト取引を完了する前に、自動的に支払いに成功または失敗するテスト用のすべての口座を確認する必要があります。確認するには、下記の少額入金のテスト用の金額または明細書表記コードを使用します。

少額入金の金額と明細書表記コードをテストする

さまざまなシナリオを再現するために、これらの少額入金の金額「または」明細書表記コードの値 0.01 を使用します。

少額入金の金額明細書表記コードの値 0.01シナリオ
32 および 45SM11AAアカウントの確認をシミュレーションします。
10 および 11SM33CC許容された確認回数の超過をシミュレーションします。
40 および 41SM44DD少額入金のタイムアウトをシミュレーションします。

売上処理の動作をテストする

テスト取引は即座に売上として処理され、利用可能なテスト残高に追加されます。この動作は、利用可能な残高で取引が売上として処理されるまでに数日かかることがある、本番環境とは異なります。

Link

注意

サンドボックスの Link アカウントには実際のユーザーデータを保存しないでください。これらのテストアカウントは公開可能キーに関連付けられているため、公開されるものとして扱ってください。

Link は現在、クレジットカード、デビットカード、および資格要件を満たしたアメリカの銀行口座からの購入にのみ対応しています。Link では、ドメインの登録が必要です。

有効なメールアドレスを使用して、Link のサンドボックスアカウントを作成できます。次の表は、Stripe がサンドボックスアカウントの認証に使用できる共通のワンタイムパスコードの値を示しています。

値結果
以下に記載されていない任意の 6 桁の数字成功
000001エラー: コードが無効です
000002エラー: コードの有効期限が切れています
000003エラー: 最大試行回数を超えました

複数の資金供給元

対応する資金供給元を Stripe が追加した場合でも、貴社で構築済みのシステムを更新する必要はありません。Stripe が自動的に対応し、カード決済や銀行口座決済の場合と同じ売上処理時間と保証が適用されます。

リダイレクト

リダイレクトフローを使用する決済 (iDEAL など) をシミュレーションして導入のリダイレクト処理ロジックをテストするには、リダイレクトを必要とするサポート対象の決済方法を使用します。

結果が成功または失敗になるテスト用 PaymentIntent を作成するには、以下のようにします。

  1. ダッシュボードの決済手段設定に移動し、テスト環境で有効にするをクリックして、サポートされている決済手段を有効にします。
  2. 決済詳細を収集します。
  3. Stripe に決済を送信します。
  4. テスト決済をオーソリするか、失敗させます。

Web サイト上のページ (return_url に対応するページ) で、必ず決済のステータスが確認できるようにしてください。

参照情報

  • Connect の導入をテストする
  • Billing の導入をテストする
  • Terminal の導入をテストする
  • 負荷テスト
このページはお役に立ちましたか。
はいいいえ
  • お困りのことがございましたら 、サポートにお問い合わせください。
  • 早期アクセスプログラムにご参加ください。
  • 変更ログをご覧ください。
  • ご不明な点がございましたら、お問い合わせください。
  • LLM ですか?llms.txt を読んでください。
  • Powered by Markdoc
関連ガイド
ユースケースをテストする
API キー