Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
Overview
Billing
OverviewAbout the Billing APIs
Subscriptions
Invoicing
Usage-based billing
Quotes
Customer management
Billing with other products
Revenue recovery
Automations
Revenue recognition
Test your integration
    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 API
Reports for multiple accounts
Revenue recognition
Data
OverviewSchema
Custom reports
Data Pipeline
Data management
HomeRevenueTest your integration

Test your integration with test clocks

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

Overview

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.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc