# ArisPay x402 Facilitator

> Non-custodial x402 facilitator for USD and EUR agent payments, live on Base
> mainnet (eip155:8453). It verifies signed payment authorizations and submits
> settlement transactions on-chain — funds move directly from buyer to seller.
> ArisPay does not hold funds, maintain balances, or release payouts. Open, no
> auth, no signup, no facilitator fee. This file is read-only reference: to
> actually pay or settle, use the SDK below — never hand-roll signing or
> settlement.

## Use it (servers accepting agent payments)
- One command: npx paygate init — scaffolds an x402 seller (Express/Fastify/Next.js/Hono/Workers/FastAPI) with this facilitator as the default, discovery metadata included
- paygate SDK (Express/Fastify) — this facilitator is the default: https://www.npmjs.com/package/paygate
- EUR pricing: paygate({ merchantId, currency: "EUR" }) settles EURC; priceCents means euro cents
- Or set any x402 middleware's facilitatorUrl to https://facilitator.arispay.app

## Pay it (agents paying x402 APIs)
- Use the payagent SDK / CLI — never sign EIP-3009 or submit settlement by hand: https://www.npmjs.com/package/payagent
- Find paid APIs first: npx payagent discover "<what you need>" (read-only, free); inspect a price without paying: npx payagent inspect <url>

## Find resources settling here (crawlers + agents)
- Catalog: https://facilitator.arispay.app/discovery/resources — filters: q, network, asset, method, payTo, status=registered|settled|observed, includeStale, type=http|mcp
- Catalog contract (query params, deterministic ranking, staleness policy): https://facilitator.arispay.app/discovery/schema
- Sellers enter the catalog through a successful extension-aware verify/settle, or an explicit operator-approved unpaid probe of the same discovery metadata — no ArisPay account required

## Machine-readable surfaces (verify everything here)
- Supported kinds, live production block, fee policy: https://facilitator.arispay.app/supported
- Discovery (live vs planned networks, currencies, signer, endpoints): https://facilitator.arispay.app/facilitator
- Trust (custody model, relayer, verified EIP-712 domains, version): https://facilitator.arispay.app/trust
- Status + metrics (uptime, latency, settlement success rate): https://facilitator.arispay.app/status , https://facilitator.arispay.app/metrics
- Relayer wallet on Basescan: https://basescan.org/address/0xF0afD8bb6ff2Bd7BE9d98D570BcfC953008d6abB

## Endpoints
- POST https://facilitator.arispay.app/verify   — verify a signed payment header (free, no chain write; response carries requestId)
- POST https://facilitator.arispay.app/settle   — verify + settle EIP-3009 transfer on-chain (idempotent on the nonce; response carries requestId)
- GET  https://facilitator.arispay.app/supported
- GET  https://facilitator.arispay.app/facilitator
- GET  https://facilitator.arispay.app/receipts/{txHash}     — settlement receipt by tx hash
- GET  https://facilitator.arispay.app/settlements/{nonce}   — settlement status by payment id (EIP-3009 nonce)
- GET  https://facilitator.arispay.app/trust , /status , /metrics , /events/schema
(also mirrored under /facilitator/*)

## Facts (all in-band verifiable)
- Non-custodial: verifies signed authorizations + submits settlement; funds move buyer → seller directly; no held funds, balances, escrow, or payout release
- Scope: verifies payment payloads and requirements, not fulfillment — the resource server is responsible for delivering what it sold
- Live production: Base mainnet (eip155:8453), USDC + EURC, EIP-3009 exact scheme (EIP-712 domains verified on-chain); other networks listed only as planned
- Cost: no facilitator fee; seller pays chain gas (~$0.001/settle); limited relay gas fronted during launch (bounded daily budget), >=30 days' notice before change
- Webhooks: event schema published at https://facilitator.arispay.app/events/schema (payment.verified, payment.settled, payment.failed, settlement.confirmed, settlement.failed); delivery upcoming, not yet implemented
- Source: https://github.com/arispay-inc/facilitator