Glossary
The vocabulary of agent commerce on ROJI, one line each. Every term links to where it is used, so an agent reading this page can go straight to the next document it needs.
- Agent
- Software that acts for a person or organization: it searches the catalogue, places orders, answers questions, and collects deliverables over MCP or the API. Every agent token is bound to a principal.
- Principal
- The accountable human or organization an agent acts for. The principal owns the ROJI account, approves the agent's access on the consent screen, and answers for every order it places. See auth.md.
- Business
- A verified merchant that publishes listings and fulfils orders — KYB-verified through Stripe Connect and, for licensed work, credential-verified against the issuing jurisdiction. See verification.
- Listing
- One purchasable service: a structured input schema, a deliverable schema, a price, a turnaround (SLA), and a refund window. Browse them in the directory.
- Order
- A paid request against one listing. It moves
placed → accepted → in_progress ↔ needs_input → delivered → completed;rejectedandcancelledrefund in full. See the order lifecycle. - Fee preview
- The itemized, machine-readable quote an agent reads before ordering: the listing price, the platform fee, and the total the buying side is charged. Nothing is charged until an order is placed.
- Platform fee
- ROJI's percentage on top of the listing price, paid by the buying side. The business keeps 100% of its list price. See pricing.
- Spend policy
- The per-order and rolling spend ceilings enforced platform-side for an account, plus the threshold above which a human must approve. No scope lets an agent raise its own ceiling.
- Deliverable
- The typed result of an order — a structured field on the order that matches the listing's deliverable schema, plus any attached files. Only the two parties to the order can read it.
- needs_input
- The order state in which the business has asked the agent a blocking question. The SLA clock is stopped; only the agent's answer restarts it.
- Refund window
- The period after delivery during which a buyer can open a refund request; the business has 72 hours to answer or it auto-approves. A missed SLA refunds automatically and in full regardless.
- x402
- The HTTP 402 payment protocol: an agent-native rail on which the first order call returns a payment challenge instead of an order, and the retry with the payment proof creates it. Enabled per account; card and ACH through Stripe are the default rails.
- MCP
- The Model Context Protocol — the standard by which an AI assistant connects to tools. ROJI's product is an MCP server at
mcp.roji.ai; see the MCP integration guide and the agent skill manual. - Setup code
- A single-use, short-lived code an account owner mints in the console and hands to an agent, which exchanges it once for an ordinary account credential — the zero-friction onboarding path for agents that cannot complete a browser OAuth flow.