Install the Fintoc CLI

The Fintoc CLI lets you make API requests and listen to webhooks from the command line. You can use the Fintoc CLI to:

• Create, retrieve, update, or delete any of your Fintoc resources in test mode.
• Receive real-time webhooks at localhost without a public tunnel.

Choose an installation method

npm

The CLI is published to npm. It requires Node.js >= 22.

npm install -g @fintoc/cli
fintoc --version

Homebrew

brew install fintoc-com/tap/fintoc
fintoc --version

Log in to the CLI

Authenticate the CLI with a Fintoc API key. The CLI stores the key in ~/.fintoc/config.toml, readable only by your OS user.

fintoc login

This opens an interactive flow. If you don't want to use a browser, pass the API key inline with the --api-key flag:

fintoc login --api-key sk_test_xxx

For CI/CD pipelines, prefer the FINTOC_API_KEY environment variable instead, so the key is not persisted to disk. See Use the CLI in CI.

You can also skip persisting the credential by exporting the FINTOC_API_KEY environment variable; the CLI picks it up automatically. See Fintoc CLI keys for the full precedence order.

Verify your setup

fintoc doctorverifies your CLI setup. It checks the resolved API key, the Node.js version, the path of the config file, and reachability of api.fintoc.com. Run it to debug authentication or connectivity errors.

fintoc doctor