> ## 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.

# November 15, 2026

> Agent payments preview support on the platform, and checks that keep merchant accounts able to take payments.

## Agent payments (preview)

The platform side of [agent payments](https://docs.solvapay.com/sdks/typescript/guides/agents.md) is now in production, as a preview. SolvaPay turns it on per merchant account; until then, your server's agent calls are refused with `feature_not_enabled`. Live agent payments aren't open yet: agents pay in sandbox with test money, and nothing real is charged.

## Merchant accounts

* **Your website has to be one Stripe accepts.** Sign-up and **Settings** > **Business** now refuse test, example and local addresses such as `testcompany.com`, `example.com` or `localhost`, and say why. Stripe refuses those sites, and an account with one can't take payments.

## Customer sign-in

* **`GET /v1/customer/auth/userinfo` answers a token it doesn't accept with `401 invalid_token`.** It used to answer `400`. The SDKs' MCP servers depend on this to send the host back to sign-in.
* **Switching between sandbox and live no longer signs your customers out.** A customer's MCP token is refused while you're in the other environment, and works again when you switch back.


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