> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# x402 payments reference

> Complete reference for sequencer x402 payment endpoints.

# x402 payments reference

Reference for the sequencer endpoints that handle x402 payment intents.

## Properties

<ParamField body="tenant_id" type="string" required>
  Tenant UUID that owns the payment intent.
</ParamField>

<ParamField body="store_id" type="string" required>
  Store UUID used for sequencing and batching.
</ParamField>

<ParamField body="agent_id" type="string" required>
  Agent UUID that signed the payment intent.
</ParamField>

<ParamField body="payer_address" type="string" required>
  Payer address for the intent.
</ParamField>

<ParamField body="payee_address" type="string" required>
  Payee address for the intent.
</ParamField>

<ParamField body="amount" type="number" required>
  Amount in smallest units (e.g., 1,000,000 = 1 USDC).
</ParamField>

## Examples

### Submit an intent

```bash theme={null}
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

<ResponseField name="intent_id" type="string" required>
  The ID of the sequenced payment intent.
</ResponseField>

<ResponseField name="status" type="string">
  Current intent status (e.g., `sequenced`).
</ResponseField>

## Related references

* [x402 Payments with iCommerce](/stateset-icommerce-x402-payments)
* [Set L2 Verification](/stateset-set-l2-verification)
