Copy English

Why

Start from the pitch and find the slot. x402's story is payment with no processor: the server quotes a price in a 402 response, the client signs a USDC authorization, done. But verify-and-settle was outsourced to a facilitator — and the spec deliberately leaves that role permissionless: it is a URL the seller configures, not a party the protocol appoints. An open slot that anyone may fill and almost nobody wants to operate is exactly the shape a platform business looks for. Coinbase wrote the protocol, donated it to a foundation, and hosts the default facilitator free of charge. The protocol is a standard; the facilitator is the business.

The waiver is the tell. Facilitators price at or near zero today — Coinbase's free tier, PayAI absorbing transaction fees — for the same reason embedded wallets removed the seed phrase (embedded-wallet-policy): adoption first, authority later. The facilitator sits where a fee line can be added, sees every paid request, and is the party that can decline to settle. None of that shows up in a latency benchmark, which is this catalogue's recurring lesson: measure the authority before the UX. It is bundler-paymaster-dependencies replayed for payments — "no infrastructure" means someone else's infrastructure, and the someone is doing it below cost for a reason.

The swap test settles it. If moving from Coinbase's facilitator to PayAI's or to your own really is one config line with nothing else changing, the role stays commodity and the chokepoint stays theoretical — the protocol's neutrality is real. If the alternatives differ in chains, refund surfaces, and compliance posture — and Stripe's preview already settles x402 payments into PaymentIntents with fiat settlement and refunds — then "facilitator" is not one role but several different businesses wearing one word, switching costs are back, and the authority matrix, not the click count, is what tells them apart.

How it works

What a facilitator actually does

The facilitator holds no long-lived balance — but every paid request passes through it, and settlement happens only if it agrees.

The roster, as of 2026-09

Who governs the spec

The governance roster is the second tell: processors and card networks joined the body that standardizes the role that was supposed to replace them.

The four questions the matrix must answer, per facilitator

1. Refusal — can it decline to settle a valid signed payment (sanctions screening, terms of service), and is that documented or discovered?
2. Visibility — what does it log per request, and who can subpoena it?
3. Pricing authority — who can end the fee waiver, with what notice period?
4. Failure — when it dies between verify and settle, who owns the retry? (x402-settlement-retry — the two cards share one endpoint.)

← All Dev Notes · Workspace Index · Top ↑

Copy 한국어

중개자는 스펙에서는 선택이고, 현실에서는 표준이다

x402 의 홍보 문구는 결제 흐름에 프로세서가 없다는 것이지만, 유료 요청 하나하나는 여전히 검증하고 정산해 주는 facilitator 를 지나갑니다 — 스펙은 이 역할을 무허가로 열어 두었고, 시장은 대부분 Coinbase 에서 빌려 씁니다. 유료 엔드포인트 하나를 세 facilitator — Coinbase 호스팅 기본값, 경쟁사 하나, 셀프호스팅 하나 — 에 붙여 보고, 지연시간을 비교하기 전에 권한 행부터 채웁니다: 누가 정산을 거부할 수 있고, 누가 트래픽을 보고, 수수료 면제가 끝나면 누가 가격을 정하는가.

아직 범위 미정 — 산출물은 엔드포인트 하나, facilitator 설정 셋, 채워진 권한표 하나입니다. 1. 기본값. API 경로 하나를 x402 미들웨어로 보호하고 Coinbase CDP facilitator(Base, USDC)에 연결합니다. 온보딩이 요구한 것(CDP 계정, 인증), 정산 지연시간, 오늘 기준 수수료 줄을 기록합니다. 2. 교체 시험. facilitator 설정을 두 번째 호스팅 서비스(PayAI, 또는 승인되면 Stripe 프라이빗 프리뷰)로 바꿉니다. 코드 diff 는 한 줄 안팎이어야 합니다 — 실제로 바뀐 것을 적습니다: 체인, 수수료 체계, 환불·리포팅 표면, 이용약관. 3. 비상구. 레퍼런스 facilitator 를 셀프호스팅합니다: 내 RPC, 내 가스 지갑, 내 재시도 큐. 이것과 1 번 사이의 운영 부담 차이를 시간 단위로 재면, 그것이 호스팅 기본값의 가격입니다. 4. 권한표. facilitator 마다 답합니다: 유효한 결제의 정산을 거부할 수 있는가? 요청마다 무엇을 기록하는가? 수수료 면제를 누가, 어떤 예고 기간으로 끝낼 수 있는가? 그리고 정산 도중에 죽으면 재시도는 누구 책임인가 (x402-settlement-retry 가 그 경로를 다룹니다). 참고: x402 facilitator 문서, x402.org 생태계 — facilitators.

