Obtén tu clave de API

Cada solicitud a Cosmos Pay se autentica con una clave de API. Creas y administras las claves en el panel de desarrolladores. Una clave lleva dos cosas que importan: el entorno al que pertenece (que elige testnet o mainnet, en todas las redes) y los alcances que tiene permitido usar.

Crear una clave

1. Inicia sesión en la plataforma de desarrolladores en dev.cosmospay.lat y abre el Panel.
2. Elige el entorno con el interruptor Test / Production del panel:
   • Test emite claves dv_… que corren en testnet; úsalas mientras desarrollas.
   • Production emite claves prod_… que corren en mainnet; úsalas para salir a producción.
3. Ve a API Keys → Create.
4. Dale a la clave un nombre (y una descripción opcional) para que puedas reconocerla más tarde.
5. Elige un rol:
   • User: con alcances. Elige exactamente los permisos que necesita en la matriz (por recurso: read o write, o ambos, para pagos, webhooks, productos, clientes y analíticas).
   • Admin: acceso completo; omite la matriz de alcances. Úsalo con moderación.
6. Crea la clave y luego cópiala de inmediato.

Usar la clave

Mantén la clave en tu servidor y pásala al SDK (o envíala como token Bearer a la API REST):

import { Client } from '@cosmosapp/pay_sdk';

// Reads e.g. COSMOS_PAY_API_KEY from your server environment; never hard-code it.
const client = new Client({ apiKey: process.env.COSMOS_PAY_API_KEY });

Authorization: Bearer dv_xxxxxxxxxxxxxxxxxxxxxxxx

Buenas prácticas

• Una clave por entorno / servicio. No reutilices una clave prod_ en test, y rota las claves por servicio para que puedas revocar una sin afectar al resto.
• Nunca envíes una clave al navegador. El cliente web firma transacciones con la billetera del usuario y no necesita tu clave.
• Rota ante una exposición. Si una clave se filtra, rótala en el panel: el valor antiguo deja de funcionar de inmediato.

Próximos pasos