Skip to main content

​
x402 payments reference

Reference for the sequencer endpoints that handle x402 payment intents.

​
Properties

​
string
required
Tenant UUID that owns the payment intent.
​
string
required
Store UUID used for sequencing and batching.
​
string
required
Agent UUID that signed the payment intent.
​
string
required
Payer address for the intent.
​
string
required
Payee address for the intent.
​
number
required
Amount in smallest units (e.g., 1,000,000 = 1 USDC).

​
Examples

​
Submit an intent

​
Response

​
string
required
The ID of the sequenced payment intent.
​
string
Current intent status (e.g., sequenced).
signing_hash is not free-form — it must be SHA-256 over the exact domain-separated preimage (X402_PAYMENT_V1, field order fixed, integers big-endian), signed with Ed25519. Build it from the walkthrough; an intent whose hash was computed any other way is rejected.

​
Nonces

Each nonce is reserved per payer on first use. A resubmitted intent fails with Nonce already used for this payer — that is replay protection working, not an error to retry through. Sign a fresh intent with a new nonce instead.