왜

홍보 문구에서 출발해 빈 자리를 찾습니다. x402 의 이야기는 프로세서 없는 결제입니다: 서버가 402 응답으로 가격을 제시하고, 클라이언트가 USDC 승인에 서명하면 끝. 하지만 검증·정산은 facilitator 에게 외주됐고 — 스펙은 그 역할을 의도적으로 무허가로 둡니다: 프로토콜이 지명하는 당사자가 아니라, 판매자가 설정하는 URL 하나입니다. 누구나 채울 수 있지만 거의 아무도 직접 운영하고 싶지 않은 빈 자리 — 플랫폼 사업이 찾는 모양이 정확히 이것입니다. Coinbase 는 프로토콜을 만들고, 재단에 기부하고, 기본 facilitator 를 무료로 호스팅합니다. 프로토콜은 표준이고, facilitator 가 사업입니다.

수수료 면제가 단서입니다. facilitator 들이 지금 0 원 언저리로 가격을 매기는 것 — Coinbase 의 무료 티어, 수수료를 대신 삼키는 PayAI — 은 임베디드 지갑이 시드 문구를 없앤 것과 같은 이유입니다 (embedded-wallet-policy): 채택 먼저, 권한은 나중에. facilitator 는 수수료 줄을 붙일 수 있는 자리에 앉아 있고, 모든 유료 요청을 보고, 정산을 거부할 수 있는 당사자입니다. 이 중 어느 것도 지연시간 벤치마크에는 나타나지 않습니다 — 이 목록의 반복되는 교훈: UX 보다 권한을 먼저 재라. bundler-paymaster-dependencies 의 결제판 재연입니다 — "인프라 불필요"는 남의 인프라라는 뜻이고, 그 남이 원가 이하로 돌리는 데는 이유가 있습니다.

교체 시험이 결론을 냅니다. Coinbase facilitator 에서 PayAI 나 셀프호스팅으로 옮기는 것이 정말 설정 한 줄이고 다른 아무것도 안 바뀐다면, 이 역할은 범용품으로 남고 병목은 이론에 그칩니다 — 프로토콜의 중립성이 실재하는 겁니다. 반대로 대안들이 체인·환불 표면·컴플라이언스 태세에서 서로 다르다면 — Stripe 프리뷰는 이미 x402 결제를 PaymentIntents 로 받아 법정화폐 정산과 환불까지 붙입니다 — "facilitator" 는 한 역할이 아니라 한 단어를 나눠 쓰는 서로 다른 사업들이고, 전환 비용이 되살아나며, 이들을 구별해 주는 것은 클릭 수가 아니라 권한표입니다.

동작 방식

facilitator 가 실제로 하는 일

facilitator 는 장기 잔액을 보관하지 않습니다 — 하지만 모든 유료 요청이 그것을 지나가고, 정산은 그것이 동의할 때만 일어납니다.

명단 — 2026-09 기준

스펙은 누가 다스리나

거버넌스 명단이 두 번째 단서입니다: 대체하겠다던 그 역할을 표준화하는 기구에, 프로세서와 카드 네트워크가 들어와 앉았습니다.

facilitator 마다 권한표가 답해야 할 질문 넷

1. 거부 — 유효한 서명 결제의 정산을 거부할 수 있는가(제재 스크리닝, 약관), 그것은 문서에 있는가 겪어야 아는가?
2. 가시성 — 요청마다 무엇을 기록하고, 누가 그것을 영장으로 가져갈 수 있는가?
3. 가격 권한 — 수수료 면제를 누가, 어떤 예고 기간으로 끝낼 수 있는가?
4. 장애 — 검증과 정산 사이에서 죽으면 재시도는 누구 책임인가? (x402-settlement-retry — 두 카드는 엔드포인트 하나를 공유합니다.)

← 전체 개발 노트 · 워크스페이스 인덱스 · 맨 위 ↑