Core Resources
Payment Methods
Products
Checkout
Payment Links
Billing
Capital
Connect
Fraud
Issuing
Terminal
Treasury
Entitlements
Sigma
Reporting
Financial Connections
Tax
Identity
Crypto
Climate
Forwarding
Privacy
Webhooks

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 dictionary 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
curl -G https://api.stripe.com/v1/test_helpers/test_clocks \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -d limit=3
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 raises an error.

DELETE /v1/test_helpers/test_clocks/:id
curl -X DELETE https://api.stripe.com/v1/test_helpers/test_clocks/clock_1Mr3I22eZvKYlo2Ck0rgMqd7 \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:"
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 raises an error.

POST /v1/test_helpers/test_clocks/:id/advance
curl https://api.stripe.com/v1/test_helpers/test_clocks/clock_1Mr3I22eZvKYlo2Ck0rgMqd7/advance \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -d frozen_time=1680199613
Response
{
  "id": "clock_1Mr3I22eZvKYlo2Ck0rgMqd7",
  "object": "test_helpers.test_clock",
  "created": 1680112806,
  "deletes_after": 1680717606,
  "frozen_time": 1577836800,
  "livemode": false,
  "name": null,
  "status": "advancing"
}

Financing Offer Preview

This is an object representing an offer of financing from Stripe Capital to a Connect subaccount.

Endpoints

Financing Summary Preview

A financing object describes an account’s current financing state. Used by Connect platforms to read the state of Capital offered to their connected accounts.

Endpoints