DE

So funktioniert die Zahlung

Die API verwendet x402 (HTTP 402 Payment Required) mit dem Schema exact. Die Abrechnung erfolgt in USDC auf Base ({network}). Es gibt weder ein Konto noch einen API-Schlüssel.

Ablauf

  1. Rufen Sie GET oder POST auf einem bezahlten Pfad ohne Zahlungs-Header auf.
  2. Lesen Sie den 402-JSON-Body (und den Header PAYMENT-REQUIRED). accepts[].amount ist der Preis in atomaren USDC-Einheiten (6 Dezimalstellen).
  3. Erstellen Sie eine signierte x402-Zahlungsnutzlast für payTo {payTo}, Asset {asset}.
  4. Wiederholen Sie dieselbe Anfrage mit dem Header PAYMENT-SIGNATURE oder X-PAYMENT.

Beispiel einer 402-Challenge

{
  "x402Version": 2,
  "error": "Payment required",
  "resource": {
    "url": "https://x402-gateway.forge-x402.workers.dev/api/iban",
    "description": "IBAN validation (ISO 13616 mod-97 checksum + per-country length), returns normalised IBAN, country and BBAN.",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "1000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x7B8bf45ac6AcbA6D4CFB626b57D3f5fF3C9C89F7",
      "maxTimeoutSeconds": 120,
      "extra": {
        "name": "USD Coin",
        "version": "2"
      }
    }
  ]
}

Mit einem x402-Client zahlen

Der einfachste Weg ist @x402/fetch (v2) mit @x402/evm, das die 402-Antwort mit einer signierten Zahlung wiederholt. Siehe In einem Aufruf testen. In einem Aufruf testen.

MCP

Dieselben Tools liegen unter {mcp} (Streamable HTTP, zustandslos). Die Zahlung wird in MCP _meta über @x402/mcp übergeben. list_endpoints ist kostenlos. Fehlgeschlagene Tool-Aufrufe werden nicht abgerechnet.

Treueprogramm

Ein Guthabenmodell (je 10 abgerechnete Aufrufe einer Zahleradresse = 1 kostenloser Aufruf) ist nur geplant: Das Ledger wird vom Gateway nicht gespeist. Siehe den Treue-Hinweis. Hinweis lesen.