Payment sandbox

Run the end-to-end example

Download the Node.js example, then run it with Node.js 22 or later.

node mock-payment.mjs https://pay.axiv.cc

The browser sandbox makes the same requests. Amounts use six-decimal atomic-unit strings. At the simulated 1:1 exchange rate and 50 bps fee, 10 USDC returns 9.95 USDG on the example route.

Sandbox API

• GET /mock/v1/capabilities returns routes, funding modes, and the state model.
• POST /mock/v1/quotes returns a simulated quote that expires after five minutes.
• POST /mock/v1/payments creates a payment from the quote. Reuse the same Idempotency-Key on retries.
• GET /mock/v1/payments/{id} returns payment, guarantee, payout, and settlement status.
• GET /mock/v1/payments/{id}/events returns ordered state transitions.
• POST /mock/v1/payments/{id}/simulate advances one step when expectedStatus matches the current state.

Payment lifecycle

AWAITING_DEPOSIT → DEPOSIT_OBSERVED → GUARANTEED → PAYOUT_PENDING → PAID → SETTLED

Every response is marked simulation: true. Use only sample order data. Guarantees, transfers, and settlement in the sandbox have no financial effect.

Connect an agent

Use the public discovery catalog and the read-only MCP server at /public/mcp to find capabilities. Then use the OpenAPI contract to exercise the payment paths above.