Test your integration with test clocks

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