Thực hiện thanh toán x402

Sử dụng Pay để chạy một API x402 V2 và cung cấp cho Claude Code một HTTP client có khả năng thanh toán. API, ví người thanh toán và quá trình thanh toán bù trừ đều sử dụng sandbox của Solana, vì vậy hướng dẫn này không yêu cầu tài khoản hay tiền thật.

Bạn cần có một terminal, Pay và Claude Code đã được cài đặt.

1. Cài đặt Pay

Trên macOS, hãy cài đặt tệp nhị phân dựng sẵn:

brew install pay
pay --version

Trên các nền tảng khác, hãy cài đặt gói npm:

npm install --global @solana/pay
pay --version

2. Khởi động API sandbox x402

Tạo tệp x402-demo.yaml:

name: x402-demo
subdomain: x402-demo
title: "x402 Demo"
description: "Minimal x402 V2 sandbox endpoint."
category: devtools
version: v1
routing:
  type: respond
operator:
  currencies:
    usd: ["USDC"]
  network: "localnet"
  fee_payer: true
endpoints:
  - method: GET
    path: "report"
    description: "Return a sandbox report."
    metering:
      schemes: [x402-exact]
      dimensions:
        - direction: usage
          unit: requests
          scale: 1
          tiers:
            - price_usd: 0.001

Khởi động API và để nó tiếp tục chạy:

pay --sandbox server start x402-demo.yaml --bind 127.0.0.1:1402

Scheme x402-exact biến đây thành một endpoint chỉ hỗ trợ x402. Chế độ sandbox tự động tạo và nạp tiền cho các tài khoản operator và payer tạm thời.

3. Khởi chạy agent với Pay

Trong một terminal khác, hãy khởi động Claude Code ở chế độ sandbox:

pay --sandbox claude

Pay gắn các công cụ MCP cục bộ của nó vào phiên làm việc của agent. Agent không nhận được khóa riêng tư.

4. Thực hiện một yêu cầu x402

Dán prompt này vào agent:

Use Pay to make exactly one sandbox x402 API request to
http://127.0.0.1:1402/report.

Before paying, show me the amount and ask for approval. Then return the API
result and payment receipt. Do not make any other paid requests.

Yêu cầu này tuân theo một vòng thanh toán x402 V2 hoàn chỉnh:

1. API trả về 402 Payment Required kèm theo challenge PAYMENT-REQUIRED.
2. Pay xác thực các yêu cầu của x402 và hiển thị các điều khoản thanh toán.
3. Sau khi được phê duyệt, ví sandbox ký giao dịch và Pay thử lại yêu cầu với PAYMENT-SIGNATURE.
4. API trả về kết quả cùng biên nhận PAYMENT-RESPONSE.

Không có tiền thật nào được di chuyển. Từ chối phê duyệt sẽ dừng yêu cầu.

Tiếp tục với x402 trên Solana để xây dựng client và resource server x402 V2, hoặc trở thành x402 facilitator.