Test Clocks

Test clocks let you fast-forward time for a set of sandbox customers so you can watch payment plans renew, retries fire, and links expire without waiting for real days to pass. They’re available for sandbox accounts only.

Where to find them

Go to Developer → Test Clocks in a sandbox account. From there you can:

• Create a clock with a name and a starting simulated time
• View each clock’s status and advance history
• Advance a clock with the date/time picker — it defaults to one day forward, and the maximum step depends on the billing cycles attached (advancing further just takes multiple steps)
• Delete a clock

Attaching customers

Customers join a clock at creation: on the New Customer form, choose the clock in the Test Clock field. The field only appears for sandbox accounts, and the association can’t be changed later.

Customers on a clock are kept out of your normal customer list — filter by the clock to see them.

Things to know

• A clock lives for 30 days, then it and all of its customers (and their plans and payments) are deleted permanently
• Up to 3 customers per clock and 3 active clocks at a time
• Clocks only move forward — to start over, delete and recreate
• Not everything moves with the clock — settlement and BECS collection outcomes stay on real time

Integrating via the API instead? See the Test Clocks developer guide.