導入をテストするには、サンドボックス で特殊なテスト値を使用して、資金を移動せずに取引をシミュレーションします。サンドボックスにアクセスするには、ページの右上またはダッシュボード のアカウント選択機能を使用します。
テストカードは偽のクレジットカードとして機能し、以下のシナリオをシミュレーションできます。
非カード決済のテストも同様に機能します。非カード決済は、クレジットカードやデビットカードではない決済手段です。Stripe は、デジタルウォレットや銀行振込など、クレジットカード以外のさまざまな決済オプションをサポートしています。各決済手段 には、独自の特別な値があります。
導入の負荷テストにはテスト環境を使用しないでください。レート制限 に達する可能性があるためです。導入の負荷テストについては、負荷テスト を参照してください。
テストカードの使用方法 テストカードを使用するときは必ず、すべての API コールでテスト API キー を使用します。これは、対話式でテストできる決済フォームを提供する場合にも、テストコードを作成する場合にも当てはまります。
よくある間違い 実際のカード詳細は使用しないでください。実際の決済手段の情報を使用して本番環境でテストすることは、Stripe 利用規約 で禁止されています。テスト API キーと以下のカード番号を使用してください。
対話式でテストする 対話式でテストする場合は、4242 4242 4242 4242 などのカード番号を使用します。ダッシュボードまたは決済フォームにカード番号を入力します。
有効な将来の日付を使用します (12/34 など)。 任意の 3 桁 (American Express カードの場合は 4 桁) のセキュリティコードを使用します。 その他のフォームフィールドには任意の値を使用します。 テストカード番号 4242 4242 4242 4242 を使用したフォームの対話式のテスト
テストコード テストコードを記述する際には、カード番号の代わりに pm_card_visa などの PaymentMethod
を使用します。テスト環境であっても、API コールまたはサーバー側のコードで直接、カード番号を使用することはお勧めしません。使用すると、本番環境に移行するときにコードの PCI 準拠が損なわれる可能性があります。デフォルトでは、PaymentMethod
は Customer に関連付けられていません。
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 4242 4242 4242 4242 任意の 3 桁の数字 任意の将来の日付 Visa (デビット) 4000 0566 5566 5556 任意の 3 桁の数字 任意の将来の日付 Mastercard 5555 5555 5555 4444 任意の 3 桁の数字 任意の将来の日付 Mastercard (2 シリーズ) 2223 0031 2200 3222 任意の 3 桁の数字 任意の将来の日付 Mastercard (デビット) 5200 8282 8282 8210 任意の 3 桁の数字 任意の将来の日付 Mastercard (プリペイド) 5105 1051 0510 5100 任意の 3 桁の数字 任意の将来の日付 アメリカン・エキスプレス 3782 822463 10005 任意の 4 桁の数字 任意の将来の日付 アメリカン・エキスプレス 3714 496353 98431 任意の 4 桁の数字 任意の将来の日付 ディスカバー 6011 1111 1111 1117 任意の 3 桁の数字 任意の将来の日付 ディスカバー 6011 0009 9013 9424 任意の 3 桁の数字 任意の将来の日付 ディスカバー (デビット) 6011 9811 1111 1113 任意の 3 桁の数字 任意の将来の日付 ダイナースクラブ 3056 9300 0902 0004 任意の 3 桁の数字 任意の将来の日付 ダイナースクラブ (14 桁のカード) 3622 720627 1667 任意の 3 桁の数字 任意の将来の日付 BCcard と DinaCard 6555 9000 0060 4105 任意の 3 桁の数字 任意の将来の日付 JCB 3566 0020 2036 0505 任意の 3 桁の数字 任意の将来の日付 UnionPay 6200 0000 0000 0005 任意の 3 桁の数字 任意の将来の日付 UnionPay (デビット) 6200 0000 0000 0047 任意の 3 桁の数字 任意の将来の日付 UnionPay (19 桁のカード) 6205 5000 0000 0000 004 任意の 3 桁の数字 任意の将来の日付
大半の Cartes Bancaires および eftpos のカードは Visa または Mastercard とブランド提携しています。次の表のテストカードは、ブランド提携カードによる決済の成功をシミュレーションします。
ブランド / 提携ブランド 数字 セキュリティコード 日付 Cartes Bancaires/Visa 4000 0025 0000 1001 任意の 3 桁の数字 任意の将来の日付 Cartes Bancaires/Mastercard 5555 5525 0000 1001 任意の 3 桁の数字 任意の将来の日付 eftpos オーストラリア/Visa 4000 0503 6000 0001 任意の 3 桁の数字 任意の将来の日付 eftpos オーストラリア/Mastercard 5555 0503 6000 0080 任意の 3 桁の数字 任意の将来の日付
国別のカード 特定の国の決済の成功をシミュレーションするには、以降のセクションに記載されているテストカードを使用します。
国 数字 ブランド
アメリカ大陸 アメリカ (US) 4242 4242 4242 4242 Visa アルゼンチン (AR) 4000 0003 2000 0021 Visa ブラジル (BR) 4000 0007 6000 0002 Visa カナダ (CA) 4000 0012 4000 0000 Visa チリ (CL) 4000 0015 2000 0001 Visa コロンビア (CO) 4000 0017 0000 0003 Visa コスタリカ (CR) 4000 0018 8000 0005 Visa エクアドル (EC) 4000 0021 8000 0000 Visa メキシコ (MX) 4000 0048 4000 8001 Visa メキシコ (MX) 5062 2100 0000 0009 Carnet パナマ (PA) 4000 0059 1000 0000 Visa パラグアイ (PY) 4000 0060 0000 0066 Visa ペルー (PE) 4000 0060 4000 0068 Visa ウルグアイ (UY) 4000 0085 8000 0003 Visa ヨーロッパ・中東 アラブ首長国連邦 (AE) 4000 0078 4000 0001 Visa アラブ首長国連邦 (AE) 5200 0078 4000 0022 Mastercard オーストリア (AT) 4000 0004 0000 0008 Visa ベルギー (BE) 4000 0005 6000 0004 Visa ブルガリア (BG) 4000 0010 0000 0000 Visa ベラルーシ (BY) 4000 0011 2000 0005 Visa クロアチア (HR) 4000 0019 1000 0009 Visa キプロス (CY) 4000 0019 6000 0008 Visa チェコ共和国 (CZ) 4000 0020 3000 0002 Visa デンマーク (DK) 4000 0020 8000 0001 Visa エストニア (EE) 4000 0023 3000 0009 Visa フィンランド (FI) 4000 0024 6000 0001 Visa フランス (FR) 4000 0025 0000 0003 Visa ドイツ (DE) 4000 0027 6000 0016 Visa ジブラルタル (GI) 4000 0029 2000 0005 Visa ギリシャ (GR) 4000 0030 0000 0030 Visa ハンガリー (HU) 4000 0034 8000 0005 Visa アイルランド (IE) 4000 0037 2000 0005 Visa イタリア (IT) 4000 0038 0000 0008 Visa ラトビア (LV) 4000 0042 8000 0005 Visa リヒテンシュタイン (LI) 4000 0043 8000 0004 Visa リトアニア (LT) 4000 0044 0000 0000 Visa ルクセンブルク (LU) 4000 0044 2000 0006 Visa マルタ (MT) 4000 0047 0000 0007 Visa オランダ (NL) 4000 0052 8000 0002 Visa ノルウェー (NO) 4000 0057 8000 0007 Visa ポーランド (PL) 4000 0061 6000 0005 Visa ポルトガル (PT) 4000 0062 0000 0007 Visa ルーマニア (RO) 4000 0064 2000 0001 Visa サウジアラビア (SA) 4000 0068 2000 0007 Visa スロベニア (SI) 4000 0070 5000 0006 Visa スロバキア (SK) 4000 0070 3000 0001 Visa スペイン (ES) 4000 0072 4000 0007 Visa スウェーデン (SE) 4000 0075 2000 0008 Visa スイス (CH) 4000 0075 6000 0009 Visa イギリス (GB) 4000 0082 6000 0000 Visa イギリス (GB) 4000 0582 6000 0005 Visa (デビット) イギリス (GB) 5555 5582 6555 4449 Mastercard アジア太平洋 同意書と引き落としの事前通知が必要なサブスクリプションをテストするには、インド継続決済 をご覧ください。
オーストラリア (AU) 4000 0003 6000 0006 Visa 中国 (CN) 4000 0015 6000 0002 Visa 香港 (HK) 4000 0034 4000 0004 Visa インド (IN) 4000 0035 6000 0008 Visa 日本 (JP) 4000 0039 2000 0003 Visa 日本 (JP) 3530 1113 3330 0000 JCB マレーシア (MY) 4000 0045 8000 0002 Visa ニュージーランド (NZ) 4000 0055 4000 0008 Visa シンガポール (SG) 4000 0070 2000 0003 Visa 台湾 (TW) 4000 0015 8000 0008 Visa タイ (TH) 4000 0076 4000 0003 Visa (クレジット) タイ (TH) 4000 0576 4000 0008 Visa (デビット)
HSA および FSA テストカード 以下は、HSA (医療貯蓄口座) と FSA (柔軟な支出口座) を使用して取引をシミュレーションするためのテスト用カード番号です。これらの口座は一般的に医療費に使用されます。これらの口座を使用してテストすることで、アプリケーション内で医療関連の取引が適切に処理されるようになります。
ブランド/タイプ 数字 セキュリティコード 日付 Visa FSA 4000 0512 3000 0072 任意の 3 桁の数字 任意の将来の日付 Visa HSA 4000 0512 3000 0072 任意の 3 桁の数字 任意の将来の日付 Mastercard FSA 5200 8282 8282 8897 任意の 3 桁の数字 任意の将来の日付
拒否された決済 カード発行会社がさまざまな理由で拒否する決済をシミュレーションすることで導入のエラー処理ロジックをテストする場合は、このセクションに記載されているテストカードを使用します。これらのカードのいずれかを使用すると、特定のエラーコード と決済拒否コード によるカードエラー になります。
よくある間違い セキュリティコードの誤りをシミュレーションするには、任意の 3 桁の数字を指定する必要があります。セキュリティコードを指定しない場合、Stripe はセキュリティコードのチェックを実行しないため、チェックが失敗することはありません。
上記の表のカードを Customer オブジェクトに関連付けることはできません。正常に関連付けられたカードを使用した決済の拒否をシミュレーションするには、下記のカードを使用します。
説明 数字 詳細 関連付けた後の支払い拒否 4000 0000 0000 0341 このカードを Customer オブジェクトに関連付けることはできますが、顧客への請求は失敗します。
不正利用防止 Stripe の不正利用防止システムである Radar により、リスクレベルが高い場合や検証チェックに失敗した場合に決済がブロックされることがあります。このセクションに記載されているカードを使用して、Radar の設定をテストできます。また、導入が、ブロックされた決済にどう対応するかをテストする場合にも使用できます。
各カードは特定のリスク要因をシミュレーションします。Radar の設定により、決済をブロックする原因となるリスク要因が決定されます。ブロックされた決済は、不正利用のエラーコードでカードエラー になります。
よくある間違い セキュリティコードの確認の失敗をシミュレーションするには、任意の 3 桁の数字を使用してセキュリティコードを指定する必要があります。郵便番号チェックの失敗をシミュレーションするには、任意の有効な郵便番号を指定する必要があります。これらの値を指定しない場合、Radar は、対応するチェックを実行しないため、チェックが失敗することはありません。
説明 数字 詳細
常にブロック
4100 0000 0000 0019 決済のリスクレベルは「最高」です
Radar によって常にブロックされます。
非常に高いリスク
4000 0000 0000 4954 決済のリスクレベルは「最高」です
設定によっては 、Radar でブロックされる場合があります。
比較的高リスク
4000 0000 0000 9235 請求のリスクレベルは「高」です
Radar for Teams を使用する場合、Radar で審査リストに追加 されることがあります。
セキュリティコードチェックの失敗
4000 0000 0000 0101 セキュリティコードを指定した場合に、セキュリティコードのチェックが失敗します。
設定によっては 、Radar でブロックされる場合があります。
郵便番号チェックの失敗
4000 0000 0000 0036 郵便番号を指定した場合に、郵便番号チェックが失敗します。
設定によっては 、Radar でブロックされる場合があります。
セキュリティコードチェックが、高リスクで失敗する
4000 0584 0030 7872 セキュリティコード番号を指定すると、セキュリティコードのチェックはリスクレベル「elevated」 で失敗します。
設定によっては 、Radar でブロックされる場合があります。
郵便番号チェックが失敗してリスクが高い
4000 0584 0030 6072 郵便番号を指定すると、郵便番号チェックはリスクレベル「高」で失敗します
設定によっては 、Radar でブロックされる場合があります。
住所 (1 行目) のチェックの失敗
4000 0000 0000 0028 住所 (1 行目) のチェックが失敗します。
カスタム Radar ルールでブロック しない限り、決済は成功します。
住所チェックの失敗
4000 0000 0000 0010 住所の郵便番号チェックと住所 (1 行目) のチェックのどちらも失敗します。
設定によっては 、Radar でブロックされる場合があります。
住所を使用できない
4000 0000 0000 0044 住所の郵便番号チェックと住所 (1 行目) のチェックのどちらも使用できません。
カスタム Radar ルールでブロック しない限り、決済は成功します。
無効なデータ 無効なデータが原因のエラーをテストするには、無効な詳細を指定します。これに専用のテストカードは必要ありません。どの無効な値でも機能します。以下に例を示します。
不審請求の申し立て 不審請求が申し立てられた 取引をシミュレーションするには、このセクションに記載されているテストカードを使用します。また、不審請求の申し立てで勝訴または敗訴をシミュレーションするには、勝訴または敗訴の証拠 を提出します。
説明 数字 詳細 不正利用 4000 0000 0000 0259 デフォルトのアカウント設定では、請求は成功しますが、不正利用 として不審請求を申し立てるだけです。このタイプの不審請求の申し立ては、3D セキュア認証後に保護さ れます。 未受領 4000 0000 0000 2685 デフォルトのアカウント設定では、決済は成功し、商品未受領 として不審請求が申し立てられるのみです。このタイプの不審請求の申し立ては、3D セキュア認証後は保護さ れません。 照会 4000 0000 0000 1976 デフォルトのアカウント設定では、決済が成功し、照会 として不審請求の申し立てがのみ行われます。 警告 4000 0000 0000 5423 デフォルトのアカウント設定では、請求が成功し、不正利用の早期警告 のみが返されます。 複数の不審請求の申し立て 4000 0004 0400 0079 デフォルトのアカウント設定では、決済が成功し、複数回 不審請求の申し立てが行われる結果となります。 Visa Compelling Evidence 3.0 4000 0004 0400 0038 デフォルトのアカウント設定では、決済が成功し、Visa Compelling Evidence 3.0 の適格な不審請求 としてのみ不審請求の申し立てが行われます。 Visa コンプライアンス 4000 0084 0000 0779 デフォルトのアカウント設定では、請求が成功し、Visa コンプライアンス不審請求の申し立て としてのみ不審請求の申し立てが行われます。
証拠 不審請求の申し立てに対する主張が認められる場合と認められない場合をシミュレーションするには、次の表のいずれかの反証資料の値で応答します。
証拠 説明 winning_ evidence
不審請求の申し立てを勝訴としてクローズし、支払い額と関連手数料をアカウントに入金します。 losing_ evidence
アカウントに入金せずに不審請求の申し立てを敗訴としてクローズします。照会の場合は、エスカレーションせずに照会がクローズされます。 escalate_ inquiry_ evidence
照会をチャージバックにエスカレーションします。これにより照会が不審請求の申し立て全体に移行し、不審請求の申し立ての金額と関連手数料がアカウントから引き落とされます。
返金 本番環境では、返金は非同期で行われます。返金は、成功したように表示されてから失敗したり、最初は pending
として表示され、後で成功したりする場合があります。このような動作の返金をシミュレーションするには、このセクションに記載されているテストカードを使用します。(その他のテストカードはすべて、返金が即時に成功して、その後はステータスが変わりません。)
説明 数字 詳細 非同期の成功 4000 0000 0000 7726 請求は成功します。返金を開始する場合、ステータスは pending
で始まります。しばらくすると、ステータスは succeeded
に移行し、refund. updated
イベント が送信されます。 非同期の失敗 4000 0000 0000 5126 請求は成功します。返金を開始する場合、ステータスは succeeded
で始まります。しばらくすると、ステータスは failed
に移行し、refund. failed
イベント が送信されます。
カードの返金は、ダッシュボードを使用する場合にのみキャンセルできます。本番環境では、特定でない短期間でカードの返金をキャンセルできます。テスト環境では、30分以内にカードの返金をキャンセルできるようにすることで、その期間をシミュレーションします。
利用可能な残高 テスト取引から利用可能残高に直接、資金を送金するには、このセクションに記載されているテストカードを使用します。他のテストカードでは、成功した決済から保留中の残高に資金が送金されます。
説明 数字 詳細 保留中の残高のバイパス 4000 0000 0000 0077 アメリカでの請求は成功します。売上は利用可能残高に直接追加され、保留中の残高をバイパスします。 保留中の残高のバイパス 4000 0037 2000 0278 国際決済は成功します。売上は利用可能残高に直接追加され、保留中の残高をバイパスします。
3D セキュア認証 3D セキュアでは、クレジットカード取引に追加の認証レイヤーが必要になります。このセクションに記載されているテストカードを使用して、各種決済フローにおける認証のトリガーをシミュレーションできます。
このセクションのカードのみが、定義された 3DS の動作 (チャレンジフローや未対応のカードなど) をシミュレーションすることによって、3D セキュアの導入を効果的にテストできます。他の Stripe テストカードでも 3DS がトリガーされる可能性がありますが、attempt_ acknowledged
が返され、追加のステップは迂回されます。これは、3DS テストがそれらのカード用には設計されていないためです。
ダッシュボードはサポート対象外 Stripe ダッシュボードで直接作成された決済では 3D セキュアのリダイレクトは行われません。代わりに、導入の独自のフロントエンドまたは API コールを使用してください。
認証と設定 認証を含む決済フローをシミュレーションするには、このセクションに記載されているテストカードを使用します。一部のカードは、将来の決済に備えた設定 が可能であるか、すでに設定されていることもあります。
説明 数字 詳細
設定がない場合に認証 4000 0025 0000 3155 このカードでは、将来の決済に備えて設定して いない限り、オフセッションの決済で認証が必要です。設定した後は、オフセッションの決済で認証は不要になります。ただし、このカードを使用したオンセッション決済には常に認証が必要です。 常に認証 4000 0027 6000 3184 このカードは、カードの設定にかかわらず、すべての取引で認証を必要とします。 すでに設定 4000 0038 0000 0446 このカードはすでにオフセッションで使用するために設定されています。1 回 限りの決済やその他のオンセッション の決済には認証が必要です。ただし、オフセッションの決済 はすべて、カードが以前に設定さ れているものとして成功します。 資金不足 4000 0082 6000 3178 このカードは 1 回限りの決済 の場合、認証が必要です。認証に成功しても、以前に設定 しても、すべての決済が insufficient_ funds
失敗コードで拒否されます。
サポートおよび対応状況 規制により義務付けられている場合や、Radar ルールまたはカスタムコードによってトリガーされた場合に、Stripe は認証をリクエストします。ただし、認証がリクエストされた場合でも、必ず実行できるとは限りません。たとえば、顧客のカードが登録されていなかったり、エラーが発生したりして実行できない場合があります。このセクションに記載されているテストカードを使用して、このような要因のさまざまな組み合わせをシミュレーションしてください。
3D セキュアの使用状況 結果 数字 詳細
3DS が必須 OK 4000 0000 0000 3220 この決済を正常に完了させるには、3D セキュア認証を実行する必要があります。デフォルトの場合、Radar ルールによってこのカードの 3D セキュア認証がリクエストされます。 3DS が必須 拒否 4000 0084 0000 1629 3D セキュア認証が必要ですが、認証後に決済が card_ declined
エラーコードで拒否されます。デフォルトの場合、Radar ルールによってこのカードの 3D セキュア認証がリクエストされます。 3DS が必須 エラー 4000 0084 0000 1280 3D セキュア認証が必要ですが、3D セキュア検索リクエストが処理エラーで失敗します。決済は、card_ declined
失敗コードで拒否されます。デフォルトの場合、Radar ルールでこのカードの 3D セキュア認証がリクエストされます。 3DS に対応 OK 4000 0000 0000 3055 3D セキュア認証を実行できますが、必須ではありません。デフォルトの場合、Radar ルールはこのカードの 3D セキュア認証をリクエストしません。 3DS に対応 エラー 4000 0000 0000 3097 3D セキュア認証を実行できますが、必須ではありません。ただし、3D セキュアを実行しようとすると、処理エラーが発生します。デフォルトの場合、Radar ルールでこのカードの 3D セキュア認証はリクエストされません。 3DS に対応 未登録 4242 4242 4242 4242 このカードでは 3D セキュアがサポートされていますが、このカードは 3D セキュアに登録されていません。Radar ルールによって 3D セキュアがリクエストされても、顧客は認証するように求められません。デフォルトの場合、Radar ルールではこのカードの 3D セキュア認証がリクエストされません。 3DS に未対応 3782 822463 10005 このカードでは 3D セキュアがサポートされていないため、呼び出すことができません。PaymentIntent または SetupIntent は、認証を行わずに続行されます。
3D セキュアのモバイルチャレンジフロー モバイル決済の場合、顧客が UI プロンプトに対応するチャレンジフローをいくつか提供できます。テスト目的で特定のチャレンジフローを起動するには、このセクションに記載されているテストカードを使用します。このカードは、ブラウザベースの決済フォームまたは API コールでの使用には適しません。こうした環境では、機能はするものの、特定の動作を起動することはありません。API コールには適さないため、テスト用の PaymentMethod
と Token
の値は提供していません。
チャレンジフロー 数字 詳細
帯域外 4000 5826 0000 0094 すべての取引で 3D セキュア 2 認証を実行する必要があります。帯域外 UI によってチャレンジフローが起動されます。 ワンタイムパスコード 4000 5826 0000 0045 すべての取引で 3D セキュア 2 認証を実行する必要があります。ワンタイムパスコード UI によってチャレンジフローが起動されます。 単一選択 4000 5826 0000 0102 すべての取引で 3D セキュア 2 認証を実行する必要があります。単一選択の UI によってチャレンジフローが起動されます。 複数選択 4000 5826 0000 0110 すべての取引で 3D セキュア 2 認証を実行する必要があります。複数選択の UI を使用してチャレンジフローを起動します。
CAPTCHA チャレンジ 不正利用を防止するため、Stripe は、決済ページでユーザーに CAPTCHA チャレンジを表示する場合があります。以下のテストカードを使用して、このフローをシミュレーションします。
説明 数字 詳細 CAPTCHA チャレンジ 4000 0000 0000 1208 ユーザーが CAPTCHA チャレンジに正しく回答すると、請求は成功します。 CAPTCHA チャレンジ 4000 0000 0000 3725 ユーザーが CAPTCHA チャレンジに正しく回答すると、請求は成功します。
PIN を使用した決済 PIN が使用される対面決済の成功をシミュレーションするには、このセクションに記載されているテストカードを使用します。その他にも、シミュレーションされたリーダーやテスト用の物理カードなど、対面決済をテストするための多くのオプションがあります。詳細については、Stripe Terminal をテストする をご覧ください。
説明 数字 詳細 オフライン PIN 4001 0070 2000 0002 このクレジットカードは、カード会員にプロンプトが表示され、オフライン PIN を入力する決済をシミュレーションします。生成される請求では、cardholder_verification_method が offline_ pin
に設定されます。 オフライン PIN の再試行 4000 0082 6000 0075 SCA トリガーの再試行フローがシミュレーションされます。このフローでは、カード会員の初回の非接触型決済が失敗し、リーダーから、ユーザーにカードを挿入し、オフライン PIN を入力するように求めるプロンプトが表示されます。生成される決済では、cardholder_verification_method が offline_ pin
に設定されます。 オンライン PIN 4001 0003 6000 0005 このクレジットカードは、カード会員がオンライン PIN の入力を求められる決済をシミュレーションします。生成される請求では、cardholder_verification_method が online_ pin
に設定されます。 オンライン PIN の再試行 4000 0027 6000 0008 SCA トリガーの再試行フローがシミュレーションされます。このフローでは、カード会員の初回の非接触型請求が失敗し、リーダーから、ユーザーにクレジットカードを挿入し、オンライン PIN を入力するように求めるプロンプトが表示されます。生成される請求では、cardholder_verification_method が online_ pin
に設定されます。
イベントの送信先 Webhook エンドポイントまたはイベントの送信先 をテストするには、次の 2 つのオプションのいずれかを選択します。
サンドボックスでアクションを実行し、イベントの送信先に正規のイベントを送信します。たとえば、charge.succeeded イベントをトリガーするには、支払いを成功させるテストカード を使用できます。 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 では、手動入力の銀行口座の組み込みが本番環境に移行する準備が整ったかどうかを確認するため、テスト用の口座番号と対応するトークンをいくつか用意しています。
口座番号 トークン 金融番号 動作 000123456789
pm_ usBankAccount_ success
110000000
支払いは成功します。 000111111113
pm_ usBankAccount_ accountClosed
110000000
口座が解約済みであるため、支払いは失敗します。 000000004954
pm_ usBankAccount_ riskLevelHighest
110000000
この支払いは、不正利用のリスクが高い ため、Radar によってブロックされています。 000111111116
pm_ usBankAccount_ noAccount
110000000
口座が見つからないため、支払いは失敗します。 000222222227
pm_ usBankAccount_ insufficientFunds
110000000
残高不足のため、支払いは失敗します。 000333333335
pm_ usBankAccount_ debitNotAuthorized
110000000
引き落としがオーソリされていないため、支払いは失敗します。 000444444440
pm_ usBankAccount_ invalidCurrency
110000000
通貨が無効であるため、支払いは失敗します。 000666666661
pm_ usBankAccount_ failMicrodeposits
110000000
支払いで少額入金の送金が失敗します。 000555555559
pm_ usBankAccount_ dispute
110000000
支払いによって不審請求の申請が開始されています。 000000000009
pm_ usBankAccount_ processing
110000000
支払いは無期限に処理中のままになります。これは PaymentIntent のキャンセル をテストするのに便利です。 000777777771
pm_ usBankAccount_ weeklyLimitExceeded
110000000
支払い額がアカウントの週次支払い額の上限を超えているため、支払いが失敗しました。
テスト取引を完了する前に、自動的に支払いに成功または失敗するテスト用のすべての口座を確認する必要があります。確認するには、下記の少額入金のテスト用の金額または明細書表記コードを使用します。
少額入金の金額と明細書表記コードをテストする さまざまなシナリオを再現するために、これらの少額入金の金額「または」明細書表記コードの値 0.01 を使用します。
少額入金の金額 明細書表記コードの値 0.01 シナリオ 32
および 45
SM11AA アカウントの確認をシミュレーションします。 10
および 11
SM33CC 許容された確認回数の超過をシミュレーションします。 40
および 41
SM44DD 少額入金のタイムアウトをシミュレーションします。
売上処理の動作をテストする テスト取引は即座に売上として処理され、利用可能なテスト残高に追加されます。この動作は、利用可能な残高で取引が売上として処理されるまでに数日 かかることがある、本番環境とは異なります。
Link 注意 サンドボックス の Link アカウントには実際のユーザーデータを保存しないでください。これらのテストアカウントは公開可能キーに関連付けられているため、公開されるものとして扱ってください。
Link は現在、クレジットカード、デビットカード、および資格要件を満たしたアメリカの銀行口座からの購入にのみ対応しています。Link では、ドメインの登録 が必要です。
有効なメールアドレスを使用して、Link のサンドボックスアカウントを作成できます。次の表は、Stripe がサンドボックスアカウントの認証に使用できる共通のワンタイムパスコードの値を示しています。
値 結果 以下に記載されていない任意の 6 桁の数字 成功 000001 エラー: コードが無効です 000002 エラー: コードの有効期限が切れています 000003 エラー: 最大試行回数を超えました
複数の資金供給元 対応する資金供給元を Stripe が追加した場合でも、貴社で構築済みのシステムを更新する必要はありません。Stripe が自動的に対応し、カード決済や銀行口座決済の場合と同じ売上処理時間と保証が適用されます。
リダイレクト リダイレクトフローを使用する決済 (iDEAL など) をシミュレーションして導入のリダイレクト処理ロジックをテストするには、リダイレクトを必要 とするサポート対象の決済方法を使用します。
結果が成功または失敗になるテスト用 PaymentIntent
を作成するには、以下のようにします。
ダッシュボードの決済手段設定 に移動し、テスト環境で有効にする をクリックして、サポートされている決済手段を有効にします。決済詳細を収集します。 Stripe に決済を送信します。 テスト決済をオーソリするか、失敗させます。 Web サイト上のページ (return_ url
に対応するページ) で、必ず決済のステータスが確認できるようにしてください。
参照情報