ユースケースをテストする

Stripe’s testing environments, such as test mode and Sandboxes, allow you to test your integration without making actual charges or payments. These environments simulate creating real objects without affecting actual transactions or moving real money. We recommend using our quality assurance (QA) testing use cases, and importing our Postman collection to aid you in the testing process.

Testing environments

In a testing environment, you can charge test credit cards and create test products and prices. These environments let you simulate transactions to make sure that your integration works correctly. This feature helps to identify any bugs or errors in your Stripe implementation before you go live with actual payments. Learn how to decide between using test mode and Sandboxes.

After you create a Stripe account, you can find a set of test API keys in the Stripe Dashboard. You can use these API keys to create and retrieve simulated data by making requests to the Stripe API. To start accepting real payments, you need to activate your account, exit your testing environment using the account picker, and use the live API keys in your integration. Stripe provides a number of resources for testing your integration.

Testing environments versus live mode

All Stripe API requests occur in either testing environments or live mode. API objects in one mode aren’t accessible to the other. For example, a test product object can’t be part of a live mode payment.

Being in a testing environment in the Dashboard doesn’t affect your integration code. Your test and live mode API keys affect the behavior of your code. Your test and live mode API keys affect the behavior of your code.

テストカード番号

Stripe provides a set of test card numbers that you can use to simulate various payment scenarios. You can use these test card numbers to create simulated payments in testing environments without processing actual payments or charges.

テストカード番号を使用すると、任意の将来の有効期限と 3 桁のセキュリティコードを入力して、決済の成功をシミュレーションできます。決済の失敗をシミュレーションする場合は、Stripe が提供する特定のテストカード番号とセキュリティコードを使用できます。

Test card numbers are only valid in testing environments. Don’t use them for real payments.

テストデータを削除する

すべてのテストデータを Stripe アカウントから削除するには、次の手順を実行してください。

1. 既存の Stripe アカウントを使用してダッシュボードにログインします。
2. While in your testing environments, click Developers > Overview.
3. テストデータで、テストデータをレビューをクリックします。ここのダイアログに、既存のすべてのテストデータオブジェクトのリストが表示されます。
4. テストデータを削除をクリックして、削除プロセスを開始します。テストデータの削除を取り消すことはできません。

Testing environments are temporarily unusable while the deletion process occurs.

テストメール

By default, Stripe doesn’t email customers in testing environments. For example, paying an invoice in a sandbox doesn’t send a receipt email to the customer. Invoices finalized through the API in testing environments also don’t send a receipt email to the customer.

If you want Stripe to email customers in a testing environment, you can do the following in the Dashboard:

• 請求書を作成して特定の顧客に手動で送信します。
• 支払い済みの請求書の領収書を手動で送信します。

メールで請求書や領収書を確認する場合は、Customer オブジェクトにチームのメールアドレスを設定するか、PaymentIntent に receipt_email 属性を設定してください。

ユースケースをテストする

次の表には、品質保証 (QA) テストのユースケースが含まれています。

{
  ...
  "capture_method": "manual",
  ...
  "status": "requires_capture",
  ...
}

{
    ...
    "status": "succeeded",
    ...
  }

{
  "error": {
    "charge": "ch_cQD2BiuvMLXbL15e",
    "code": "card_declined",
    "decline_code": "<<REASON HERE>>",
    "doc_url": "https://docs.stripe.com/error-codes#card-declined",
    "message": "Your card was declined.",
    "type": "card_error"
  }
}

{
  "object": {
    "id": "du_UEuHOCy5LyLuFiMo",
    "object": "dispute",
    "charge_id": "ch_yT76WLkSHRn16R2O",
    ...
    "status": "needs_response"
  }
}

{
  "object": {
    "id": "du_hE6o7ADQyexesHWa",
    "object": "dispute",
    "charge_id": "ch_XUj720TdC1SKk1yq",
    ...
    "is_charge_refundable": true,
    ...
    "status": "warning_needs_response"
  }
}

{
  "object": {
    "id": "du_ZFek3KCxAVrZunh0",
    "object": "dispute",
    "charge_id": "ch_LR8rJP9pVDav6pFy",
    ...
    "status": "won"
  }
}

{
  "object": {
    "id": "du_xznEpiioML2gtSLr",
    "object": "dispute",
    "charge_id": "ch_iInw5nUAdZcjafGZ",
    ...
    "status": "lost"
  }
}

{
  "object": {
    "id": "du_NU9PYIuAs8VDoqgz",
    "object": "dispute",
    "charge_id": "ch_zMBr0ELOlAHhM1MH",
    ...
    "status": "warning_closed"
  }
}

{
  "object": {
    "id": "du_zupjX7uH3ZMkUU47",
    "object": "dispute",
    "charge_id": "ch_FQLj5b9k2syYqAIr",
    ...
    "status": "needs_response"
  }
}

{
  "id": "re_ZCsM0iPIvEjTp752",
  "object": "refund",
  "amount": "<<FULL AMOUNT>>",
  "charge": "ch_FmE2PNLvQMPYSk2i",
  ...
  "payment_intent": "pi_OVoQ63YeYi23blo3", // if you're using PaymentIntents
  ...
  "status": "succeeded"
}

{
  "id": "re_zlJePgIIzwduuAQV",
  "object": "refund",
  "amount": "<<PARTIAL AMOUNT>>",
  "charge": "ch_7rRj6RP4ClP9mzDD",
  ...
  "payment_intent": "pi_vwoeoP44qLkgAMUi", // if you are using PaymentIntents
  ...
  "status": "succeeded"
}

Stripe の Postman コレクション

Postman は、広く利用されている API 開発ツールです。Stripe の導入をよりシンプルにするために、構築済みシステムのサーバー側コンポーネントをテストする際に必要なツールとともに支払い専用の Postman コレクションをご用意しております。

コレクションをインポートする

まず、Postman アプリにアクセスする必要があります。ブラウザーバージョンまたはデスクトップバージョンを使用できます。アプリを起動したら、コレクションをインポートします。

ウェブでこのプロセスを開始するには、左上隅にあるインポートボタンをクリックしてから、Link オプションをクリックします。Payments コレクションのリンクを貼り付けます。Postman のデスクトップアプリを使用している場合は、File (ファイル) > Import (インポート) をクリックします。正常にインポートされると、Collections (コレクション) の下にコレクションが表示されます。

インポートダイアログ

コレクションを使用する

コレクションを使用するには、先ほどインポートしたコレクションに移動して、Variables (変数) をクリックします。テスト環境の Stripe シークレットキーを Stripe ダッシュボードからコピーして、Initial Value (初期値) フィールドに貼り付けます。この手順が完了すると、リクエストの実行準備が整います。

他の変数は、コレクションの実行時にスクリプトによって入力されます。たとえば、customer、price、charge、PaymentIntent を作成する場合は、システムは、コレクションのスクリプトを使用してその ID を保存し、返金などの後続のリクエストで使用できるようにします。

Postman コレクションにシークレットキーを追加する