Testing

Sandbox es el entorno por defecto — completamente aislado de producción.

Flujo de testing

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

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

// 3. Pagar con una tarjeta de prueba en checkoutUrl

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

Panel Dev Tools

Un widget flotante que aparece en todas las páginas de sandbox. La pestaña Test Clock está disponible en todos lados. La pestaña Test Data (presets de dirección y tarjeta) solo aparece en páginas de checkout.

Test Clock

Simula fechas futuras para probar ciclos de cobro, renovaciones y prorrateos sin esperar a que pase el tiempo real. Al avanzar el reloj desde el dashboard, se procesa cada deadline de billing vencido antes de que el reloj alcance la fecha elegida.

Current Time — muestra el tiempo simulado en UTC, o el tiempo real si no hay simulación activa.

Set Time — elige una fecha futura desde un calendario. Antes de iniciar la corrida, el panel muestra la fecha objetivo y la cantidad de deadlines actualmente programados que espera procesar. El tiempo solo puede avanzar y no puede revertirse.

Quick Advance — salta adelante por una cantidad predefinida:

Progreso de la corrida — después de confirmar, el panel procesa en orden cronológico las renovaciones, finales de trials, cambios y cancelaciones programadas, resets de entitlements y reintentos de dunning vencidos. El progreso y los resultados por suscripción siguen visibles si recargas o vuelves a abrir el panel.

Flujo de ejemplo: elige + 1 mes, revisa el impacto estimado y confirma Advance and Process. El reloj alcanza la fecha objetivo cuando termina la corrida.

Test Clock con el SDK

La API inicia la misma corrida durable que el dashboard. Avanzar el reloj devuelve 202 Accepted con la nueva corrida; consulta el estado del reloj para seguir su progreso y los resultados terminales por deadline. Estos métodos son solo para sandbox.

Leer el estado actual

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"

Avanzar el reloj y procesar billing

Avanza el reloj y procesa cada deadline de billing vencido antes de la fecha objetivo. El reloj solo puede avanzar.

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}'

La operación anterior POST /test-clock/process-billing está deprecada y devuelve 410 Gone. Elimina las llamadas separadas a processBilling(); avanzar el reloj ahora ejecuta ese trabajo automáticamente.

Test Data

La pestaña Test Data automatiza el llenado del formulario de checkout con datos de prueba válidos por país. Ábrela desde el panel Dev Tools en cualquier página de checkout sandbox.

Autocompletado de dirección — selecciona un país y el formulario del checkout se llena automáticamente con un nombre, email, calle, ciudad, provincia/estado y código postal válidos para ese país. No hace falta tipear nada a mano.

Tarjetas de prueba por país — después de elegir un país, el panel muestra las tarjetas de prueba que corresponden. Haz clic en una y los campos de tarjeta se llenan solos. La fecha de vencimiento y el CVC son siempre 12/34 y 123.

Escenarios de fallo — el panel también ofrece tarjetas genéricas para probar el manejo de errores: pago rechazado, fondos insuficientes y tarjeta vencida. Para autenticación 3D Secure, usa las tarjetas de la tabla de abajo.

Tarjetas de prueba por país

Escenarios de fallo

3D Secure

Producción

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