Test Clocks

Test clocks let you control time for sandbox customers and their billing resources. Create a clock, pass its ID as test_clock when creating a customer, then create a subscription for that customer. Use a scoped sandbox API key for all clock operations.

Advance the clock and retrieve it until its status is ready. Then inspect the subscription, PaymentIntent, and invoice. Invoices may become visible later. A clock with status blocked has stopped before completing the advance.