x402란.
x402는 HTTP 네이티브 결제를 위한 개방형 프로토콜로, 2024년 말 Coinbase에 의해 발표되었습니다. 이는 서버가 구조화된 JSON 본문과 함께 402 결제 필요를 반환하는 방법을 정의합니다 - 수용 가능한 결제 요구 사항의 목록(스킴, 네트워크, 체인 ID, 수신자 주소, USDC 기본 단위의 금액, 결제 요청 ID) - 기계 클라이언트가 응답을 구문 분석하고, 온체인으로 결제하고, X-Payment 헤더와 함께 원래 호출을 재시도할 수 있도록 합니다.
HTTP 402는 30년 동안 사용되지 않았습니다. x402가 작동하게 만들었습니다.
The 402 Payment Required status code was reserved in the original HTTP spec for "future use" and never received a standardized implementation. For three decades, every actual payment flow on the web was built on top of 200 / 401 / 403: a server returns 401 when authentication is missing, the client signs up via a separate UI flow, gets credentials, and re-authenticates. The signup happens out of band. None of this works for AI agents, which cannot complete signup forms.
x402 fixes this by giving 402 a usable specification. A server can return 402 with structured machine-readable payment instructions; a client can parse those instructions, pay, and retry, all without ever touching a signup form. The protocol is the missing piece between "AI agents can call APIs" and "AI agents can pay for the APIs they call". Before x402, the only practical agent payment paths were pre-paid balance accounts (with manual top-up) or proprietary integrations per API. Both broke at scale.
x402의 전략적 중요성은 나머지 생태계가 구축할 수 있는 표준을 설정한다는 것입니다. 지갑은 한 번 x402 핸들러를 구현하고, 모든 x402 호환 API는 해당 지갑과 작동합니다. 서버 프레임워크는 한 번 x402 미들웨어를 구현하고, 모든 x402 인식 클라이언트는 그들에게 지불할 수 있습니다. 중재자(기본 결제를 정산하는 서비스)는 잠금이 아닌 서비스 품질로 경쟁합니다.
하나의 응답, 하나의 재시도, 하나의 결제.
수명 주기는 세 가지 상태를 가집니다: 미지급 호출, 결제, 재시도 호출. 아래는 미지급 호출 응답이 실제로 전송되는 모습입니다.
HTTP/1.1 402 Payment Required Content-Type: application/json { "resource": "POST /api/research-query", "accepts": [ { "scheme": "exact-usdc", "network": "mainnet", "chainId": "eip155:8453", "payToAddress": "0xAgent...", "amountWeiUsdc": "50000", "paymentRequestId": "pr_01J9...", "maxAgeSeconds": 60 } ] }
- Status code 402. Distinct from 401 (auth missing) and 403 (auth refused). The presence of 402 signals "payment is the missing input."
- resource + accepts[]. 본문은 보호된 리소스를 명명하고 하나 이상의 수용 가능한 결제 요구 사항을 나열합니다. 마이그레이션은 두 가지 요구 사항(예: 메인넷 및 테스트넷)을 인용하고 클라이언트가 선택할 수 있도록 할 수 있습니다.
- scheme / network / chainId. 결제 스킴(exact-usdc), 체인(메인넷은 Base), 및 CAIP-2 ID. 클라이언트는 결제 전에 이를 일치시킵니다.
- payToAddress / amountWeiUsdc. 수신자 지갑과 USDC 기본 단위의 정확한 금액(50000 = 0.05 USDC, 6 소수점). 클라이언트는 결제 전에 두 가지를 모두 확인합니다.
- paymentRequestId + maxAgeSeconds. 이 ID는 결제를 이 인용에 연결합니다; maxAgeSeconds는 결제가 얼마나 신선해야 하는지입니다. 다른 ID를 참조하거나 이 시간보다 오래된 결제는 거부됩니다.
- 재시도는 X-Payment 헤더를 포함합니다. 클라이언트가 온체인에서 지불한 후, 결제를 증명하는 X-Payment 헤더와 함께 원래 요청을 다시 발행합니다. 서버는 이를 검증하고 실제 결과를 반환합니다. 응답 헤더나 호스팅된 페이지는 x402 전송의 일부가 아닙니다.
x402가 실제로 사용되고 있습니다.
각 계층에서 채택의 성숙도를 기준으로 정렬된 세 가지 구체적인 배포.
MCP 서버가 미지급 도구 호출에 402 챌린지를 반환합니다.
유료 MCP 도구가 Claude Desktop으로부터 호출을 받고 호출자는 아직 지불 완료로 표시되지 않았습니다. 서버는 requirePayment 챌린지를 생성합니다 - 가격과 hostedUrl을 포함하는 402 - 그리고 이를 도구 오류로 반환합니다. Claude Desktop은 채팅에 링크를 렌더링합니다; 사용자는 $0.05 USDC를 지불합니다; 동일한 도구에 대한 다음 호출이 성공합니다.
API 엔드포인트 호출당 청구 제한
연구 API는 x402 서버 어댑터 뒤에서 호출당 $0.50를 청구합니다. AI 에이전트가 엔드포인트를 호출하고 금액과 수신자를 나열하는 402를 받고, 지갑에서 Base로 결제하며, X-Payment 헤더와 함께 요청을 다시 발행합니다. 어댑터는 헤더를 검증하고 결제된 응답을 반환합니다. 전체 루프는 60초 이내에 완료됩니다.
x402 인식 지갑을 통해 프로그래밍 방식으로 지불하는 에이전트
에이전트의 런타임은 x402를 인식합니다(사양을 구현합니다). 402에 도달하면 accepts[]에서 payToAddress와 금액을 읽고, 사전 승인된 지갑(지출 권한 내)에서 전송을 서명하고, Base에서 방송하며, X-Payment 헤더로 원래 호출을 재시도합니다. 인간의 개입 없이; 루프는 5-10초 내에 완료됩니다.
스택에서 x402를 둘러싼 것.
x402는 프로토콜입니다. 이 세 가지 용어는 그 위에 있는 개념과 이를 가능하게 하는 사용 사례를 포괄합니다.