---
# @generated by sylphx-gen. Do not edit.
title: "sylphx money test_clocks"
description: "The sylphx money test_clocks commands of Sylphx Money: every verb, with its argument, its flags and a run line."
type: reference
product: payments
summary: "Every sylphx money test_clocks command: its argument, its flags and a run line."
updated: 2026-09-28
nav: false
---

The `test_clocks` commands of Sylphx Money, as the CLI spells them: the same
calls as [the `test_clocks` API page](/docs/api/test_clocks), typed for the
shell. [Install, sign in and the grammar](/docs/cli) are on the CLI index.

## create

Creates a test-only Stripe simulation before the subject's first checkout. No catalogue, payment, subscription, or entitlement is changed.

**`ID`** — The id segment of the new Resource's name; the server assigns one when omitted.

**CLI**

```bash
sylphx money test-clocks create --parent orgs/acme/projects/shop/envs/production
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/test_clocks` · scope `billing:write` · effect `write` · [Request, response and examples](/docs/api/test_clocks/create)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--parent` | `string` | The parent to create in; defaults to the linked project or the key's scope. |
| `--subject.end-user` | `string` | An end user's id (Sylphx Auth, or the app's own OIDC issuer). |
| `--subject.customer-organization` | `string` | A customer organization's id. |
| `--frozen-time` | `timestamp` | Initial simulated time on create; current Stripe time on reads. Required on create. Only whole seconds are supported. Required. |

## get

Reads the owned test clock back from Stripe. Live keys are refused.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx money test-clocks get orgs/acme/projects/shop/envs/production/test_clocks/test-clock
```

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/test_clocks/test-clock` · scope `billing:read` · effect `read` · [Request, response and examples](/docs/api/test_clocks/get)

## advance

Advances Stripe time, never entitlements. Stripe processes asynchronously; poll GetTestClock until ready, then observe the genuine webhook's effects. Time only moves forward, within Stripe's subscription-interval bound.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx money test-clocks advance orgs/acme/projects/shop/envs/production/test_clocks/test-clock
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/test_clocks/test-clock:advance` · scope `billing:write` · effect `write` · [Request, response and examples](/docs/api/test_clocks/advance)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--frozen-time` | `timestamp` | Target simulated time. Whole seconds; must not precede current time. Repeating an already reached target is idempotent. Required. |