Elsa x402 Facilitator

Facilitator URL

https://facilitator.heyelsa.build

Endpoints

POST /verify Verify payment authorization

POST /settle Execute payment on-chain

GET /supported List supported networks

Verify a Payment

Verify a payment authorization before executing it on-chain.

Request

# Verify payment authorization
curl -X POST verify \
  -H "Content-Type: application/json" \
  -d '{
    "x402Version": 1,
    "paymentPayload": {...},
    "paymentRequirements": {...}
  }'

200 OK - Valid

{
  "scheme": "exact",
  "network": "base",
  "isValid": true,
  "payer": "0x..."
}

200 OK - Invalid

{
  "scheme": "exact",
  "network": "base",
  "isValid": false,
  "invalidReason": "invalid_authorization_signature"
}

400 Bad Request

invalid character 'x' looking for beginning of value

500 Internal Server Error

internal server error

Settle a Payment

Execute a verified payment authorization on-chain.

Request

# Execute payment on-chain
curl -X POST settle \
  -H "Content-Type: application/json" \
  -d '{
    "x402Version": 1,
    "paymentPayload": {...},
    "paymentRequirements": {...}
  }'

200 OK - Success

{
  "scheme": "exact",
  "network": "base",
  "success": true,
  "transaction": "0x..."
}

200 OK - Failed

{
  "scheme": "exact",
  "network": "base",
  "success": false,
  "errorReason": "invalid_authorization_signature"
}

400 Bad Request

invalid character 'x' looking for beginning of value

500 Internal Server Error

internal server error

Supported Networks

Get a list of supported x402 versions, schemes, and networks.

Request

# List supported networks
curl -X GET supported

200 OK

{
  "kinds": [
    {
      "x402Version": 1,
      "scheme": "exact",
      "network": "base-sepolia"
    },
    {
      "x402Version": 1,
      "scheme": "exact",
      "network": "base"
    },
    {
      "x402Version": 2,
      "scheme": "exact",
      "network": "eip155:84532"
    },
    {
      "x402Version": 2,
      "scheme": "exact",
      "network": "eip155:8453"
    }
  ]
}