Delete a test clock v1Test helper
DELETE /
Deletes a test clock.
Parameters
- idstringRequired
Unique identifier for the object.
Returns
The deleted TestClock object is returned upon success. Otherwise, this call raises an error.
curl -X DELETE https://api.stripe.com/v1/test_helpers/test_clocks/{{TEST_CLOCK_ID}} \ -u "sk_test_...sk_test_...:" \ -H "Stripe-Version: 2026-10-28.endive"Response
{ "id": "clock_1Mr3I22eZvKYlo2Ck0rgMqd7", "object": "test_helpers.test_clock", "deleted": true}Advance a test clock v1Test helper
POST /
Starts advancing a test clock to a specified time in the future. Advancement is done when status changes to Ready.
Parameters
- frozen_
timetimestampRequired The time to advance the test clock. Must be after the test clock’s current frozen time. Cannot be more than two intervals in the future from the shortest subscription in this test clock. If there are no subscriptions in this test clock, it cannot be more than two years in the future.
- idstringRequired
Unique identifier for the object.
Returns
A TestClock object with status Advancing is returned upon success. Otherwise, this call raises an error.
curl https://api.stripe.com/v1/test_helpers/test_clocks/{{TEST_CLOCK_ID}}/advance \ -u "sk_test_...sk_test_...:" \ -H "Stripe-Version: 2026-10-28.endive" \ -d frozen_time=1680199613Response
{ "id": "clock_1Mr3I22eZvKYlo2Ck0rgMqd7", "object": "test_helpers.test_clock", "created": 1680112806, "deletes_after": 1680717606, "frozen_time": 1577836800, "livemode": false, "name": null, "status": "advancing"}