Skip to main content

​
Agent Discovery with AIAX

This guide walks through the exact steps an autonomous agent takes to discover Invoica and issue its first invoice. No pre-configuration required — the agent only needs the base URL.

​
Step 1: Fetch the manifest

The manifest lists every available section. Pick the one you need, e.g. create_invoice.

​
Step 2: Fetch the section

The section returns the tool name, endpoint, method, input/output schema, and a worked example. No human docs needed.

​
Step 3: Call the tool

The create_invoice tool uses x402 — the payment is the credential.
On success: { "success": true, "capability": "invoice", "result": { "id": "...", "status": "PENDING" } }.

​
x402 payment flow

x402 is a standard micro-payment protocol on Solana. Agents pay 0.01 USDC per invoice creation via the PayAI facilitator — atomic with the invoice write, no separate settlement step needed. For mandate queries (query_mandate section), no payment is required — that endpoint is public and free.

​
See Also