The Test Clock objectTest helper
Attributes
- idstring
Unique identifier for the object.
- objectstring
String representing the object’s type. Objects of the same type share the same value.
- createdtimestamp
Time at which the object was created. Measured in seconds since the Unix epoch.
- deletes_
aftertimestamp Time at which this clock is scheduled to auto delete.
- frozen_
timetimestamp Time at which all objects belonging to this clock are frozen.
- livemodeboolean
If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - namenullable string
The custom name supplied at creation.
- statusenum
The status of the Test Clock.
Possible enum valuesadvancingIn the process of advancing time for the test clock objects.
internal_failure Failed to advance time. Future requests to advance time will fail.
readyAll test clock objects have advanced to the
frozen_.time - status_
detailsobject Details on the current state of the Test Clock.
{ "id": "clock_1Mr3I22eZvKYlo2Ck0rgMqd7", "object": "test_helpers.test_clock", "created": 1680112806, "deletes_after": 1680717606, "frozen_time": 1577836800, "livemode": false, "name": null, "status": "ready"}Create a test clockTest helper
Creates a new test clock that can be attached to new customers and quotes.
Parameters
- frozen_
timetimestampRequired The initial frozen time for this test clock.
- namestring
The name for this test clock.
The maximum length is 300 characters.
More parameters
- customerstring
Returns
The newly created TestClock object is returned upon success. Otherwise, this call raises an error.
{ "id": "clock_1Mr3I22eZvKYlo2Ck0rgMqd7", "object": "test_helpers.test_clock", "created": 1680112806, "deletes_after": 1680717606, "frozen_time": 1577836800, "livemode": false, "name": null, "status": "ready"}Retrieve a test clockTest helper
Retrieves a test clock.
Parameters
No parameters.
Returns
Returns the TestClock object. Otherwise, this call raises an error.
curl https://api.stripe.com/v1/test_helpers/test_clocks/{{TEST_CLOCK_ID}} \ -u "sk_test_Hrs6SAopgFPF0bZXSN3f6ELNsk_test_Hrs6SAopgFPF0bZXSN3f6ELN:"{ "id": "clock_1Mr3I22eZvKYlo2Ck0rgMqd7", "object": "test_helpers.test_clock", "created": 1680112806, "deletes_after": 1680717606, "frozen_time": 1577836800, "livemode": false, "name": null, "status": "ready"}