Install the TypeScript SDK

Conto connects on the buyer side. The agent owner or budget holder configures policy; the buyer’s runtime or payment tools check it before execution. Merchants do not install Conto. See buyer-side control for the authorization boundary. The SDK supports Node.js 20.19+. The runnable examples below use Node.js 20.19+ for loading an environment file. Keep SDK credentials in your server or agent runtime, never in browser code.

Install

npm install @conto_finance/sdk

pnpm add @conto_finance/sdk

yarn add @conto_finance/sdk

Choose your client

Task	Client	Credential
Request payments and read an agent’s state	`Conto`	Agent SDK key in `CONTO_API_KEY`
Provision agents, wallets, and policies	`ContoAdmin`	Organization API key in `CONTO_ORG_API_KEY`

Obtain keys with the quickstart or authentication guide. Save the needed key in .env.local and add that file to .gitignore.

import { Conto, ContoAdmin } from '@conto_finance/sdk';

const conto = new Conto({ apiKey: process.env.CONTO_API_KEY! });
const admin = new ContoAdmin({ orgApiKey: process.env.CONTO_ORG_API_KEY! });

Create only the client your application needs. An admin agent SDK key still belongs to an agent; it is not an organization key for ContoAdmin.

Verify without creating a payment

Save as verify.mjs. Setup uses the same agent key as the SDK and does not create a payment record.

import { Conto } from '@conto_finance/sdk';
const conto = new Conto({ apiKey: process.env.CONTO_API_KEY });
const setup = await conto.setup();
console.log('Agent:', setup.agent.name);
console.log('Wallets:', setup.wallets);
console.log('Scopes:', setup.scopes);

node --env-file=.env.local verify.mjs

Check the intended wallet, network, and payment scopes. In a CLI-created project you can also run npx conto doctor.

Configuration

Option	Default	Meaning
`apiKey`	Required	Agent SDK key for `Conto`
`baseUrl`	`https://conto.finance`	API origin
`timeout`	`30000`	Request timeout in milliseconds

The SDK retries eligible reads and idempotency-protected authorization. Execution is not retried automatically. See retry behavior.

Start building

Make a payment: request, execute, and status contracts.
Track and recover a payment: required actions, uncertainty, and settlement.
Add payments to a server: authenticated Express and Lambda handlers.
Connect framework tools: OpenAI, Claude, LangChain, and Python HTTP examples.
Provision with the admin SDK: organization-level automation.

Get started

Payments

Spending controls

Integrations

Production

Conto Pay

Install the TypeScript SDK

Install

Choose your client

Verify without creating a payment

Configuration

Start building

​Install

​Choose your client

​Verify without creating a payment

​Configuration

​Start building

Install

Choose your client

Verify without creating a payment

Configuration

Start building