Repolode
x402-foundation

x402-foundation/x402

HTTP 기반의 개방형 인터넷 결제 프로토콜로, HTTP 402 Payment Required 상태 코드를 통해 서버가 요청별로 요금을 청구할 수 있습니다.

대체할 수 있는 제품:Stripe

스타
6,744
포크
2,209
열린 이슈
756
마지막 커밋
6일 전

어떤 프로젝트인가요?

x402는 인터넷에 적합한 결제를 위한 개방형 표준입니다. API나 웹페이지 같은 리소스 서버가 HTTP 402 Payment Required 상태 코드를 사용해 클라이언트에 결제를 요청하면, 클라이언트는 요청 헤더에 서명된 결제 정보를 담아 응답할 수 있습니다. 이 프로토콜은 여러 네트워크와 토큰에서 암호화폐와 법정화폐를 모두 지원하도록 설계되었습니다.

일반적인 흐름에서는 서버가 결제 요구사항을 반환하고, 클라이언트가 그중 하나를 선택해 결제 페이로드를 전송합니다. 그러면 facilitator가 결제를 검증하고 온체인에서 정산한 뒤 서버가 리소스를 반환합니다. exact, upto, batch-settlement 같은 결제 방식은 자금이 이동하는 방식을 정의하고, 네트워크는 정산 위치를 정합니다. 이 프로젝트는 TypeScript, Python, Go용 SDK와 Express, Fetch, Axios, Hono, Next 등의 통합 기능을 제공합니다.

클라이언트와 서버가 가스나 RPC 세부 사항을 직접 처리하지 않도록 하고, 이를 facilitator에 맡기는 데 설계의 중점을 둡니다. 결제는 비수탁형으로 이루어지므로 facilitator나 서버가 클라이언트가 의도한 범위를 넘어 자금을 이동할 수 없습니다.

핵심 기능

  • 01클라이언트가 처리할 수 있는 결제 요구사항과 함께 HTTP 402를 반환합니다.
  • 02exact, upto, batch-settlement를 비롯한 여러 결제 방식을 지원합니다.
  • 03플러그형 체인 구현을 통해 블록체인 네트워크와 법정화폐를 지원합니다.
  • 04TypeScript, Python, Go용 SDK를 제공합니다.
  • 05Express, Fastify, Hono, Next 등 다양한 프레임워크용 미들웨어를 제공합니다.

활용 사례

  • 사용자 계정이나 구독 없이 유료 API의 요청별 요금을 청구합니다.
  • 조회당 소액 결제로 기사, 데이터 또는 파일에 대한 접근을 판매합니다.
  • AI 에이전트나 자동화된 클라이언트가 HTTP를 통해 웹 리소스 비용을 결제할 수 있게 합니다.

빠른 시작

  1. 1

    TypeScript Express 서버 패키지를 설치합니다

    npm install @x402/core @x402/evm @x402/svm @x402/express
  2. 2

    Python 패키지를 설치합니다

    pip install x402
  3. 3

    Go 모듈을 설치합니다

    go get github.com/x402-foundation/x402/go/v2

사용 전 알아둘 점

  • 결제 스킴과 네트워크 지원은 다를 수 있으므로 클라이언트와 퍼실리테이터는 각 (스킴, 네트워크) 조합을 명시적으로 지원해야 합니다.
  • README에서는 mainnet EVM 프로덕션 환경에서 공개 x402.org 퍼실리테이터를 사용할 것이라고 가정하지 말 것을 권장합니다.

토픽

자주 묻는 질문

x402은(는) 무엇인가요?
HTTP 기반의 개방형 인터넷 결제 프로토콜로, HTTP 402 Payment Required 상태 코드를 통해 서버가 요청별로 요금을 청구할 수 있습니다. x402는 인터넷에 적합한 결제를 위한 개방형 표준입니다. API나 웹페이지 같은 리소스 서버가 HTTP 402 Payment Required 상태 코드를 사용해 클라이언트에 결제를 요청하면, 클라이언트는 요청 헤더에 서명된 결제 정보를 담아 응답할 수 있습니다. 이 프로토콜은 여러 네트워크와 토큰에서 암호화폐와 법정화폐를 모두 지원하도록 설계되었습니다.
x402은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
x402은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
x402은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. x402의 마지막 커밋은 2026년 10월 15일입니다.
x402은(는) 어디에 사용할 수 있나요?
사용자 계정이나 구독 없이 유료 API의 요청별 요금을 청구합니다. 조회당 소액 결제로 기사, 데이터 또는 파일에 대한 접근을 판매합니다. AI 에이전트나 자동화된 클라이언트가 HTTP를 통해 웹 리소스 비용을 결제할 수 있게 합니다.
x402는 어떻게 설치하나요?
TypeScript Express 서버 패키지를 설치합니다: npm install @x402/core @x402/evm @x402/svm @x402/express Python 패키지를 설치합니다: pip install x402 Go 모듈을 설치합니다: go get github.com/x402-foundation/x402/go/v2
x402은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/x402-foundation/x402

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트