x402 payments reference

Complete reference for sequencer x402 payment endpoints.

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).

Related references

• x402 Payments with iCommerce
• Set L2 Verification