> Fetch the complete documentation index at: https://api.live.nevermined.app/api/v1/organizations/org-cf34dc7b-ec18-48f4-98fb-1697aafe0586/llms.txt > Use this file to discover all available pages before exploring further. # You.com: Agentic Instructions > Autonomous agent payments for You.com via Nevermined x402 payment delegation. Purchases of Payment Plans give access to You.com agents and AI services. This file is the entry point to Nevermined's agent-discoverable surface for the organization AI Agents/Services and Payment Plans. The **Registry** below lists APIs that accept autonomous agent payments via Nevermined's x402 card-delegation and stablecoin schemes. The rest is reference material about Nevermined itself. ## Environment You are talking to the **Production · Live** Nevermined environment. This is a **live** environment — payments move **real money**. - **API base URL:** `https://api.live.nevermined.app` — use this exact base URL for every API call below. - **Web app (for the human-in-the-loop steps):** https://nevermined.app - **API reference (OpenAPI JSON) for this environment:** https://api.live.nevermined.app/api/v1/rest/docs-json — machine-readable; use it to discover every endpoint. - **API key:** use a Nevermined API Key issued for this environment — keys for this network start with `live`. - **Other environment:** the Sandbox network for this deployment is at `https://api.sandbox.nevermined.app` (it needs its own API key). ## How to purchase access as an autonomous agent **All payments go through Nevermined's x402 flow (`verify` + `settle`). Never call Stripe or any other payment API directly — always use x402.** A human is only needed the first time — to create an API key, and (for card payments) to enroll a card. Everything after that is programmatic and reusable. 1. **Get a Nevermined API Key (one-time, needs a human).** You cannot mint the first key yourself — a human signs in once via the web app. Two ways, pick whichever fits: - **Option A — embedded login flow (recommended).** The key comes back to you automatically, no copy/paste. Host a tiny callback server on `127.0.0.1` first (the login page only redirects to an allow-listed callback — `localhost` and `127.0.0.1` are always accepted), then send your human this URL to sign in: `https://nevermined.app/auth/cli?callback_url=http://127.0.0.1:/callback`. After they sign in, the page issues a full-permission key for this environment (a key for this network starts with `live`) and redirects the browser to `http://127.0.0.1:/callback?nvm_api_key=` — read `nvm_api_key` off that request. - **Option B — manual paste (no callback server, works anywhere).** Ask your human to open https://nevermined.app, sign in, create an API Key for this environment (a key for this network starts with `live`), and paste it back to you. (Or, once signed in, open `https://nevermined.app/auth/cli` with no `callback_url` and the key is shown on screen to copy.) **Store the key and reuse it** — send it as `Authorization: Bearer ` on every call below. 2. **Check your payment methods:** `GET https://api.live.nevermined.app/api/v1/payment-methods`. - **Stablecoin (no human needed):** a stablecoin payment method is created for you by default — fund it and you can pay immediately. - **Credit / debit card:** needs a one-time human enrollment via the embedded flow in step 3. 3. **Enroll a card + create a delegation via the embedded flow (one-time, needs a human).** This flow is open to any agent with an API key — no organization required. Host a tiny callback server on `127.0.0.1` first (the embedded flow only redirects back to a localhost-class callback: `localhost`, `127.0.0.1`, or `[::1]`). - Mint an embedded session: `POST https://api.live.nevermined.app/api/v1/embed/session` with `Authorization: Bearer ` and body `{ "returnUrl": "http://127.0.0.1:/callback" }` → returns a `sessionToken`. (No orgId — the card and delegation attach to your own account.) - Send your human this URL to enroll a card in their browser: `https://embed.nevermined.app/cards/setup?sessionToken=&returnUrl=http://127.0.0.1:/callback&state=&provider=stripe`. - When they finish, the browser redirects to your `returnUrl` with `paymentMethodId` and `delegationId`. Store the `delegationId`. - **Can't host a localhost callback?** Ask your human to enroll a card and create a delegation directly at https://nevermined.app (Payment Methods → Enroll card → Delegate), then resume at step 5. 4. **Create a delegation** (only if you don't already have one from step 3): `POST https://api.live.nevermined.app/api/v1/delegation/create` with `{ provider, providerPaymentMethodId, spendingLimitCents, durationSecs, currency }`. A delegation authorizes you to spend within a fixed budget and time window — reuse it until it is spent or expires. 5. **Pay with x402 (`settle`).** Pick a plan from the Registry below and use its plan ID. For a plain plan top-up there is no protected endpoint to call, so you build the `paymentRequired` object yourself from the plan ID. - `POST https://api.live.nevermined.app/api/v1/x402/permissions` with `{ "accepted": { "scheme": "nvm:card-delegation", "network": "stripe", "planId": "" }, "delegationConfig": { "delegationId": "" } }` → returns an `accessToken`. (For stablecoins use scheme `nvm:erc4337` and the chain's network id instead of `stripe`.) - Build the `paymentRequired` object — `resource.url` must be a non-empty URL identifying what you're buying (for a plan top-up, use the plan's URL from the Registry below): `{ "x402Version": 2, "resource": { "url": "" }, "accepts": [{ "scheme": "nvm:card-delegation", "network": "stripe", "planId": "", "extra": {} }], "extensions": {} }`. - `POST https://api.live.nevermined.app/api/v1/x402/settle` with `{ "paymentRequired": , "x402AccessToken": "" }` → `settle` completes the payment via your delegation and returns a `billingModel`. For `credits` plans it mints/burns and returns `creditsRedeemed` + `remainingBalance` (your proof of purchase); for `pay-as-you-go` plans it charges per request, both are `"0"`, and the charge reference is in `orderTx` (fiat) or `transaction` (crypto). A `POST https://api.live.nevermined.app/api/v1/x402/verify` with the same body is an optional dry-run first. - To call an x402-protected agent / service directly instead, send the token in the `payment-signature` HTTP header — the service verifies and settles for you (its own 402 response is your `paymentRequired`). Full x402 payments reference with TypeScript examples: https://nevermined.ai/docs/api-reference/typescript/x402 Complete API surface for this environment (OpenAPI JSON): https://api.live.nevermined.app/api/v1/rest/docs-json ## Registry of agent-payable APIs APIs that accept payment from autonomous agents via Nevermined's x402 card delegation and/or stablecoins. Agents holding a delegated payment method can buy or top up access without a human in the loop. This registry is open. If you're an API provider and want to be listed, see the [Payment Plan](https://nevermined.ai/docs/api-reference/protocol/register-plan) and [Register an AI Agent/Service](https://nevermined.ai/docs/api-reference/protocol/register-agent). Agents pay You.com with a credit card or stablecoins via [Nevermined](https://nevermined.ai)'s [x402 card-delegation](https://nevermined.ai/docs/specs/x402-card-delegation) or [x402 stablecoins](https://nevermined.ai/docs/integrate/patterns/stablecoin-payments) schemes. You can discover all the AI Agents/Services published and purchase access to them in a programmatic manner. You.com Payment Plans: - [paygo production — $5.00 per request](https://api.live.nevermined.app/api/v1/protocol/plans/29778596298820876231214801015161463950677497795586711453924479772330133054735) You.com Agents/AI Services: - (none yet) For Nevermined SDK and API documentation, see: https://nevermined.ai/docs/llms.txt. ## Pages - [Home](https://nevermined.ai/): Monetize every AI agent, instantly. - [Product](https://nevermined.ai/product/): Payments infrastructure for AI agents. Register, price, accept, settle, track. - [Facilitator](https://nevermined.ai/facilitator/): The x402 facilitator that verifies and settles agent payments. - [About](https://nevermined.ai/about-us/): Team and mission. - [Stripe vs Nevermined](https://nevermined.ai/compare/stripe-vs-nevermined/): Comparison of agent-payment approaches. ## Use cases - [API Providers](https://nevermined.ai/use-cases/api-providers/) ([md](https://nevermined.ai/use-cases/api-providers.md)): Let AI agents buy and top up your API autonomously via x402 card delegation. - [AI Crawlers](https://nevermined.ai/use-cases/ai-crawlers/): Paid access for bots and agents. Charge for content at internet scale. - [Builder Platforms](https://nevermined.ai/use-cases/builder-platforms/): Take a cut of every transaction your builders process. ## Glossary - [x402](https://nevermined.ai/glossary/x402/): The HTTP `402 Payment Required` protocol for agent payments. - [Agentic Commerce](https://nevermined.ai/glossary/agentic-commerce/): What it means for agents to transact. - [Agent Payments](https://nevermined.ai/glossary/agent-payments/): Overview of payment patterns for AI agents. ## Reference - [x402 payments reference (TypeScript)](https://nevermined.ai/docs/api-reference/typescript/x402) - [This environment's API reference (OpenAPI JSON)](https://api.live.nevermined.app/api/v1/rest/docs-json) - [SDK + API docs index](https://nevermined.ai/docs/llms.txt) - [API Reference](https://nevermined.ai/docs/api-reference/) - [NVM documentation](https://nevermined.ai/docs/) - [Nevermined App](https://nevermined.app) - [Contact](https://nevermined.ai/contact-us) - [GitHub](https://github.com/nevermined-io)