Adds customer parameter to test clock creation
What’s new
You can now attach an existing customer when you create a test clock by using the new customer parameter.
The customer parameter accepts an existing customer ID and attaches that customer to the test clock during creation. After you attach a customer to a test clock, it can’t be removed.
Impact
You can now programmatically create test clocks that are pre-attached to specific customers, streamlining your testing workflows. This eliminates the need to use the Dashboard for this functionality and allows you to fully automate your test clock setup through the API.
If you previously relied on Dashboard-only functionality to attach customers to test clocks, you can now incorporate this step directly into your API-based testing processes.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| customer | Added | TestHelpers. TestClock#create |
Upgrade
- View your current API version in Workbench.
- If you use an SDK, upgrade to the corresponding SDK version for this API version.
- If you don’t use an SDK, update your API requests to include Stripe-Version: 2026-05-27. dahlia
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.
Related changes
- Adds discount eligibility options for add-on invoice items on Subscriptions and Preview Invoice APIs
- Adds amount paid off Stripe property to Invoice object
- Adds billing schedules to enable prebilling on subscriptions
- Adds discount and discounts properties to pending subscription updates
- Adds metadata support to pending subscription updates
- Adds credited items information to invoice item proration details