docs(services): add Agent Payments page

docs.json

@@ -53,7 +53,8 @@
                   "services/crawl",
                   "services/monitor",
                   "services/schema",
-                  "services/history"
+                  "services/history",
+                  "services/agent-payments"
                 ]
               },
               {

services/agent-payments.mdx

@@ -0,0 +1,163 @@
+---
+title: 'Agent Payments'
+description: 'Let AI agents buy API access with a crypto wallet, no signup or human required'
+icon: 'robot'
+---
+
+## Overview
+
+Agent Payments lets an AI agent with a crypto wallet and **no account** buy access to
+ScrapeGraphAI on its own. The agent pays an [MPP](https://mpp.dev) payment challenge and
+receives a real API key plus credits, the same key any customer uses. Payment replaces
+signup.
+
+Unlike single-use prepaid tokens, a payment mints a **durable, refillable account**: a user,
+a workspace, and an API key with a credit balance that persists across purchases.
+
+<Note>
+Agent Payments is designed for autonomous agents that hold a wallet and have been authorized
+to spend. Human developers should [sign up](https://scrapegraphai.com/dashboard) for an API
+key the normal way.
+</Note>
+
+## How it works
+
+1. The agent calls a product endpoint (e.g. `POST /api/scrape`) with no key and gets a `401`
+   whose error body points at the agent-access endpoints.
+2. `POST /api/agent/mpp/access/{pack}` with no credentials returns a `402` with a
+   `WWW-Authenticate: Payment` challenge (MPP).
+3. The agent's wallet pays the challenge, then retries the request with
+   `Authorization: Payment <credential>`. If the wallet requires approval, the owner
+   approves the payment in their wallet app.
+4. The response contains an **API key and credits**. The agent sends the key as
+   `SGAI-APIKEY` on every request thereafter. The key is returned once, so store it.
+
+## Payment method
+
+Payments settle over [InFlow](https://inflowpay.ai), a wallet and payment service for AI
+agents. The `402` challenge advertises it in the `WWW-Authenticate: Payment` header; pay it
+with the InFlow CLI or SDK.
+
+- **Currency:** USDC
+- **Method:** `inflow` (balance rail, via InFlow)
+
+## Set up an InFlow wallet
+
+To pay, an agent needs an InFlow account, the CLI (or SDK), and a funded wallet.
+
+<Steps>
+  <Step title="Create an InFlow account">
+    Sign up at [inflowpay.ai](https://inflowpay.ai). This is the account your agent pays
+    from.
+  </Step>
+  <Step title="Install and authenticate">
+    Install the CLI from [inflowcli.ai](https://inflowcli.ai), then log in to your account:
+
+    ```bash
+    inflow auth login
+    ```
+  </Step>
+  <Step title="Fund the wallet">
+    Add USDC to your InFlow account and confirm it's available:
+
+    ```bash
+    inflow balances list
+    ```
+  </Step>
+  <Step title="Let the agent pay">
+    Give your agent the InFlow CLI (or [MCP server](https://inflowpay.ai)) and its
+    [agentic-payments skill](https://mpp.dev). The agent handles the payment on its own:
+    it hits an `/api/agent/mpp/access/{pack}` endpoint, reads the `402` challenge, pays, and
+    retries with the credential. You only approve the spend if your wallet policy requires
+    it. The commands below show what that exchange looks like under the hood.
+  </Step>
+</Steps>
+
+<Frame caption="An MPP payment request awaiting approval in the InFlow app">
+  <img src="/images/agent-payments/inflow-approval.png" alt="InFlow MPP payment approval for 5 USDC" />
+</Frame>
+
+<Note>
+InFlow is one MPP-compatible wallet. Any wallet or agent runtime that speaks MPP and holds
+USDC can pay the `inflow` challenge. See [mpp.dev](https://mpp.dev) for the protocol.
+</Note>
+
+## Credit packs
+
+| Pack | Price (USDC) | Credits |
+|------|--------------|---------|
+| `small` | 5 | 1,000 |
+| `medium` | 40 | 10,000 |
+| `large` | 150 | 50,000 |
+
+Credits meter product usage the same way a normal account's do. A minted account starts on
+the free plan (10 requests/min, 1 concurrent crawl, 1 monitor).
+
+## Endpoints
+
+| Method | Endpoint | Auth | Purpose |
+|--------|----------|------|---------|
+| `GET` | `/api/agent/protocols` | none | Discover packs, method, and endpoints |
+| `POST` | `/api/agent/mpp/access/{pack}` | none | Pay → mint account, API key, and credits |
+| `POST` | `/api/credits/purchase/{pack}` | `SGAI-APIKEY` | Refill credits on your account |
+| `GET` | `/api/credits` | `SGAI-APIKEY` | Check remaining balance |
+
+## Getting Started
+
+### 1. Discover
+
+Free and unauthenticated. Start here to learn the packs, method, and endpoints.
+
+```bash cURL
+curl https://v2-api.scrapegraphai.com/api/agent/protocols
+```
+
+### 2. Pay and mint
+
+```bash InFlow
+inflow mpp pay \
+  https://v2-api.scrapegraphai.com/api/agent/mpp/access/small \
+  --method POST
+# → { "apiKey": "sgai-…", "pack": "small", "credits": 1000,
+#     "remaining": 1000, "account": "created" }
+```
+
+### 3. Use the key
+
+```bash cURL
+curl -X POST https://v2-api.scrapegraphai.com/api/scrape \
+  -H "SGAI-APIKEY: sgai-…" \
+  -H "content-type: application/json" \
+  -d '{"url": "https://example.com"}'
+```
+
+## Refilling
+
+When credits run low, pay the keyed purchase route **with your API key** to top up the same
+account. Keep your key because it is the only way to refill.
+
+```bash cURL
+inflow mpp pay \
+  https://v2-api.scrapegraphai.com/api/credits/purchase/small \
+  --method POST \
+  --header "SGAI-APIKEY: sgai-…"
+# → { "pack": "small", "credits": 1000, "remaining": 2000 }
+```
+
+If you lose the key, pay `POST /api/agent/mpp/access/{pack}` again. Every new payment mints a
+fresh account.
+
+## Terms
+
+- **Minimum purchase:** the `small` pack (5 USDC).
+- **Idempotency:** replaying the same payment credential re-delivers the same result. You are
+  never charged or credited twice for one payment.
+- **Refunds:** payments are handled out-of-band. If a payment settles but access is not
+  granted (a transient error), retry with the same credential. The flow is idempotent and
+  self-heals. For anything unrecoverable, contact [support](mailto:support@scrapegraphai.com)
+  with your payment reference (returned in the `Payment-Receipt` header).
+
+## Reference
+
+- OpenAPI: `https://v2-api.scrapegraphai.com/api/openapi.json`
+- Machine-readable guide for agents: `GET /api/agent/protocols`