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

# SolvaPay in ChatGPT

> How SolvaPay checkout, account pages and MCP UIs work when your MCP server runs in ChatGPT, including inline payment in the chat.

ChatGPT renders MCP UIs inside the chat and allows the card form inside them. Customers can pay without leaving the conversation. Account pages open as SolvaPay-hosted pages in the system browser.

## What works

* Text and links: supported.
* MCP UIs: rendered inline in the chat.
* Payment form: inline in the chat.
* Account pages: hosted page, in the system browser.

## Checkout

When a paid tool is blocked, the SolvaPay `account` tool can show checkout or top-up inline. The customer enters card details in the chat and returns to the conversation when the payment is confirmed. The response text also carries a hosted checkout link, so the customer can pay outside the chat if they prefer.

## Account pages

Plan, usage and billing history live on SolvaPay-hosted pages. ChatGPT opens them in the system browser.

## MCP UIs

ChatGPT supports MCP Apps, so the SolvaPay `account` tool renders its plan, checkout and top-up views inline. See the [MCP App integration guide](https://docs.solvapay.com/sdks/typescript/guides/mcp-app.md) to build or customize them.

## Connect your MCP server

1. In ChatGPT, open **Settings** > **Security and login** and turn on **Developer mode**.
2. Go to **Plugins** and select **+**.
3. Enter a name and your MCP server URL, including the `/mcp` path, and create the connection.
4. In a conversation, choose **Developer mode** from the **+** menu and select your app.

Business and Enterprise workspaces need an admin to enable developer mode first. See OpenAI's [developer mode guide](https://developers.openai.com/api/docs/guides/developer-mode).

## Demo videos

| Use case | Recording |
| - | - |
| Inline payment form (top up) | [Watch](https://screen.studio/share/oGU00U9e) |

## Known limitations

* Developer mode is required for custom MCP servers until your app is published.
* Hosted checkout links expire after 15 minutes. Ask the assistant for a new link if one has expired.

Last tested: 2026-09-30


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