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 and without creating new webhook endpoints.

Choose an installation method

npm

The CLI is published to npm. It requires Node.js >= 22. To install with npm run:

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

Homebrew

To install with Homebrew run:

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

To update run:

brew update && brew upgrade fintoc

Log in to the CLI

Authenticate the CLI with a Fintoc API key.

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

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 doctor verifies 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