> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solvapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> SolvaPay quick facts:
> - REST API base URL: https://api.solvapay.com. All public endpoints are under /v1/sdk/ (for example GET https://api.solvapay.com/v1/sdk/products). Sandbox and production share this URL.
> - Auth: send a secret key as `Authorization: Bearer <secret key>` (the REST API also accepts `X-API-Key: <secret key>`).
> - Secret key prefixes: `sk_sandbox_` (sandbox, test payments) and `sk_live_` (production). The prefix selects the environment.
> - Get keys in SolvaPay Console (https://app.solvapay.com) > Developers > API Keys. Use a sandbox key while building.
> - Admin MCP Server: https://mcp.solvapay.com/mcp (Streamable HTTP). Connect with OAuth: add the URL and sign in with the SolvaPay account; no API key needed. OAuth sessions use the live account; for sandbox data or headless clients, send `Authorization: Bearer <secret key>` (X-API-Key is ignored).
> - Install the SolvaPay agent skills: `npx skills add https://solvapay.com` (skills CLI older than 1.5.7: `npx skills add solvapay/skills`).
> - TypeScript SDK setup: `npx solvapay@latest init`. The SDK reads SOLVAPAY_SECRET_KEY and defaults to https://api.solvapay.com.
> - Plans take an options[] array (billingCycle, charge, limit, ...). Retired plan fields price, freeUnits and billingCycle are rejected.
> - Step-by-step from zero to a first paid call: Managed MCP https://docs.solvapay.com/build/managed-mcp.md, TypeScript SDK https://docs.solvapay.com/build/typescript-sdk.md, agent skill https://docs.solvapay.com/build/agent-skill.md.
> - Details: https://docs.solvapay.com/api-reference/authentication.md. OpenAPI spec: https://docs.solvapay.com/api-reference/openapi.json.

# October 23, 2026

> The TypeScript SDK now requires Node.js 22 or later.

## Node.js 22 or later

The TypeScript SDK packages now require Node.js 22 or later. Node 18 and 20 are end of life and
don't get security fixes, including the October 21, 2026 Node.js security release.

* `engines.node` is `>=22` in `@solvapay/server` 2.11.0, `@solvapay/mcp` 0.5.0,
  `@solvapay/mcp-core` 0.5.0, `@solvapay/next` 1.4.0, `@solvapay/auth` 1.2.0, `@solvapay/init`
  0.5.0, `solvapay` 1.4.0 and `create-solvapay` 0.8.0. These are minor releases with no API changes.
* `@solvapay/react` 2.7.1 accepts `@solvapay/mcp-core` 0.5 as its optional peer.
* The SDK is tested on Node 22, 24 and 26.
* On Node 22, the bundled npm installs the MCP template from `npm create solvapay@latest -- --type mcp`.
  You no longer need to upgrade npm first, as you did on Node 20.

On an older Node, npm and pnpm warn about the engine mismatch, and Yarn 1 stops the install.
Upgrade Node rather than ignoring the warning.

See [Installation](https://docs.solvapay.com/sdks/typescript/setup/installation.md) and the
[TypeScript SDK quick start](https://docs.solvapay.com/build/typescript-sdk.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.