Quickstart | TilcAI Docs

Connect your backend and discover its routes before preparing a payment.

1. Prepare your environment

You need Node.js 20 or later, a reachable tilcai-infrastructure instance and a tenant key with the payments scope. There is no universal public API URL: use your deployment URL or one supplied by its operator.

Terminal

npm install tilcai-sdk

.env · server only

TILCAI_API_URL=https://YOUR_INSTANCE
TILCAI_API_KEY=YOUR_SERVER_SIDE_KEY
TILCAI_NETWORK=testnet

2. Check the instance

check.ts

import { Tilcai } from "tilcai-sdk";

const tilcai = Tilcai.fromEnv();
const health = await tilcai.verifyEnvironment();
const routes = await tilcai.routes();

console.log(health.env, health.transactionsEnabled);
console.log(routes);

3. Choose the next step

The advertised network, route modes and instance status determine what you can do. Prepare a quote with the SDK · Review network coverage.