Configuracion de la plataforma
Esta guia explica como preparar tu cuenta de desarrollador de Linka y configurar API keys para sandbox y produccion.
Requisitos previos
Antes de empezar, asegúrate de tener:
- Una cuenta de Linka o acceso al onboarding en linka.xyz.
- Acceso al dashboard de tu cuenta.
- Un lugar seguro para guardar API keys.
Paso 1: Accede al dashboard
- Inicia sesion en tu cuenta de Linka.
- Entra a la seccion Developer.
- Abre API Keys para administrar tus llaves.
Paso 2: Genera API keys
Llaves de produccion
- En la seccion de API keys, haz clic en Create New Key.
- Asigna un nombre descriptivo, por ejemplo
Produccion - Servicio de pagos. - Selecciona los permisos necesarios:
- Read: ver transacciones y balances.
- Write: crear transacciones y wallets.
- Admin: acceso completo, incluida administracion de cuenta.
- Haz clic en Generate Key.
- Copia la llave inmediatamente. No podras verla otra vez.
Llaves de sandbox
Para pruebas, usa el ambiente sandbox:
- Cambia a Sandbox Mode en el dashboard.
- Genera API keys siguiendo el mismo proceso.
- Las llaves sandbox funcionan igual que las de produccion, pero no procesan transacciones reales.
Paso 3: Configura tu ambiente
Guarda las llaves de forma segura usando variables de entorno:
LINKA_API_KEY=sk_live_...
LINKA_API_URL=https://api.linka.xyz
LINKA_API_KEY=sk_test_...
LINKA_API_URL=https://api.sandbox.linka.xyz
Paso 4: Prueba la conexion
Realiza una solicitud de prueba para validar la configuracion:
curl https://api.linka.xyz/v1/health \
-H "Authorization: Bearer $LINKA_API_KEY"
Deberias recibir una respuesta 200 OK con informacion de la cuenta.
Buenas practicas de seguridad
- Nunca subas API keys al control de versiones.
- Usa variables de entorno para todas las llaves.
- Rota las llaves regularmente, al menos cada 90 dias.
- Usa llaves separadas para servicios y ambientes distintos.
- Revoca llaves sin uso inmediatamente.
Siguientes pasos
- Configura webhooks.
- Prueba en sandbox.
- Revisa autenticacion.