Wykonanie płatności x402

Użyj Pay, aby uruchomić API x402 V2 i zapewnić Claude Code klienta HTTP obsługującego płatności. API, portfel płatnika i rozliczenie korzystają z piaskownicy Solana, więc ten poradnik nie wymaga konta ani prawdziwych środków.

Potrzebujesz terminala oraz zainstalowanych Pay i Claude Code.

1. Zainstaluj Pay

W systemie macOS zainstaluj gotowy plik binarny:

brew install pay
pay --version

Na innych platformach zainstaluj pakiet npm:

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

2. Uruchom API x402 w piaskownicy

Utwórz plik 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

Uruchom API i pozostaw je włączone:

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

Schemat x402-exact sprawia, że jest to endpoint obsługujący wyłącznie x402. Tryb piaskownicy automatycznie tworzy i zasila tymczasowe konta operatora i płatnika.

3. Uruchom agenta z Pay

W innym terminalu uruchom Claude Code w trybie piaskownicy:

pay --sandbox claude

Pay dołącza swoje lokalne narzędzia MCP do sesji agenta. Agent nie otrzymuje klucza prywatnego.

4. Wyślij jedno żądanie x402

Wklej ten prompt do agenta:

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.

To żądanie obejmuje jedną pełną pętlę płatności x402 V2:

1. API zwraca 402 Payment Required wraz z wezwaniem PAYMENT-REQUIRED.
2. Pay weryfikuje wymagania x402 i wyświetla warunki płatności.
3. Po zatwierdzeniu portfel w piaskownicy podpisuje transakcję, a Pay ponawia żądanie z nagłówkiem PAYMENT-SIGNATURE.
4. API zwraca wynik wraz z potwierdzeniem PAYMENT-RESPONSE.

Żadne prawdziwe środki nie są przenoszone. Odrzucenie zatwierdzenia zatrzymuje żądanie.

Przejdź do x402 na Solana, aby zbudować klienta i serwer zasobów x402 V2, lub zostań facylitatorem x402.