Eine x402-Zahlung durchführen

Nutze Pay, um eine x402-V2-API auszuführen und Claude Code einen zahlungsfähigen HTTP-Client zur Verfügung zu stellen. API, Payer-Wallet und Settlement nutzen alle die Solana-Sandbox, daher erfordert diese Anleitung weder Konten noch echte Gelder.

Du benötigst ein Terminal sowie installierte Versionen von Pay und Claude Code.

1. Pay installieren

Installiere unter macOS die vorkompilierte Binärdatei:

brew install pay
pay --version

Installiere auf anderen Plattformen das npm-Paket:

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

2. Eine x402-Sandbox-API starten

Erstelle 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

Starte die API und lasse sie weiterlaufen:

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

Das x402-exact-Schema macht daraus einen reinen x402-Endpunkt. Der Sandbox-Modus erstellt und finanziert automatisch temporäre Operator- und Payer-Konten.

3. Den Agenten mit Pay starten

Starte in einem weiteren Terminal Claude Code im Sandbox-Modus:

pay --sandbox claude

Pay bindet seine lokalen MCP-Tools in die Agentensitzung ein. Der Agent erhält keinen privaten Schlüssel.

4. Eine x402-Anfrage senden

Füge diesen Prompt in den Agenten ein:

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.

Die Anfrage durchläuft einen vollständigen x402-V2-Zahlungszyklus:

1. Die API gibt 402 Payment Required mit einer PAYMENT-REQUIRED-Challenge zurück.
2. Pay validiert die x402-Anforderungen und zeigt die Zahlungsbedingungen an.
3. Nach der Genehmigung signiert die Sandbox-Wallet, und Pay wiederholt die Anfrage mit PAYMENT-SIGNATURE.
4. Die API gibt das Ergebnis mit einem PAYMENT-RESPONSE-Beleg zurück.

Es werden keine echten Gelder bewegt. Wenn du die Genehmigung ablehnst, wird die Anfrage abgebrochen.

Weiter geht es mit x402 auf Solana, um einen x402-V2-Client und -Resource-Server zu erstellen, oder werde ein x402-Facilitator.