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,
  feature: '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.

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. El tiempo solo puede avanzar y no puede revertirse.

Quick Advance — salta adelante por una cantidad predefinida:

Run Billing Cron — dispara manualmente el procesamiento de cobros en el tiempo simulado. Procesa renovaciones, genera recibos y aplica cargos por uso.

Flujo de ejemplo: avanza 1 mes para llegar al próximo ciclo de cobro, luego ejecuta el cron de billing para generar los recibos de renovación y verificar los cargos.

Test Data

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

Autocompletado de dirección — selecciona un país y el formulario de dirección del checkout se llena automáticamente con un nombre, calle, ciudad, código postal y teléfono 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 el número de tarjeta de prueba que corresponde. Haz clic para copiar. La fecha de vencimiento y el CVC son siempre 12/34 y 123.

Escenarios de fallo — hay tarjetas genéricas disponibles para probar el manejo de errores: pagos rechazados, fondos insuficientes, tarjetas vencidas y autenticación 3D Secure. Mira las tablas abajo.

Tarjetas de prueba por país

Escenarios de fallo

3D Secure

Producción

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