한 줄이면 402가 뜹니다.

015분 안에 첫 402 만들기

내 서버가 402 를 뱉고 결제가 통과하는 것까지가 목표입니다. 설치할 게 없습니다.

① 상점을 만든다

npx create-x402-store my-store
cd my-store

② 돈 받을 주소를 넣는다

# .env
PAY_TO=0x여기에_당신의_지갑_주소     // 팔린 금액이 여기로 바로 들어옵니다

③ 띄운다

npm install && npm run dev

  x402 store  →  http://localhost:8787
  결제 대상   →  http://localhost:8787/hello.txt

④ 402 를 확인한다

curl -i http://localhost:8787/hello.txt

HTTP/1.1 402 Payment Required
PAYMENT-REQUIRED: eyJ4NDAyVmVyc2lvbiI6Mi...

{
  "x402Version": 2,
  "accepts": [{
    "scheme": "exact",
    "network": "eip155:4663",          // Robinhood Chain
    "amount": "100000",                // 0.10 USDG (6 decimals)
    "asset":  "0x5fc5360d0400a0fd4f2af552add042d716f1d168",
    "payTo":  "0x...",
    "extra":  { "name": "Global Dollar", "version": "1" }
  }]
}

⑤ 결제까지 해본다

# 한도 안인지 확인 (서명은 키가 있어야 합니다)
npx x402 test-buy http://localhost:8787/hello.txt --max 1.00

# 실제 서명·결제
pip install x402-bind
x402-bind new
x402-bind buy http://localhost:8787/hello.txt --max 1.00

유료로 만든 줄

import { x402 } from "@buysign/x402/express";

app.get("/report.pdf",
  x402({ price: "0.50", payTo: PAY_TO }),   // ← 이 한 줄
  (req, res) => {
    // 결제가 끝난 뒤에만 실행됩니다
    res.locals.x402;          // { order_id, transaction, payer }
    res.sendFile("/report.pdf");
  });

02검색

03402 결제

X-PAYMENT 만드는 법

payload = {
  "x402Version": 2, "scheme": "exact", "network": "eip155:4663",
  "payload": {
    "authorization": { "from","to","value","validAfter","validBefore","nonce" },
    "signature": "0x..."          // EIP-712 TransferWithAuthorization
  }
}
X-PAYMENT: base64(json(payload))

04결제 링크

키가 없는 클라이언트(ChatGPT·Claude 같은)를 위해, 사람이 자기 지갑으로 낼 링크를 만듭니다.

curl -s -X POST https://buysign.ai/api/quote \
  -H 'content-type: application/json' \
  -d '{"shop":"the-modern","sku":"ascended-heroes-booster-bundle","to":"US"}'

{ "code": "kfpc9v", "url": "https://buysign.ai/p/kfpc9v", "expires_in": 86400 }

링크를 여는 것만으로는 아무 일도 일어나지 않습니다. 돈은 지갑 서명에서만 움직입니다.

05MCP — ChatGPT · Claude · Gemini

셋 다 같은 URL 하나로 붙습니다. 벤더별로 만들 게 없습니다.

https://buysign.ai/mcp   // streamable HTTP

도구: search_items · get_item · quote · checkout_link · list_shops · how_to_pay

06판매 API

계정도 비밀번호도 없습니다. 지갑 서명이 곧 신원이고, 그 주소가 곧 수령 주소입니다.

# 1. 서명할 문장을 받는다
POST /api/auth/challenge      { "address": "0x..." }
# 2. personal_sign 으로 서명하고 세션을 받는다 (30분)
POST /api/auth/session        { "message": "...", "signature": "0x..." }
# 3. 상점을 연다
POST /api/shops               { "slug": "my-shop", "name": "My Shop" }
# 4. 상품을 올린다 (사진은 data: URL 로 같이)
POST /api/shops/my-shop/items { "item": { "sku","title","price_usdc","stock",
                                          "photos":[...], "shipping_zones":[...] } }

07왜 구매자가 가스를 안 내나

EIP-3009 는 서명과 제출을 분리합니다. 구매자는 "이 금액을 이 주소로 보내도 좋다" 는 메시지에 서명만 하고, 그걸 체인에 올려 가스를 내는 건 판매자 쪽 릴레이어입니다. 그래서 구매자 지갑에는 스테이블코인만 있으면 됩니다. ETH 가 필요 없습니다.

08아직 없는 것

붙이기 전에 알고 있어야 하는 것들입니다.

1. 에스크로가 없습니다. 즉시 이전이라 물건이 안 오면 구매자가 집니다. (x402 v2 스펙에도 escrow 스킴이 없습니다 — 스킴은 exact·upto·batch-settlement 뿐입니다.)
2. 판정이 없습니다. 물건이 설명과 같은지 제3자가 확인하는 층은 아직 없습니다.
3. Node SDK 가 없습니다. 서명이 로컬에서 일어나야 해서 파이썬으로 먼저 냈습니다.