# x402 Payment Proxy — full reference

The Soul Network's payment layer: verifies USDC transfers on Base Mainnet on-chain and mints the 1-hour HS256 tickets that open every gated endpoint.

## Payment model

$0.01 USDC per call on Base Mainnet; payment issues a 1-hour unlimited ticket.

## Data & sources

Verifies the USDC Transfer event on Base Mainnet, mints one 1-hour HS256 ticket per transaction (replay-protected), and forwards requests to the origin with the ticket.

## Endpoints

## /__x402/health (GET)

Payment-proxy health check.

Response (JSON):

```json
{
  "ok": true,
  "network": "base-mainnet",
  "chainId": 8453
}
```

## /__x402/config (GET)

Public x402 configuration: network, payTo, and protected route patterns.

Response (JSON):

```json
{
  "network": "base-mainnet",
  "payTo": "0x72b74c7232d2de278aac391cc72d6e51fa0defcb",
  "hasOriginUrl": true
}
```

## Payment instructions

1. Call the endpoint without a ticket to receive a `402 Payment Required`.
2. Pay $0.01 USDC on Base Mainnet (chainId 8453) to `0x72b74c7232d2de278aac391cc72d6e51fa0defcb`.
3. Present the transaction to the proxy at https://x402.thesoulnetwork.eu.
4. Send the returned ticket as `Authorization: Bearer <ticket>` on every call until it expires (1 hour).