Test mode and use cases

Stripe’s test mode allows you to test your integration without making actual charges or payments. Test mode is a testing environment that simulates creating real objects without the risk of affecting real transactions or moving actual money. We recommend using our quality assurance (QA) testing use cases, and importing our Postman collection to aid you in the testing process.

Test mode

In test mode, you can charge test credit cards as well as create test products and prices. You can also use test mode to 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.

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, toggle off test mode, and use the live API keys in your integration. Stripe provides a number of resources for testing your integration.

Test mode versus live mode

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

The Test mode toggle in the Dashboard doesn’t affect your integration code. Your test and live mode API keys affect the behavior of your code.

Test card numbers

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 test mode without processing actual payments or charges.

When you use test card numbers, you can enter any expiration date in the future and any three-digit CVC code to simulate a successful payment. If you want to simulate a failed payment, you can use specific test card numbers and CVC codes provided by Stripe.

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

Delete test data

To delete all of your test data from your Stripe account, complete the following steps:

1. Log in to the Dashboard using your existing Stripe account.
2. While in test mode, click Developers > Overview.
3. Under Test data, click Review test data. The dialog gives you a list of all of your existing test data objects.
4. Click Delete test data to initiate the deletion process. You can’t undo the deletion of your test data.

Test mode is temporarily unusable while the deletion process occurs.

Test email

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

If you want Stripe to email customers in test mode, you can do the following in the Dashboard:

• Create and manually send an invoice to a specific customer.
• Manually send a receipt for a paid invoice.

To verify emails for invoices and receipts, set the email address for your Team on the Customer object or receipt_email attribute on the PaymentIntent.

Testing use cases

The following table contains quality assurance (QA) testing use cases:

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

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

{
  "error": {
    "charge": "ch_rmkn3GmTJHIHZHSw",
    "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_G5b6Aq8KIe83r5IR",
    "object": "dispute",
    "charge_id": "ch_MlnyDoxWj8TG53gC",
    ...
    "status": "needs_response"
  }
}

{
  "object": {
    "id": "du_PHKr6d5KcbckFdbB",
    "object": "dispute",
    "charge_id": "ch_vBLCTCN6l4UPusqs",
    ...
    "is_charge_refundable": true,
    ...
    "status": "warning_needs_response"
  }
}

{
  "object": {
    "id": "du_qyi28oZywV1dGAV1",
    "object": "dispute",
    "charge_id": "ch_AHWNEIl2NaMx7pR1",
    ...
    "status": "won"
  }
}

{
  "object": {
    "id": "du_4fneTTsAVwmFbEdB",
    "object": "dispute",
    "charge_id": "ch_7sfNqae6OBkiiQI8",
    ...
    "status": "lost"
  }
}

{
  "object": {
    "id": "du_gDRYhiRXfBRu5JIZ",
    "object": "dispute",
    "charge_id": "ch_nidutVmbCVI5UnCK",
    ...
    "status": "warning_closed"
  }
}

{
  "object": {
    "id": "du_dzoluRwq0YE5A2bU",
    "object": "dispute",
    "charge_id": "ch_juK1WcfGRPMsPAeM",
    ...
    "status": "needs_response"
  }
}

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

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

Stripe’s Postman collection

Postman is a widely-used API development tool. To make integrating Stripe easier, we provide a Payments-specific Postman collection with the tools you need to test the server-side component of your integration.

Import the collection

To begin, you need to access the Postman app. You can use either the browser or desktop version. After launching the app, import the collection.

To start this process on the web, press the Import button at the top-left corner, followed by the Link option. Insert the Payments collection link. If you’re using the Postman desktop app, click File > Import. After successfully importing, the collection appears under Collections.

The import dialog

Use the collection

To use the collection, navigate to the collection you just imported and click Variables. Copy your testmode Stripe secret key from the Stripe Dashboard, and paste it into the Initial Value field. After you complete this step, you’re ready to begin making requests.

Other variables are populated by scripts during the runtime of the collection. For example, when creating a customer, price, charge or PaymentIntent, the system saves that ID through a script in the collection, which is then accessible for later requests, like issuing a refund.

Add a secret key to a Postman collection