--- title: "Ihre erste bezahlte Anfrage mit x402 senden" description: "Senden Sie eine Anfrage an x402.erpc.global, lesen Sie den Preis in der 402-Antwort, bezahlen Sie ihn mit einem x402-Client und erhalten Sie das RPC-Ergebnis mit einer Abwicklungsbestätigung." canonical: "https://erpc.global/de/doc/x402/quickstart/" locale: "de" --- # Ihre erste bezahlte Anfrage mit x402 senden Diese Anleitung zeigt am Beispiel einer Solana-Anfrage den Ablauf mit x402: Preis ablesen, bezahlen und die Antwort mit einer Abwicklungsbestätigung erhalten. Die anderen 15 Chains funktionieren genauso, jeweils unter ihrer eigenen Route. Sie brauchen eine Wallet mit USDC auf Solana oder mit USDC bzw. EURC auf Base sowie einen x402-Client: die Software, die die 402-Antwort liest, mit Ihrer Wallet eine Zahlung signiert und die Anfrage damit erneut sendet. Mehr zu x402-Clients finden Sie in der x402-Dokumentation auf [x402.org](https://x402.org/). ## 1. Die Anfrage senden Senden Sie die RPC-Anfrage ohne Zahlung: ```bash curl -i https://x402.erpc.global/v1/solana-mainnet \ --header 'Content-Type: application/json' \ --data '{"jsonrpc":"2.0","id":1,"method":"getSlot"}' ``` Die Antwort ist 402 Payment Required. Die Header der Antwort nennen die Methode und den Preis: ```http HTTP/2 402 x-payment-required: eyJ4NDAyVmVyc2lvbiI6Mi… x-rpc-methods: getSlot x-rpc-weight: 1000 x-rpc-price-usd: 0.001 ``` Der Body listet die Zahlungsoptionen unter `accepts` auf, eine für jeden Stablecoin, mit dem sich die Anfrage bezahlen lässt. `amount` ist in der kleinsten Einheit des Stablecoins angegeben, 1000 entspricht also 0.001 USDC bzw. 0.001 EURC: ```json { "error": { "code": "payment_required", "message": "Payment required", "request_id": "…" }, "x402Version": 2, "accepts": [ { "scheme": "exact", "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "amount": "1000", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", … }, { "scheme": "exact", "network": "eip155:8453", "amount": "1000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", … }, { "scheme": "exact", "network": "eip155:8453", "amount": "1000", "asset": "0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42", … } ], "pricing": { "methods": ["getSlot"], …, "weight": 1000, "rawWeight": 42, …, "price": "$0.001", … }, … } ``` ## 2. Mit einem x402-Client bezahlen Übergeben Sie die 402-Antwort an Ihren x402-Client. Er wählt eine Option, die Ihre Wallet bezahlen kann, signiert eine Zahlung über diesen Betrag und kodiert sie für den Header X-Payment. Für Netzwerkgebühren brauchen Sie dabei weder SOL noch ETH. ## 3. Die Anfrage mit der Zahlung erneut senden Senden Sie denselben Body erneut, mit der Zahlung im Header X-Payment: ```bash curl -i https://x402.erpc.global/v1/solana-mainnet \ --header 'Content-Type: application/json' \ --header 'X-Payment: ' \ --data '{"jsonrpc":"2.0","id":1,"method":"getSlot"}' ``` Lassen Sie den Body unverändert. Der Preis wird aus dem Body berechnet. Hat ein geänderter Body einen anderen Preis, passt die Zahlung nicht mehr dazu, und die Antwort lautet `price_mismatch`. Sobald die Zahlung geprüft und abgewickelt ist, kommt die RPC-Antwort mit der Abwicklungsbestätigung im Header X-Payment-Response zurück: ```http HTTP/2 200 x-payment-response: ``` ```json { "jsonrpc": "2.0", "id": 1, "result": … } ``` Eine Zahlung gilt für genau eine Anfrage. Senden Sie dieselbe Zahlung erneut, wird sie mit 402 `payment_invalid` oder 409 `duplicate_payment` abgelehnt, und die Anfrage wird nicht noch einmal weitergeleitet. ## Antworten Eine Anfrage, die x402.erpc.global mit einem Fehler beantwortet, bevor eine Zahlung verlangt wird, kostet nichts. | Status | `error.code` | Was passiert ist | | --- | --- | --- | | 402 | `payment_required` | Es wurde keine Zahlung gesendet. Der Body nennt den Preis und die Zahlungsoptionen. | | 402 | `payment_invalid` | Die Zahlung hat die Prüfung nicht bestanden. Signieren Sie eine neue Zahlung und senden Sie die Anfrage erneut. | | 402 | `price_mismatch` | Die Zahlung weicht von jeder Option ab, die die 402-Antwort dieser Anfrage angeboten hat, etwa im Preis. | | 402 | `payment_amount_too_low` | Der Betrag liegt unter der kleinsten Zahlung, die x402.erpc.global abwickelt. | | 402 | `settlement_failed` | Die Abwicklung wurde als fehlgeschlagen gemeldet. Die Antwort bietet die Zahlungsoptionen erneut an. | | 409 | `duplicate_payment` | Die Zahlung wurde bereits verwendet. | | 400 | `method_not_supported`, `invalid_request` | Die Route verkauft die Methode nicht oder nimmt den Body nicht an. Es wird nichts berechnet. | | 413 | `batch_too_large` | Der Batch enthält mehr als 100 Aufrufe. Es wird nichts berechnet. | | 500 | `configuration_error` | Die Route kann derzeit keine Anfragen bedienen. Es wird nichts berechnet. | | 503 | `payment_unavailable` | Derzeit kann keine Zahlungsoption angeboten werden. Es wird nichts berechnet. Versuchen Sie es nach den in Retry-After genannten Sekunden erneut. | | 503 | `service_busy` | Zu viele Anfragen auf einmal. Es wird nichts berechnet. Versuchen Sie es nach den in Retry-After genannten Sekunden erneut. | | 502 | `settlement_failed` | Das Ergebnis der Abwicklung ist unbekannt: Die Zahlung wurde möglicherweise ausgeführt, und es ist keine Bestätigung angehängt. Prüfen Sie auf Solana oder Base, ob die von Ihnen signierte Zahlung ausgeführt wurde, bevor Sie eine neue signieren. | | 502, 504 | `upstream_error`, `upstream_timeout` | Die Zahlung wurde abgewickelt, aber die Chain hat nicht oder nicht rechtzeitig geantwortet. Die Bestätigung ist trotzdem angehängt. Wenn Sie die Anfrage erneut senden, ist eine neue Zahlung nötig. | Auf Solana wird ein Aufruf, der zu viel lesen würde, etwa ein ungefiltertes `getProgramAccounts` für ein großes Programm, mit HTTP 200 und einem JSON-RPC-Fehler beantwortet, bevor eine Zahlung verlangt wird. Er kostet also nichts. ## Nächste Schritte - [So berechnet x402 den Preis einer Anfrage](https://erpc.global/de/doc/x402/pricing/): der Preis eines Aufrufs, das Minimum von \$0.001 und Batches. - [x402-Übersicht](https://erpc.global/de/doc/x402/overview/): die Route jeder Chain und die Zahlungsoptionen. - [OpenAPI-Dokument](https://x402.erpc.global/doc): Aufbau von Anfrage und Antwort jeder Route.