> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # X402 Integrationsleitfaden > Platform API guide - Ace Data Cloud X402 ist ein on-chain Zahlungsprotokoll, das auf HTTP `402 Payment Required` basiert. Durch die X402-Funktionalität von Ace Data Cloud kann der Aufrufer ohne Erstellung eines API-Tokens und ohne Vorauszahlung des Kontoguthabens bei jeder API-Anfrage direkt mit USDC on-chain bezahlen. Diese Dokumentation ist in der Reihenfolge des tatsächlichen Zugriffs organisiert: Zuerst einen minimalen Request erfolgreich durchführen, dann das SDK integrieren, und anschließend Netzwerke, Abrechnungsmodelle, Bestellzahlungen und Facilitator verstehen. Es wird empfohlen, die folgende Tabelle von oben nach unten zu lesen. | Tutorial | Anwendungsfall | Link | | - | - | - | | Schnellstart | Zuerst einen minimalen Request verstehen: 402, `accepts` und `PAYMENT-SIGNATURE` Prozess | [X402 Schnellstart](https://platform.acedata.cloud/documents/x402-quickstart) | | TypeScript SDK | Aufruf der Ace Data Cloud API in Browser, Node.js oder Frontend-Anwendungen | [TypeScript SDK Integration](https://platform.acedata.cloud/documents/x402-typescript-sdk) | | Python SDK | Aufruf der API in Python-Diensten, Skripten, Agenten oder Datenpipelines | [Python SDK Integration](https://platform.acedata.cloud/documents/x402-python-sdk) | | Bestellzahlung | Mit X402 Zahlungen für Bestellungen im Ace Data Cloud Dashboard | [Bestellzahlung Tutorial](https://platform.acedata.cloud/documents/x402-order-payment) | | Netzwerke und Zahlungsmethoden | Verstehen von Vermögenswerten, Signaturen und Anwendungsfällen für Base, SKALE, Solana | [Netzwerke und Zahlungsmethoden](https://platform.acedata.cloud/documents/x402-networks) | | `exact` und `upto` | Unterscheidung zwischen festen Preis-APIs und nutzungsbasierten Abrechnungs-APIs | [Abrechnungsmodell Beschreibung](https://platform.acedata.cloud/documents/x402-metered-upto) | | Preisbeschreibung | Verstehen der Beziehung zwischen X402 Preisen und Credits-Einzelpreisen sowie den tatsächlichen Preisen der Dienste | [X402 Preisbeschreibung](https://platform.acedata.cloud/documents/x402-pricing) | | Facilitator | Verstehen der Serververbindung für `verify`, `settle` und selbstgebaute Zahlungs-APIs | [Facilitator Integration](https://platform.acedata.cloud/documents/x402-facilitator) | | E2E und Fehlersuche | Überprüfen öffentlicher Endpunkte, Ausführen fortgeschrittener Validierungswerkzeuge, Lokalisierung häufiger 402-, Signatur- und Abrechnungsprobleme | [E2E Validierung und Fehlersuche](https://platform.acedata.cloud/documents/x402-e2e-troubleshooting) | ## Empfohlener Integrationspfad Wenn Sie nur die Ace Data Cloud API aufrufen möchten, verwenden Sie bevorzugt das offizielle SDK: * TypeScript: `@acedatacloud/sdk` + `@acedatacloud/x402-client` * Python: `acedatacloud` + `acedatacloud-x402` Öffentliche Quellcodes und Paketadressen: | Projekt | Adresse | | - | - | | Ace Data Cloud SDK | [https://github.com/AceDataCloud/SDK](https://github.com/AceDataCloud/SDK) | | X402 Client | [https://github.com/AceDataCloud/X402Client](https://github.com/AceDataCloud/X402Client) | | X402 Facilitator | [https://github.com/AceDataCloud/FacilitatorX402](https://github.com/AceDataCloud/FacilitatorX402) | | npm SDK | [https://www.npmjs.com/package/@acedatacloud/sdk](https://www.npmjs.com/package/@acedatacloud/sdk) | | npm X402 Client | [https://www.npmjs.com/package/@acedatacloud/x402-client](https://www.npmjs.com/package/@acedatacloud/x402-client) | | PyPI SDK | [https://pypi.org/project/acedatacloud/](https://pypi.org/project/acedatacloud/) | | PyPI X402 Client | [https://pypi.org/project/acedatacloud-x402/](https://pypi.org/project/acedatacloud-x402/) | Das SDK erledigt automatisch die erste nicht authentifizierte Anfrage, analysiert `402 Payment Required`, ruft den Zahlungs-Handler auf und wiederholt diese Schritte mit `PAYMENT-SIGNATURE`. Sie müssen nur eine Wallet mit USDC vorbereiten und das gewünschte Netzwerk auswählen. Wenn Sie möchten, dass Ihre API auch X402-Zahlungen unterstützt, müssen Sie die Facilitator-Dokumentation lesen und die Beziehung zwischen `paymentRequirements`, `paymentPayload`, `/verify` und `/settle` verstehen. ## Unterstützungsstatus Ace Data Cloud X402 wurde in öffentlichen APIs, offiziellen SDKs, Facilitator und on-chain Abrechnungswegen validiert. Die folgende Tabelle fasst den aktuellen Status nach den am häufigsten verwendeten Funktionalitäten für Entwickler zusammen. | Fähigkeit | Status | Beschreibung | | - | - | - | | Facilitator-Funktionalitäten | Verfügbar | `https://facilitator.acedata.cloud/.well-known/x402` gibt Zahlungsnetzwerke und Protokollendpunkte zurück. | | API 402 `accepts` | Verfügbar | Unbezahlte Anfragen geben verfügbare Zahlungsanforderungen für Base, SKALE und Solana zurück. | | TypeScript SDK | Verfügbar | `@acedatacloud/sdk` und `@acedatacloud/x402-client` können 402, Signaturen und Wiederholungen automatisch verarbeiten. | | Python SDK | Verfügbar | `acedatacloud` und `acedatacloud-x402` können 402, Signaturen und Wiederholungen automatisch verarbeiten. | | Base `exact` | On-chain validiert | Geeignet für feste Betrags-APIs und Bestellzahlungen. | | Base `upto` | On-chain validiert | Geeignet für nachträgliche Abrechnungs-APIs wie Chat-Vervollständigungen, derzeit das einzige Netzwerk, das `upto` anbietet. | | SKALE `exact` | On-chain validiert | Geeignet für EVM-Zahlungsszenarien mit niedrigen Gas-Kosten. | | Solana `exact` | HTTP paid retry validiert | Validierte API paid retry und Modellantwort; für on-chain Signaturbestätigungen wird empfohlen, eigene Solana RPC-Abstimmungen zu verwenden. | | Bestellzahlung | On-chain validiert | Base `exact` Bestellzahlungen wurden erfolgreich on-chain abgerechnet und der Bestellstatus aktualisiert. | Die folgende Ausgabe dient nur zur Veranschaulichung der Rückgabeformate des validierten Pfades. Bei der tatsächlichen Integration sollten Sie immer die aktuellen von der API zurückgegebenen `accepts` berücksichtigen. ```text theme={null} pakete @acedatacloud/sdk@2026.504.2 import ok @acedatacloud/x402-client@2026.531.3 import ok acedatacloud==2026.4.26.1 import ok acedatacloud-x402==2026.5.31.3 import ok API 402 status 402 accepts eip155:8453/exact, eip155:8453/upto, solana:5eykt4.../exact, eip155:1187947933/exact TypeScript SDK inhalt ADC_TS_SDK_X402_OK Python SDK inhalt ADC_PY_SDK_X402_OK Basis genau inhalt ADC_BASE_E2E_OK tx 0x408430ab3451bc22a51e510cdb4b063d6b9686724fea7a31fc109af20f5cd2f3 explorer https://basescan.org/tx/0x408430ab3451bc22a51e510cdb4b063d6b9686724fea7a31fc109af20f5cd2f3 SKALE genau inhalt ADC_SKALE_E2E_OK tx 0x9fd09901e74c763325fe118b2bc64765c3fca785b86b24a78b97964384db084f explorer https://skale-base-explorer.skalenodes.com/tx/0x9fd09901e74c763325fe118b2bc64765c3fca785b86b24a78b97964384db084f Basis bis inhalt ADC_BASE_UPTO_OK tx 0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036 explorer https://basescan.org/tx/0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036 unterzeichnete Obergrenze 95215 atomare USDC übertragungswert 3 atomare USDC Solana genau HTTP 402 -> HTTP 200 inhalt ADC_SOLANA_E2E_OK Kettenunterschrift in diesem Durchlauf nicht bestätigt Bestellzahlung bestellung 78481793-304e-47f7-bc0c-8231aec9cc1e status Fertig pay_way X402 tx 0xfec08cc00a159ea1ec692b32faa9bf3d17595a986301169e689d94f58bc44151 explorer https://basescan.org/tx/0xfec08cc00a159ea1ec692b32faa9bf3d17595a986301169e689d94f58bc44151 ``` Hinweis: * npm und PyPI-Pakete wurden erfolgreich in einer sauberen Umgebung installiert und importiert. * Unbezahlte API-Anfragen geben 402 zurück, `accepts` enthält verfügbare Zahlungsmethoden für Base, SKALE und Solana. * `accepts[].network` ist die CAIP-2 Kennung, die beim Auswählen des Netzwerks durch den Client nach CAIP-2 Zeichenfolgenübereinstimmung erfolgen muss. * Sowohl TypeScript SDK als auch Python SDK können 402 automatisch verarbeiten und einen bezahlten Retry durchführen. * Für Base `exact`, SKALE `exact`, Base `upto` und Bestellzahlungen gibt es öffentlich zugängliche Explorer-Adressen. * Die Signaturobergrenze für Base `upto` beträgt `95215` atomare USDC, die tatsächliche Abrechnung beträgt `3` atomare USDC, was die Eigenschaft der nachgelagerten Abrechnung nach tatsächlichem Verbrauch widerspiegelt. * Solana `exact` hat HTTP 402 -> HTTP 200 und Modellausgabe validiert. Da öffentliche RPC-Abfragen möglicherweise throttled werden, wird empfohlen, bei strengen Abgleichen eigene Solana RPC oder Plattform-seitige Abrechnungsaufzeichnungen zur Bestätigung der Transaktionsunterschrift zu verwenden. ## Integrationshinweise Entwickler sollten bei der Integration zunächst auf die aktuellen Zahlungsanforderungen der Anfrage achten, anstatt die Beispielbeträge oder -adressen aus der Dokumentation zu kopieren: * `accepts[].maxAmountRequired` ist der maximal signierbare Betrag für die aktuelle Anfrage. * `accepts[].asset` ist der USDC-Vertrag oder Mint, der für diese Anfrage verwendet werden soll. * `accepts[].extra.chainId`, `accepts[].extra.facilitatorAddress` und `accepts[].extra.verifyingContract` werden an der EVM-typisierten Datensignatur beteiligt. * `upto` erfordert, dass die Brieftasche zuvor USDC für die Zielkette mit Permit2 autorisiert; bei fehlender Autorisierung wird `PERMIT2_ALLOWANCE_REQUIRED` zurückgegeben. * Wenn ausdrücklich nach nachgelagerter Abrechnung gewünscht wird, geben Sie im TypeScript SDK `preferScheme: 'upto'` an, andernfalls wählt das SDK die erste verfügbare Anforderung, die vom Server in diesem Netzwerk zurückgegeben wird. ## Öffentlich überprüfbare Bereiche Vor der Integration können diese öffentlichen Eingänge und SDK-Verhalten überprüft werden: * API-Anfragen ohne `Authorization` oder `PAYMENT-SIGNATURE` geben `402 Payment Required` zurück, die `accepts` in der Antwort ist die einzige Signaturgrundlage für diese Anfrage. * Sowohl TypeScript SDK als auch Python SDK bieten einen Zahlungs-Handler, die SDK-Transportebene ruft den Handler nach Erhalt von 402 auf und versucht es erneut. * `https://facilitator.acedata.cloud/.well-known/x402`: Gibt die unterstützten Netzwerke, Schemes und Protokollendpunkte des Facilitators zurück; die API-Preise basieren weiterhin auf dem in der Zielanfrage in Echtzeit zurückgegebenen 402. * `https://facilitator.acedata.cloud/supported`: Gibt die unterstützten Netzwerke und Schemes des Facilitators zurück. * Das X402Client-Repository enthält fortschrittliche On-Chain-Validierungstools, die zur Bestätigung von Unterschriften, Wiederholungen und Abrechnungsverhalten verwendet werden können; die Toolausgabe ersetzt nicht die von der Online-API zurückgegebene `accepts`. `upto` gehört zur nachgelagerten Abrechnung und eignet sich für API-Anfragen, bei denen der tatsächliche Verbrauch erst nach der Antwort bekannt ist, wie z.B. bei Chat-Vervollständigungen oder Modellaufrufen. Derzeit bietet nur Base `upto` an; wenn die Signaturüberprüfung fehlschlägt, überprüfen Sie, ob die Chain-ID, die Facilitator-Adresse, der Spender, der USDC-Vertrag und die Permit2-Zulassung mit der 402-Antwort übereinstimmen. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.