# AgentFix Pay-Ready Documentation

> Discovery layer for AI shopping agents: what we sell, how to buy programmatically, and how to test without charging cards.

Machine-readable schema: [/.well-known/agent-checkout.json](/.well-known/agent-checkout.json)

Human pricing page: [/pricing](/pricing)

## What we sell

Two products, both around AI-agent readiness of your website. The scanner itself is always free (no signup, no email).

- **Agent-Ready Pack Basic - $29 (one-time).** Personalized fix pack for one domain. Includes a WordPress plugin, ZIP delivery, `llms.txt` + `llms-full.txt` generated from your content, updated `robots.txt`, schema.org JSON-LD, `.well-known/*` agent-discovery files, runtime auto-fix script and localized install docs. Free re-scans forever; manual re-installs when new checks ship.
- **Agent-Ready Pack Pro - $99 (3 months active) then $9/month.** Everything in Basic plus monthly auto-rebuild against the current scanner version, live plugin config-refresh, version history, Pro badge on your Agent-Ready certificate, priority email support (24h SLA). Cancel any time; nothing on your site is ever modified.

## How to purchase programmatically

The checkout flow is scan-first: every purchase is bound to a scan of the target domain, so the delivered pack matches that site.

1. `POST /api/scan` with `{ "url": "https://example.com" }`. Response contains `scan_id` and `status`. Poll `GET /api/scans/{scan_id}` until `status: "done"`.
2. `POST /api/checkout` with `{ "scan_id": "<from step 1>", "email": "buyer@example.com" }`. Response: `{ "checkout_url": "...", "providers": { "gumroad": "...", "fastspring": "..." } }`.
3. Direct the buyer to `checkout_url`. The active provider is chosen server-side (currently FastSpring primary, Gumroad fallback; Creem is being wired next). All are card-only, 3D-Secure supported, no crypto rails yet.
4. On successful payment the provider webhook fulfills the order server-side. Poll `GET /api/orders/by-scan?scan_id=<id>` until `status: "delivered"`.
5. On `delivered`: the response includes a signed download URL for the pack ZIP (Cloudflare R2, 7-day TTL) and an install-key for the WordPress plugin.

## Test mode

Test the flow end-to-end without charging real cards.

- Every provider we use has a sandbox. FastSpring sandbox lives at `{store}.test.onfastspring.com`; Gumroad supports test purchases with the same product URL when you are logged into a seller account. The server picks sandbox when `PAYMENT_PROVIDER_MODE=test` is set on the backend.
- For agent smoke tests, start with `POST /api/scan` for a URL you control. Skip the checkout step and just confirm that `POST /api/checkout` returns a valid 200 with `checkout_url`. Do not invoke provider checkouts for automated CI unless you own a sandbox account.

## Payment providers

- **FastSpring** (primary, EU/US, VAT and sales-tax compliant, PCI-DSS handled).
- **Gumroad** (fallback for indie flows).
- **Creem** (being wired next, EU-based, will become primary once fully live).
- Card networks: Visa, MasterCard, American Express, JCB. Apple Pay and Google Pay via provider.
- No crypto rails yet. If you need x402 or L402, ping us at support@agentfix.pro.

## Refunds and cancellations

- 7-day money-back on both packs, no questions. Email support@agentfix.pro with your `order_id`.
- Pro subscription can be cancelled from the `/pack/[id]/manage` dashboard at any time. Your installed pack stays untouched.

## For humans

- Full pricing comparison and FAQ: [/pricing](/pricing)
- Delivery roadmap (WordPress live, ZIP available, Shopify / Webflow WIP, Tilda planned): [/roadmap](/roadmap)
- How the scanner grades your site: [/methodology](/methodology)

## Contact

- Sales, refunds, integration questions: support@agentfix.pro
- Public repo: https://github.com/Virt92/agentfix-oss-scanner