결제 수락 (x402)

x402로 에이전트의 엔드포인트를 게이팅하여 다른 에이전트에게 요청별 요금 청구

x402를 사용하여 다른 에이전트에게 접근 비용을 청구하는 에이전트 서비스를 구축할 수 있습니다. 클라이언트가 결제 없이 엔드포인트를 호출하면 결제 요건과 함께 402를 반환합니다. 클라이언트가 결제하면 퍼실리테이터가 결제를 검증하고 서버가 응답을 전달합니다.

모의 데모

옵션 1 — OpenClaw monetize-service 스킬 (가장 간단)

CDP Agentic Wallet 스킬이 설치된 경우 단일 프롬프트로 유료 엔드포인트를 노출할 수 있습니다:

Terminal

npx skills add coinbase/agentic-wallet-skills

그런 다음 에이전트에게 요청합니다:

Set up a paid endpoint for my market data at $0.01 per request

monetize-service 스킬이 x402 게이팅을 설정하고 엔드포인트를 배포합니다. 서버 코드가 필요하지 않습니다.

CDP Agentic Wallet 스킬 →

옵션 2 — Sponge Wallet 결제 링크

다른 에이전트가 서비스에 접근하기 전에 결제하는 재사용 가능한 x402 결제 링크를 생성합니다:

Terminal

curl -X POST "https://api.wallet.paysponge.com/api/payment-links" \
  -H "Authorization: Bearer $SPONGE_API_KEY" \
  -H "Sponge-Version: 0.2.1" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "0.01",
    "description": "Access to my market data API"
  }'

반환된 결제 링크 URL을 클라이언트와 공유합니다. 결제 상태 확인:

Terminal

curl "https://api.wallet.paysponge.com/api/payment-links/{paymentLinkId}" \
  -H "Authorization: Bearer $SPONGE_API_KEY" \
  -H "Sponge-Version: 0.2.1"

Sponge Wallet 문서 →

옵션 3 — x402-express를 사용한 커스텀 서버

x402-express 패키지를 사용하여 Express 엔드포인트에 결제 게이팅을 추가합니다:

Terminal

npm install x402-express express

TypeScript

import express from "express";
import { paymentMiddleware } from "x402-express";

const app = express();

app.use(
  paymentMiddleware(
    "0xYourAgentWalletAddress",
    {
      "/api/data": {
        price: "$0.01",
        network: "base-sepolia",
      },
    }
  )
);

app.get("/api/data", (req, res) => {
  res.json({ data: "premium content" });
});

app.listen(3000);

미들웨어는 미결제 호출자에게 402를 반환합니다. CDP 퍼실리테이터가 검증과 온체인 정산을 처리합니다.

x402 셀러 퀵스타트 →

퍼실리테이터 설정

퍼실리테이터는 결제 페이로드를 검증하고 온체인에서 결제를 정산하는 오프체인 서비스입니다. 두 가지 옵션이 있습니다:

퍼실리테이터	사용 시기
CDP 퍼실리테이터 (기본)	프로덕션 — CDP API 키 필요, Base와 Solana 지원
공개 테스트넷 퍼실리테이터	개발 — API 키 불필요, Base Sepolia 전용

공개 테스트넷 퍼실리테이터 엔드포인트는 https://www.x402.org/facilitator입니다. 메인넷에서는 CDP 퍼실리테이터로 전환합니다. 전체 엔드포인트 세부 정보는 x402 클라이언트-서버 모델을 참조하세요.

가격 및 결제 조건

• USD로 가격 설정 (예: "$0.01") — 미들웨어가 적절한 토큰 금액으로 변환
• 결제는 기본적으로 Base의 USDC로 정산
• 최소 결제 금액 없음 — 1센트 미만의 금액도 지원
• 지갑이 직접 결제를 받음 — 프로토콜에서 별도 수수료 없음

엔드포인트를 검색 가능하게 만들기

/.well-known/SKILL.md에 엔드포인트의 입력, 출력, 가격, 인증 요건을 설명하는 SKILL.md 파일을 호스팅합니다. 에이전트는 이 경로를 확인하여 서비스를 검색합니다.

SKILL.md template

# Your Agent Service

## Description
What your service does, in plain language.

## Endpoints

### GET /api/data
- **Description:** Returns premium market data
- **Payment:** $0.01 per request via x402 (Base, USDC)
- **Output:** JSON with current prices and volume

## Authentication
x402 payment required. No API key needed.

ERC-8004 레지스트리에 서비스를 등록하면 에이전트가 카테고리별로 검색할 수 있습니다 — 에이전트 등록을 참조하세요.

관련 항목

x402 프로토콜

클라이언트 측에서 본 x402 작동 방식입니다.

x402 클라이언트-서버 모델

퍼실리테이터 엔드포인트와 프로토콜 주소입니다.