API 요청별 과금

x402 미들웨어를 사용하여 요청별 가격 책정으로 모든 HTTP 엔드포인트를 수익화하세요. 서버는 가격을 선언하고, 클라이언트는 호출마다 결제하며, 정산은 요청 수명 주기 내에서 이루어집니다. 계정도, API 키도, 청구 주기도 필요 없습니다.

작동 방식

서버는 수익화하려는 엔드포인트에 x402 미들웨어를 추가합니다. 결제 없이 요청이 도착하면 서버는 HTTP 402 Payment Required와 함께 가격, 토큰, 네트워크를 담은 PAYMENT-REQUIRED 헤더로 응답합니다. 클라이언트는 지정된 금액에 대해 ERC-3009 인가에 서명하고 다시 요청을 제출합니다. 퍼실리테이터가 온체인에서 결제를 정산하면 서버가 리소스를 반환합니다.

요청 흐름

1. 클라이언트가 서버에 HTTP 요청을 보냅니다.
2. 서버가 가격, 토큰, 네트워크, 수신자를 담은 PAYMENT-REQUIRED 헤더와 함께 402 Payment Required를 반환합니다.
3. 클라이언트가 지정된 금액에 대해 ERC-3009 인가에 서명하고 PAYMENT-SIGNATURE 헤더와 함께 요청을 다시 제출합니다.
4. 퍼실리테이터가 서명을 검증하고 온체인에서 전송을 정산합니다.
5. 서버가 정산 영수증을 담은 PAYMENT-RESPONSE 헤더와 함께 리소스를 반환합니다.

가격 책정

가격은 USDT0 원자 단위(소수점 6자리)로 표시됩니다. 비용 매개변수 "1000"은 정확히 $0.001로 변환됩니다. 비용 "50000"은 $0.05입니다. 이 정밀도 덕분에 서버는 1센트의 일부 수준으로 가격을 설정할 수 있습니다.

인프라

Stable에서는 Semantic Pay가 공개 퍼실리테이터를 운영합니다. 개발자는 자체 정산 인프라를 운영하지 않고도 이 엔드포인트로 미들웨어를 연결할 수 있습니다.

x402는 Express(@x402/express), Hono(@x402/hono), Next.js(@x402/next)용 미들웨어를 제공합니다. 모든 프레임워크에서 패턴은 동일합니다: 퍼실리테이터 클라이언트를 생성하고, EVM 스킴을 등록하며, 미들웨어를 적용합니다.

무엇이 다른가

전통적인 API 수익화는 사용자 등록, API 키 관리, 사용량 추적, 청구 주기, 결제 처리업체 통합을 필요로 합니다. x402를 사용하면 서버가 각 엔드포인트에 결제 핸들러를 연결하고, 클라이언트는 요청마다 결제하며, 정산은 동일한 HTTP 수명 주기 내에서 완료됩니다. 서버는 클라이언트가 누구인지 알 필요가 없으며, 유효한 결제가 제출되었다는 사실만 알면 됩니다.

• x402 (HTTP 네이티브 결제)
• ERC-3009 (인가를 통한 전송)
• 가스 면제