Saltar al contenido principal
La Fintoc CLI te permite hacer solicitudes a la API y escuchar webhooks desde la línea de comandos. Puedes usar la Fintoc CLI para:
  • Crear, obtener, actualizar o eliminar cualquiera de tus recursos de Fintoc en modo test.
  • Recibir webhooks en tiempo real en localhost sin un túnel público y sin crear nuevos webhook endpoints.

Elige un método de instalación

npm

La CLI está publicada en npm y funciona en macOS, Linux y Windows. Requiere Node.js >= 22. En Windows, instala con npm, ya que Homebrew no está disponible. Para instalar con npm ejecuta:
npm install -g @fintoc/cli funciona en PowerShell y en el Símbolo del sistema en Windows.

Homebrew

Homebrew está disponible en macOS y Linux. Para instalar con Homebrew ejecuta:
Para actualizar ejecuta:

Iniciar sesión en la CLI

Autentica la CLI con una API key de Fintoc.
Esto abre un flujo interactivo. Si no quieres usar un navegador, pasa la API key inline con la flag --api-key:
Por defecto, fintoc login autentica en modo test. Pasa --mode live para iniciar sesión en modo live en su lugar. También puedes omitir la persistencia de la credencial exportando la variable de entorno FINTOC_API_KEY; la CLI la detecta automáticamente. Consulta Llaves de la Fintoc CLI para ver el orden completo de precedencia.

Verifica tu configuración

fintoc doctor verifica tu configuración de la CLI. Revisa la API key resuelta, la versión de Node.js, la ruta del archivo de configuración y la conectividad a api.fintoc.com. Ejecútalo para depurar errores de autenticación o conectividad.