diff --git a/images/payments/three-ways-to-get-paid.png b/images/payments/three-ways-to-get-paid.png new file mode 100644 index 0000000..8ffc5d5 Binary files /dev/null and b/images/payments/three-ways-to-get-paid.png differ diff --git a/images/payments/three-ways-to-get-paid.svg b/images/payments/three-ways-to-get-paid.svg new file mode 100644 index 0000000..4458d4d --- /dev/null +++ b/images/payments/three-ways-to-get-paid.svg @@ -0,0 +1,75 @@ + + + + + + + + + + + + + + + + + + + + + + +Catalog +Pay per call, at a price you set live. + +AI agent + +Stablecoin + +x402 · mpp + +1 + + + + + +Embedded Web Flow +Any cart total, checked out on your site. + +A person + +Card + +Stripe · Braintree + +2 + + + + + + +Merchant Plans +One fixed price — credits, time or PAYG. + +AI agent + +Card · stablecoin + +x402 · mpp + +3 + + + + + + + + +YOU GET PAID +Funds land in your account +minus a small Nevermined fee. + \ No newline at end of file diff --git a/products/payments/overview.mdx b/products/payments/overview.mdx index 5ee0580..cefe6f0 100644 --- a/products/payments/overview.mdx +++ b/products/payments/overview.mdx @@ -1,10 +1,43 @@ --- title: "Payments" -description: "Enroll a Visa, Stripe, or Braintree card, set spending limits, and let your agents pay autonomously." +description: "The three Nevermined payment types (Catalog, Embedded Web Flow, Merchant Plans), and the card enrollment and delegation model that lets agents pay with Visa, Stripe, or Braintree." icon: "credit-card" --- -Enroll a Visa, Stripe, or Braintree card. Create a delegation that caps how much can be spent. Your agents charge it directly via x402 — no checkout pages, no human in the loop. +Nevermined has three payment types: three ways money reaches a merchant. Pick the type first, because it decides who the buyer is, what they pay with, and how much you integrate. The rest of this page covers the card mechanics that agent payments run on. + +## Three payment types + +![Three ways to get paid on Nevermined: the Catalog (agents pay per call in stablecoin), the Embedded Web Flow (people pay by card on your site), and Merchant Plans (agents buy credits/time/PAYG) — all settling to the merchant, minus a small Nevermined fee.](/images/payments/three-ways-to-get-paid.png) + + + + AI agents discover your listed service and pay per call in stablecoin over x402 + mpp. You enroll nothing. + + + A person pays any cart total by card through a checkout embedded on your site. No plan, no buyer account, no delegation. + + + AI agents buy credits, time, or pay-as-you-go access to your service at a fixed price, paying by card or stablecoin. + + + +| | Catalog | Embedded Web Flow | Merchant Plans | +|---|---|---|---| +| **Who pays** | An AI agent or harness | A person, in a browser | An AI agent or harness | +| **Pay with** | Stablecoin | Card (fiat) | Card or stablecoin | +| **Pricing** | Dynamic — quoted per request | Dynamic — any cart total | Fixed — set per plan | +| **Merchant enrolls?** | No — Nevermined discovers and lists your service | Yes — you control an Org | Yes — you integrate NVM | + +The full comparison (rails, plans, buyer accounts, who integrates what) is on [Monetize Your AI](/solutions/agent-to-agent-monetization#three-ways-to-get-paid). + +## Card payments for agents + +Everything below is the mechanism behind **card-paid agent payments**, which is how a Merchant Plan gets paid by card. Enroll a Visa, Stripe, or Braintree card. Create a delegation that caps how much can be spent. Your agents charge it directly via x402 — no checkout pages, no human in the loop. + + +**Three payment types and three card networks are different things.** Catalog, Embedded Web Flow, and Merchant Plans are *what you sell and who buys*. Visa, Stripe, and Braintree are *card networks*: the providers an enrolled card and its delegation settle through. Delegations apply to Merchant Plans paid by card. The Embedded Web Flow settles through the same PSPs, but the buyer confirms each charge in the browser, so there is no enrollment and no delegation. Catalog payments are stablecoin and never touch a card. + Manage everything at [nevermined.app](https://nevermined.app). @@ -52,7 +85,7 @@ Agent (no token) |-> POST /settle -> charges card, returns payment-response ``` -## One delegation model, three networks +## One delegation model, three card networks All three providers share the same `nvm:card-delegation` x402 scheme and the same `POST /api/v1/delegation/create` endpoint. The `network` field on the delegation (`stripe`, `braintree`, or `visa`) is set by the card you choose and routes settlement to the right PSP. @@ -155,4 +188,10 @@ You need an [NVM API Key](/agents-guide/get-api-key). Set it as `NVM_API_KEY`. Define spending limits, usage caps, and expiration + + Catalog, Embedded Web Flow, and Merchant Plans side by side + + + The Embedded Web Flow contract, and its current availability + diff --git a/solutions/agent-to-agent-monetization.mdx b/solutions/agent-to-agent-monetization.mdx index 750d088..661cb99 100644 --- a/solutions/agent-to-agent-monetization.mdx +++ b/solutions/agent-to-agent-monetization.mdx @@ -1,21 +1,69 @@ --- title: "Monetize Your AI" -description: "Monetize AI agents using Nevermined’s x402 protocol with stablecoin and fiat payments—no bespoke integrations required." +description: "Three ways to get paid on Nevermined: the Catalog, the Embedded Web Flow, and Merchant Plans. Stablecoin and fiat settlement, no bespoke integrations required." icon: "handshake" --- -Nevermined enables AI builders to protect and monetize their agents using the x402 protocol. With agent-to-agent payments, other agents can subscribe to your agent, purchase access, and request work programmatically—securely settling in stablecoins or fiat. +Nevermined gives you three ways to get paid. Two of them serve **AI agents** that buy over x402 + mpp: the **Catalog**, where agents pay per call for a service Nevermined has already listed, and **Merchant Plans**, where agents buy credits, time, or pay-as-you-go access to your service. The third, the **Embedded Web Flow**, serves **people**: your own end users pay by card for goods and services through a checkout embedded on your site. -## How It Works +## Three ways to get paid + +![Three ways to get paid on Nevermined: the Catalog (agents pay per call in stablecoin), the Embedded Web Flow (people pay by card on your site), and Merchant Plans (agents buy credits/time/PAYG) — all settling to the merchant, minus a small Nevermined fee.](/images/payments/three-ways-to-get-paid.png) + +| | Catalog | Embedded Web Flow | Merchant Plans | +|---|---|---|---| +| **Who pays** | An AI agent or harness (x402 + mpp) | A person, in a browser | An AI agent or harness (x402 + mpp) | +| **Best for** | Listing an AI service and monetizing every call | Selling goods & services to your end users | Subscriptions / credits / metered access to your AI service | +| **Rails / protocol** | x402 + mpp | Embedded PSP checkout — Stripe, Braintree, … | NVM plans over x402 + mpp (fiat or crypto) | +| **Merchant enrolls?** | No — we discover & catalog your service | Yes — you control an Org | Yes — you integrate NVM | +| **Payment plan?** | No | No — a one-off Order | Yes — credits / time / pay-as-you-go | +| **Buyer needs an NVM account?** | Yes — pays from their NVM wallet | No — none required | Yes | +| **Pay with** | Stablecoin | Card (fiat) | Card or stablecoin — most flexible | +| **Pricing** | Dynamic — quoted per request | Dynamic — any cart total | Fixed — set per plan | +| **Who has to integrate** | Neither the merchant · the buyer needs an account + funded wallet | Merchant embeds a checkout · the buyer does nothing | Both sides integrate NVM — most flexible, most setup | + + + + Nevermined discovers and lists your AI service. Agents find it and pay per call in stablecoin. Nothing to enroll. + + + Charge your own end users any cart total by card, through a checkout embedded on your site. No plan, no buyer account. + + + Sell credits, time, or pay-as-you-go access to your AI service. Agents buy the plan and call your endpoints with an access token. + + + + +Not sure which one? If the buyer is an agent and you want zero setup, use the **Catalog**. If the buyer is an agent and you want to set the price and the access model yourself, use **Merchant Plans**. If the buyer is a person on your website, use the **Embedded Web Flow**. + + +## Catalog + +The Catalog is the zero-setup option. Nevermined auto-discovers services that already price each request on the wire (x402 or mpp) and lists them at [nevermined.app/catalog](https://nevermined.app/catalog/). Buyers are agents with a Nevermined account. They pay each call in stablecoin from their NVM wallet through the Nevermined Router, at whatever price your service quotes on that request. You don't register a plan, and the buyer doesn't hold one — they hold a funded wallet. + +Read the [Catalog overview](/products/catalog/overview) for the buyer's view, or [add your AI service](/products/catalog/ai-services#add-your-ai-service) so buyers can find it. + +## Embedded Web Flow + +The Embedded Web Flow is for selling goods and services to your own end users. You control an [organization](/solutions/organizations/overview), you set the price per checkout (any cart total, as a one-off **Order**), and your buyer pays by card through an embedded PSP checkout on your site. The buyer needs no Nevermined account, no plan, and no delegation, and you never touch card data. + +This is the newest of the three. The [Orders guide](/integrate/patterns/orders) documents the contract and tracks its availability in `sandbox` and `live`. + +## Merchant Plans + +Merchant Plans are the traditional Nevermined flow: you sell access to your AI service through a plan (credits, time, or pay-as-you-go) at a fixed price you set. Other agents order your plan, obtain access tokens, and call your endpoints programmatically, settling in stablecoin or fiat. Both sides integrate Nevermined, which makes this the most flexible of the three — and the one with the most setup. + +### How It Works - **Register your Agent & Plan**: Create a payment plan in the [Nevermined App](https://nevermined.app) and link it to your AI agent (endpoints, metadata, pricing). - **Receive Subscriber Requests**: Configure your agent to validate requests from subscribers via Nevermined Payment Libraries (Python/TypeScript). No additional servers or custom gateways needed. - **Agents Pay, Then Use**: Other agents order your plan, obtain access tokens, and call your agent’s endpoints with bearer authentication. - **Secure Settlement**: Payments are processed via stablecoins or fiat (Stripe), with pricing models supporting subscriptions and per-query credits. -## Payment Methods +### Payment Methods -Nevermined supports two payment methods for agent monetization: +Merchant Plans support two payment methods: @@ -27,14 +75,14 @@ Nevermined supports two payment methods for agent monetization: -## Benefits +### Benefits - **Simple setup**: Create a plan, link your agent—done. - **Programmable access**: Agents can buy and use services autonomously. - **Flexible pricing**: Subscriptions, credits, and metered usage. - **Trusted payments**: Stablecoin and fiat support with transparent settlement. -## Implementation Steps +### Implementation Steps 1. **Create a Payment Plan** in the Nevermined App (price, duration, credits). 2. **Register your Agent**: Provide endpoint URLs and capabilities. @@ -47,5 +95,8 @@ Nevermined supports two payment methods for agent monetization: - [Register Agents](/products/nevermined-app/register-agents) in the Nevermined App - [Manage Plans](/products/nevermined-app/manage-plans) for pricing and access - [5-Minute Setup](/integrate/quickstart/5-minute-setup) to get your first paid request working +- [Catalog Overview](/products/catalog/overview) for how agents discover and pay listed services +- [Orders: Goods & Services Checkout](/integrate/patterns/orders) for the Embedded Web Flow contract +- [Payments](/products/payments/overview) for card enrollment and delegations behind card-paid flows - Blog: [Making x402 Programmable](https://nevermined.ai/blog/making-x402-programmable) - Blog: [Agentic Payments with x402, A2A & AP2](https://nevermined.ai/blog/building-agentic-payments-with-nevermined-x402-a2a-and-ap2)