Creá una API key

Cada API key identifica una organización y un entorno de Commet. Una key de sandbox solo accede a datos de sandbox; una key live solo accede a datos live.

Creá una key de sandbox

1. Abrí tu organización sandbox en el dashboard.
2. Entrá en Settings → API Keys.
3. Creá una key con un nombre que identifique la aplicación o el entorno.
4. Copiala cuando aparezca y guardala en el secret manager de tu servidor.

COMMET_API_KEY=ck_sandbox_xxxxxxxxx

Commet no vuelve a mostrar el secreto completo. Si lo perdés, creá un reemplazo y eliminá la key anterior después de verificar el nuevo deploy.

Inicializá el SDK en el servidor

import { Commet } from "@commet/node"

export const commet = new Commet({
  apiKey: process.env.COMMET_API_KEY,
})

Nunca expongas la key en código del navegador, variables públicas, logs, screenshots o prompts para agentes. Los requests directos a la API REST se autentican con el header x-api-key.

Separá las keys por entorno

Guardá las credenciales de sandbox y live en entornos de deploy distintos. Un paso a producción seguro sigue este orden:

1. Implementá y probá con la key de sandbox.
2. Verificá checkout, webhooks y una renovación con el Test Clock.
3. Agregá una key live al secret store de producción.
4. Desplegá sin copiar IDs de sandbox en la configuración live.

Rotá una key

Creá primero el reemplazo, desplegalo, verificá requests exitosos y recién entonces eliminá la key anterior. También podés gestionar keys desde la referencia generada de API Keys.

Usá una key por workload cuando necesites rotación o límites de auditoría independientes. No reutilices en producción la key local de un desarrollador.