I'm a User Agent — Integrating Nexus Payments

This guide is for user-side AI Agent developers. Nexus supports HTTP REST, MCP, and CLI interaction modes — we recommend integrating via HTTP by referencing Skill files.

User Agent integration has two parts:

1. Reference Market Skill — Gain merchant discovery capabilities
2. Reference the merchant's User Skill — Gain ordering and payment capabilities

---

Part 1: Market Skill — Discover Merchants

Reference skill-market.md to let your Agent search and discover merchants.

HTTP (recommended)

GET /api/agents?query=flight&category=travel

Results include each merchant's skill_user_url (HTTP skill) and skill_md_url (MCP skill). See skill-market.md for full search parameters, response format, and examples.

MCP

Reference skill.md, which includes discover_agents and get_agent_skill discovery tools.

---

Part 2: User Skill — Order & Pay

After discovering merchants via Market Skill, fetch their Skill file. The merchant's response includes skill_user_url — by referencing it, your Agent gains:

• Search & quote — Call the merchant's search/quote endpoints to get signed quotes
• Payment orchestration — Submit quotes to Nexus Core, get a checkout URL for user payment
• Status tracking — Query payment progress (CREATED → ESCROWED → SETTLED → COMPLETED)
• Dispute handling — Open on-chain disputes when users are unsatisfied

The specific endpoints and parameters are defined in each merchant's Skill file — your Agent parses and follows them directly. For generic payment endpoints, see skill-user.md.