> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jojapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sell to AI agents (agent payments)

> Price endpoints for pay-per-request agent access, let agents buy your existing plans with a wallet, and see agents as customers in Studio.

AI agents can buy access to your API without an account: they pay with a wallet over **x402** or **MPP** and the gateway does the rest. Nothing about your API, targets or plans changes — agents are one more kind of customer.

## What agents can buy

* **Your existing plans.** Every public, USD-priced plan is purchasable by agents. An agent pays the plan price, receives a freshly issued API key bound to that subscription, and uses it like any consumer. Periods are **prepaid**: when a period ends the agent is offered a renewal; nothing renews automatically. Plans are sold to agents by default — publishing plans is the consent.
* **Pay per request.** Optionally, price individual endpoints for keyless calls. The price is a fixed USD amount per successful request that you set on each endpoint. Requests answered with an upstream `5xx` are not charged.
* **Pay-as-you-go.** Agents can fund a balance with a wallet payment and subscribe to your pay-as-you-go plans; metering, tiers and formulas apply unchanged.

## Enable pay-per-request

1. Open the API in Studio → **Details → Settings → Agent payments** and turn the switch on. This is the master switch; it does nothing until at least one endpoint carries a price.
2. Price endpoints: on an endpoint's **Details** page set **Agent price** (USD per request), or select several endpoints on the **Endpoints** page and use **Set agent price**. Endpoints without a price are not sold per request (agents still reach them with a key from a plan).
3. Prices are live immediately. The platform enforces a minimum and maximum per request (shown next to the field); prices are in USD and settled in USDC.

Per-request prices are independent of billable objects and usage formulas: the agent pays the fixed price, your usage counters still record the call.

## Where agents show up

* **Subscriptions** and **Transactions** list agents like any customer, with an **Agent** badge and a short wallet identity instead of an email. Filter by *Agents* to see only them.
* **Payouts**: plan purchases are ordinary paid subscriptions (periodic revenue); per-request and pay-as-you-go charges accrue like pay-as-you-go usage. The marketplace commission is the same as for every other sale.
* **Analytics**: per-key analytics work per agent purchase, because every purchase has its own key.

## Discovery

Agent-payable APIs are listed on `https://agents.jojapi.com` and each API host publishes `/.well-known/x402` and an annotated `/openapi.json`, which x402 directories index. Priced endpoints are also announced to the payment facilitator's discovery layer on first settlement.

## Reserved paths

`/openapi.json`, `/.well-known/…` and `/_jojapi/…` on your API host belong to the gateway: they serve the annotated OpenAPI document, the x402 discovery document and the agent commerce routes, without authentication. Endpoints cannot be documented on these paths, and an endpoint that already sits there is never reached by requests.

## Policies

* Per-request prices are charged on `2xx` and `4xx` upstream answers, never on `5xx`.
* An agent may hold several plans of the same API at once (each with its own key); the human "one subscription per API" rule does not apply to agents.
* Wallet payments are final. Goodwill refunds are handled by the marketplace as balance credits.