x402란?
x402는 HTTP402 Payment Required를 기반으로 구축된 기계 간 결제 프로토콜입니다. AI 에이전트가 사람의 개입 없이 API 접근에 대해 자동으로 결제할 수 있도록 합니다. AgentWallex는 EIP-3009 승인 페이로드를 사용하는 x402 v2를 구현합니다.
x402 v2 헤더
이 프로토콜은 세 개의 HTTP 헤더를 사용합니다:결제 흐름
1
에이전트가 리소스를 요청합니다
에이전트가 유료 API 엔드포인트에 표준 HTTP 요청을 보냅니다.
2
서버가 402를 반환합니다
API가 가격 세부 정보(금액, 토큰, 체인, payTo 주소)가 포함된
PAYMENT-REQUIRED 헤더와 함께 HTTP 402로 응답합니다.3
에이전트가 AgentWallex를 통해 결제합니다
에이전트가 결제 세부 정보를
POST /x402/pay로 전송합니다. AgentWallex가 정책을 평가하고 결제에 서명합니다.4
에이전트가 결제 증명과 함께 재시도합니다
에이전트가
PAYMENT-SIGNATURE 헤더를 첨부하여 원래 요청을 재시도합니다.5
서버가 확인하고 응답합니다
API가 결제 서명을 확인하고(AgentWallex facilitator를 통해) 리소스를 반환합니다.
x402 API 사용
URL이 x402를 지원하는지 확인
세션 예산 생성
세션을 통해 반복 API 호출에 대한 지출 예산을 사전 승인할 수 있습니다:결제 협상 실행
payment_info가 포함됩니다:
SDK 통합
자동 HTTP 인터셉터
TypeScript SDK는 전체 x402 흐름을 자동으로 처리하는 인터셉터를 제공합니다:수동 흐름
서비스 프로바이더를 위한 안내
유료 API를 노출하는 경우 서버는 결제가 누락되었을 때 x402 v2 챌린지를 반환해야 합니다.PAYMENT-REQUIRED와 함께 402 반환
JSON 챌린지(base64)를PAYMENT-REQUIRED 헤더에 인코딩합니다: