Skip to main content

​
x402 payments reference

Reference for the sequencer endpoints that handle x402 payment intents.

​
Properties

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

​
Examples

​
Submit an intent

curl -X POST https://api.sequencer.stateset.app/api/v1/x402/payments \
  -H "Content-Type: application/json" \
  -d '{
    "tenant_id": "uuid",
    "store_id": "uuid",
    "agent_id": "uuid",
    "payer_address": "0x...",
    "payee_address": "0x...",
    "amount": 1000000,
    "asset": "usdc",
    "network": "set_chain",
    "valid_until": 1705320000,
    "nonce": 42,
    "signing_hash": "0x...",
    "payer_signature": "0x..."
  }'

​
Response

​
intent_id
string
required
The ID of the sequenced payment intent.
​
status
string
Current intent status (e.g., sequenced).