Saltar al contenido principal
Cuando ejecutas fintoc login, la CLI guarda tu secret key en ~/.fintoc/config.toml con permisos de archivo 0600, legible solo por el usuario actual del sistema operativo. También puedes pasar las llaves de forma inline o mediante una variable de entorno para scripting y CI.

​
Orden de resolución de la llave

La CLI resuelve la API key en este orden de precedencia:
  1. La flag --api-key pasada inline en el comando.
  2. La variable de entorno FINTOC_API_KEY.
  3. La llave guardada en ~/.fintoc/config.toml por fintoc login.
La fuente que se resuelva primero es la que gana. Esta precedencia te permite mantener una llave por defecto en modo test en tu archivo de configuración y sobrescribirla por comando. Usa la sobrescritura para cambiar entre organizaciones de Fintoc o entre modo test y live.

​
Ver tu configuración activa

Esto imprime la API key actualmente en uso (enmascarada), el entorno resuelto y la ruta del archivo de configuración.

​
Cambiar de llave

Para cambiar la llave persistida, cierra sesión y vuelve a iniciar sesión:
Para sobrescribir la llave persistida en un solo comando:

​
Usar la CLI en CI

Para pipelines de CI/CD, configura FINTOC_API_KEY como una variable de entorno secreta en tu proveedor (por ejemplo, GitHub Actions o CircleCI) y evita persistir credenciales en disco:
Esto evita el flujo interactivo de fintoc login y mantiene la llave fuera del historial del shell.

​
Modo test vs modo live

Cada API key de Fintoc está vinculada a modo test o modo live. La CLI infiere el modo a partir del prefijo de la llave:
  • sk_test_... para modo test. Seguro para desarrollo local; no se crean pagos ni reembolsos reales.
  • sk_live_... para modo live. Tráfico de producción. Úsala con precaución.
La CLI funciona tanto con modo test como con modo live. Los comandos de recursos (como fintoc payment_intents list) funcionan con cualquiera de las dos llaves. Las operaciones de solo desarrollador funcionan únicamente en modo test y fallan con una llave live. El fintoc login interactivo usa modo test por defecto. Para autenticarte en modo live, pasa --mode live: