Retrieve a test clock Test helper

Retrieves a test clock.

Parameters

No parameters.

Returns

Returns the TestClock object. Otherwise, this call returns an error.

GET /v1/test_helpers/test_clocks/:id

Server-side language

stripe.Key = "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2"
params := &stripe.TestHelpersTestClockParams{}
result, err := testclock.Get("clock_1Mr3I22eZvKYlo2Ck0rgMqd7", params)

Response

{
  "id": "clock_1Mr3I22eZvKYlo2Ck0rgMqd7",
  "object": "test_helpers.test_clock",
  "created": 1680112806,
  "deletes_after": 1680717606,
  "frozen_time": 1577836800,
  "livemode": false,
  "name": null,
  "status": "ready"
}

List all test clocks Test helper

Returns a list of your test clocks.

Parameters

No parameters.

More parameters

ending_beforestring

limitinteger

starting_afterstring

Returns

A map with a data property that contains an array of up to limit test clocks, starting after starting_after. Each entry in the array is a separate test clock object. If no more test clocks are available, the resulting array will be empty.

GET /v1/test_helpers/test_clocks

Server-side language

stripe.Key = "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2"
params := &stripe.TestHelpersTestClockListParams{}
params.Limit = stripe.Int64(3)
result := testclock.List(params)

Response

{
  "object": "list",
  "url": "/v1/test_helpers/test_clocks",
  "has_more": false,
  "data": [
    {
      "id": "clock_1Mr3I22eZvKYlo2Ck0rgMqd7",
      "object": "test_helpers.test_clock",
      "created": 1680112806,
      "deletes_after": 1680717606,
      "frozen_time": 1577836800,
      "livemode": false,
      "name": null,
      "status": "ready"
    }
  ]
}

Delete a test clock Test helper

Deletes a test clock.

Parameters

No parameters.

Returns

The deleted TestClock object is returned upon success. Otherwise, this call returns an error.

DELETE /v1/test_helpers/test_clocks/:id

Server-side language

stripe.Key = "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2"
params := &stripe.TestHelpersTestClockParams{}
result, err := testclock.Del("clock_1Mr3I22eZvKYlo2Ck0rgMqd7", params)

Response

{
  "id": "clock_1Mr3I22eZvKYlo2Ck0rgMqd7",
  "object": "test_helpers.test_clock",
  "deleted": true
}

Advance a test clock Test helper

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.

Returns

A TestClock object with status Advancing is returned upon success. Otherwise, this call returns an error.

POST /v1/test_helpers/test_clocks/:id/advance

Server-side language

stripe.Key = "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2"
params := &stripe.TestHelpersTestClockAdvanceParams{
  FrozenTime: stripe.Int64(1680199613),
}
result, err := testclock.Advance("clock_1Mr3I22eZvKYlo2Ck0rgMqd7", params)

Response

{
  "id": "clock_1Mr3I22eZvKYlo2Ck0rgMqd7",
  "object": "test_helpers.test_clock",
  "created": 1680112806,
  "deletes_after": 1680717606,
  "frozen_time": 1577836800,
  "livemode": false,
  "name": null,
  "status": "advancing"
}