Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

4466 articles

Simulate subscriptions


Simulate subscriptions

Learn how to simulate subscriptions in a sandbox.

Simulating a subscription shows you the events of a subscription that are expected over the course of the simulation time, such as invoices and renewals.

Note

When you run a simulation on a subscription, you can see it in Subscriptions > Simulations in the Dashboard. To delete a simulation, click Finish simulation. Finishing a simulation deletes all objects associated with it from the sandbox, including the customer and subscription. It doesn’t affect live mode.

To simulate a subscription:

  1. Open the Dashboard and create a sandbox.
  2. On the Subscriptions page, click the subscription to test.
  3. Click Run simulation in the banner at the top of the page. Customer ineligible for simulation The Run simulation button might be disabled if the subscription’s customer: Is attached to more than three subscriptions, including scheduled subscriptions Has a complex profile, with many quotes, invoices or other related objects
  4. In the modal, set the date and time to simulate and click Advance time .

You can advance time by any increment, but you can only advance the clock two intervals at a time from the initial frozen time. For example, if you have a monthly subscription, you can only advance the clock up to two months at a time.

When the simulation is done, the banner updates and displays the current time.

You can continue to make changes to your simulation and advance the time for simulations such as:

Repeat as many times as you need to satisfy your test case.

Last verified 2026-09-24

Is this helpful?