Skip to content
Create account or Sign in
The Stripe Docs logo
/
Ask AI
Create accountSign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
APIs & SDKsHelp
Overview
Billing
OverviewAbout the Billing APIs
Subscriptions
Invoicing
Usage-based billing
Quotes
Customer management
Billing with other products
Revenue recovery
Automations
Test your integration
    Overview
    Test clocks
      Simulate subscriptions
      API and advanced usage
    Test your invoicing integration
Tax
Overview
Use Stripe tax
Manage compliance
Reporting
Overview
Select a report
Configure reports
Reports for multiple accounts
Reports API
Revenue recognition
Data
Overview
Query business data
Sigma
Data Pipeline
Import external data
United States
English (United Kingdom)
HomeRevenueTest your integration

Test your integration with test clocks

Learn how to move Billing objects through time in a sandbox.

Test clocks help you test your Billing integration and make sure it behaves as designed. When you use test clocks, you simulate the forward movement of time in sandbox, which causes Billing resources, like Subscriptions, to change state and trigger webhook events. This means that, for example, you don’t have to wait a year to see how your integration handles a payment failure for a quarterly or annual renewal.

Here are some other things you can do with test clocks:

  • Test complex simulations such as upgrading or changing plans mid-cycle.
  • Ensure your integration processes Billing lifecycle webhooks correctly.
  • Validate that your app handles trials correctly.
  • Build and test multi-phase subscription schedules.

How to use test clocks

Simulate subscriptions

Learn how to simulate subscriptions in a sandbox.

API and advanced usage

Learn advanced strategies for using test clocks in the Dashboard and API.

Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc