Testing

Sandbox is the default environment — completely isolated from production.

Test Flow

// 1. Create customer
const customerId = `test_${Date.now()}`
const customer = await commet.customers.create({
  email: 'test@example.com',
  id: customerId,
})

// 2. Create subscription
const subscription = await commet.subscriptions.create({
  customerId,
  planCode: 'pro',
})

// 3. Pay with test card at checkoutUrl

// 4. Track usage
await commet.usage.track({
  customerId,
  featureCode: 'api_calls',
})

Dev Tools Panel

A floating widget that appears on all sandbox pages. The Test Clock tab is available everywhere. The Test Data tab (address and card presets) only appears on checkout pages.

Test Clock

Simulate future dates to test billing cycles, renewals, and prorations without waiting for real time to pass. Advancing the clock from the dashboard processes every due billing deadline before the clock reaches the selected time.

Current Time — displays the simulated time in UTC, or the real time if no simulation is active.

Set Time — pick a future date from a calendar. Before the run starts, the panel shows the target time and the number of currently scheduled deadlines it expects to process. Time can only move forward and cannot be reverted.

Quick Advance — jump forward by a preset amount:

Run progress — after confirmation, the panel processes due renewals, trial endings, scheduled changes, cancellations, entitlement resets, and dunning retries in chronological order. Progress and per-subscription outcomes remain visible if you reload or reopen the panel.

Example workflow: choose + 1 Month, review the estimated impact, then confirm Advance and Process. The clock reaches the target after the run finishes.

Test Clock with the SDK

The API starts the same durable run as the dashboard. Advancing the clock returns 202 Accepted with the new run; poll the clock state to follow its progress and terminal per-deadline outcomes. These methods are sandbox only.

Read the current state

const clock = await commet.testClock.get()

clock = commet.test_clock.get()

clock, err := client.TestClock.Get(ctx)

var clock = commet.testClock().get();

$clock = $commet->testClock->get();

curl "https://commet.co/api/v1/test-clock" \
  -H "x-api-key: $COMMET_API_KEY"

Advance the clock and process billing

Move the clock forward and process every billing deadline due before the target time. The clock can only move forward.

await commet.testClock.advance({ advanceDays: 30 })

commet.test_clock.advance(advance_days=30)

days := 30
_, err := client.TestClock.Advance(ctx, &commet.AdvanceTestClockParams{
    AdvanceDays: &days,
})

commet.testClock().advance(AdvanceTestClockParams.builder().advanceDays(30L).build());

$commet->testClock->advance(advanceDays: 30);

curl -X POST https://commet.co/api/v1/test-clock \
  -H "x-api-key: $COMMET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"advanceDays": 30}'

The former POST /test-clock/process-billing operation is deprecated and returns 410 Gone. Remove separate processBilling() calls; advancing the clock now performs that work automatically.

Test Data

The Test Data tab automates checkout form filling with valid, country-specific test data. Open it from the Dev Tools panel on any sandbox checkout page.

Address autofill — select a country and the checkout form is automatically filled with a valid name, email, street, city, state, and postal code for that country. No need to type anything manually.

Country-specific test cards — after selecting a country, the panel shows the test cards that match that country. Click one and the card fields are filled for you. Expiry and CVC are always 12/34 and 123.

Failure scenarios — the panel also offers generic cards to test error handling: declined payment, insufficient funds, and expired card. For 3D Secure authentication, use the cards in the table below.

Test cards by country

Failure scenarios

3D Secure

Production

const commet = new Commet({
  apiKey: process.env.COMMET_PRODUCTION_KEY!,
})