> ## 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 Integrationsguide > Platform API guide - Ace Data Cloud X402 är ett kedjebaserat betalningsprotokoll baserat på HTTP `402 Payment Required`. Genom Ace Data Clouds X402-funktionalitet kan anropande part genomföra kedjebaserade betalningar direkt med USDC i varje API-förfrågan utan att skapa en API-token eller förladda kontobalansen. Denna dokumentation är organiserad i den ordning som en verklig integration skulle ske: först genomföra en minimal förfrågan, sedan integrera SDK, och därefter förstå nätverk, prissättningsmodeller, orderbetalningar och Facilitator. Det rekommenderas att läsa enligt tabellen nedan från topp till botten. | Tutorial | Användningsområde | Länk | | - | - | - | | Snabbstart | Förstå 402, `accepts` och `PAYMENT-SIGNATURE` flödet med en minimal förfrågan | [X402 Snabbstart](https://platform.acedata.cloud/documents/x402-quickstart) | | TypeScript SDK | Anropa Ace Data Cloud API i webbläsare, Node.js eller frontend-appar | [TypeScript SDK Integration](https://platform.acedata.cloud/documents/x402-typescript-sdk) | | Python SDK | Anropa API i Python-tjänster, skript, agenter eller datarörledningar | [Python SDK Integration](https://platform.acedata.cloud/documents/x402-python-sdk) | | Orderbetalning | Betala för Ace Data Cloud-konsolens order med X402 | [Orderbetalning Tutorial](https://platform.acedata.cloud/documents/x402-order-payment) | | Nätverk och betalningsmetoder | Förstå tillgångar, signaturer och användningsområden för Base, SKALE och Solana | [Nätverk och betalningsmetoder](https://platform.acedata.cloud/documents/x402-networks) | | `exact` och `upto` | Åtskilja fasta pris-API och användningsbaserade API med efterhandsavräkning | [Prissättningsmodellens beskrivning](https://platform.acedata.cloud/documents/x402-metered-upto) | | Prissättning | Förstå relationen mellan X402-priser och Credits enhetspriser, samt de verkliga priserna för varje tjänst | [X402 Prissättning](https://platform.acedata.cloud/documents/x402-pricing) | | Facilitator | Förstå relationen mellan `verify`, `settle` och egenbyggda betalnings-API:er på serversidan | [Facilitator Integration](https://platform.acedata.cloud/documents/x402-facilitator) | | E2E och felsökning | Kontrollera offentliga ingångar, köra avancerade verifieringsverktyg, lokalisera vanliga 402-, signatur- och avräkningsproblem | [E2E Verifiering och felsökning](https://platform.acedata.cloud/documents/x402-e2e-troubleshooting) | ## Rekommenderad integrationsväg Om du bara vill anropa Ace Data Cloud API, använd först den officiella SDK: * TypeScript: `@acedatacloud/sdk` + `@acedatacloud/x402-client` * Python: `acedatacloud` + `acedatacloud-x402` Offentliga källkoder och paketadresser: | Projekt | Adress | | - | - | | 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/) | SDK:n kommer automatiskt att hantera den första förfrågan utan autentisering, tolka `402 Payment Required`, anropa betalningshanteraren och återförsöka dessa steg med `PAYMENT-SIGNATURE`. Du behöver bara förbereda en plånbok med USDC och välja det nätverk du vill använda. Om du vill att din egen API också ska stödja X402-betalningar, behöver du läsa Facilitator-dokumentationen för att förstå relationen mellan `paymentRequirements`, `paymentPayload`, `/verify` och `/settle`. ## Stödsstatus Ace Data Cloud X402 har verifierats i offentliga API:er, officiella SDK:er, Facilitator och kedjebaserade avräkningsvägar. Tabellen nedan sammanfattar nuvarande status enligt de mest använda kapabiliteterna vid utvecklarintegration. | Kapabilitet | Status | Beskrivning | | - | - | - | | Facilitator-kapabiliteter | Tillgänglig | `https://facilitator.acedata.cloud/.well-known/x402` returnerar betalningsnätverk och protokolländpunkter. | | API 402 `accepts` | Tillgänglig | Obetalda förfrågningar returnerar tillgängliga betalningskrav för Base, SKALE och Solana. | | TypeScript SDK | Tillgänglig | `@acedatacloud/sdk` och `@acedatacloud/x402-client` kan automatiskt hantera 402, signaturer och återförsök. | | Python SDK | Tillgänglig | `acedatacloud` och `acedatacloud-x402` kan automatiskt hantera 402, signaturer och återförsök. | | Base `exact` | Verifierad på kedjan | Lämplig för fasta belopp API och orderbetalningar. | | Base `upto` | Verifierad på kedjan | Lämplig för chattkomplettering och andra efterhandsavräknings-API:er, för närvarande det enda nätverket som erbjuder `upto`. | | SKALE `exact` | Verifierad på kedjan | Lämplig för EVM-betalningsscenarier med låga gasavgifter. | | Solana `exact` | HTTP betald återförsök verifierad | Verifierad API betald återförsök och modellrespons; kedjebaserad signaturbekräftelse rekommenderas att använda egen Solana RPC för avstämning. | | Orderbetalning | Verifierad på kedjan | Base `exact` orderbetalningar har genomfört kedjebaserad avräkning och uppdaterat orderstatus. | Följande utdata är endast avsedda att illustrera de verifierade vägarna för returformer. Vid faktisk integration, vänligen lita alltid på den aktuella API:ns returnerade `accepts`. ```text theme={null} paket @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 content ADC_TS_SDK_X402_OK Python SDK content ADC_PY_SDK_X402_OK Bas exakt content ADC_BASE_E2E_OK tx 0x408430ab3451bc22a51e510cdb4b063d6b9686724fea7a31fc109af20f5cd2f3 explorer https://basescan.org/tx/0x408430ab3451bc22a51e510cdb4b063d6b9686724fea7a31fc109af20f5cd2f3 SKALE exakt content ADC_SKALE_E2E_OK tx 0x9fd09901e74c763325fe118b2bc64765c3fca785b86b24a78b97964384db084f explorer https://skale-base-explorer.skalenodes.com/tx/0x9fd09901e74c763325fe118b2bc64765c3fca785b86b24a78b97964384db084f Bas upp till content ADC_BASE_UPTO_OK tx 0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036 explorer https://basescan.org/tx/0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036 signed ceiling 95215 atomic USDC transfer value 3 atomic USDC Solana exakt HTTP 402 -> HTTP 200 content ADC_SOLANA_E2E_OK chain signature not confirmed in this run Order payment order 78481793-304e-47f7-bc0c-8231aec9cc1e state Finished pay_way X402 tx 0xfec08cc00a159ea1ec692b32faa9bf3d17595a986301169e689d94f58bc44151 explorer https://basescan.org/tx/0xfec08cc00a159ea1ec692b32faa9bf3d17595a986301169e689d94f58bc44151 ``` Anmärkningar: * npm och PyPI-paket har installerats och importerats framgångsrikt i en ren miljö. * Obetald API-förfrågan returnerar 402, `accepts` innehåller tillgängliga betalningsmetoder för Bas, SKALE och Solana. * `accepts[].network` är CAIP-2 identifierare, klienten måste matcha nätverket enligt CAIP-2 sträng. * TypeScript SDK och Python SDK kan automatiskt hantera 402 och slutföra betald omförsök. * Bas `exakt`, SKALE `exakt`, Bas `upp till` och orderbetalning har offentligt tillgängliga explorer-adresser. * Bas `upp till` har en signaturgräns på `95215` atomic USDC, den faktiska avräkningen är `3` atomic USDC, vilket återspeglar egenskapen av efterhandsmätning baserat på verklig användning. * Solana `exakt` har verifierat HTTP 402 -> HTTP 200 och modellutdata. Eftersom offentliga RPC-förfrågningar kan begränsas rekommenderas det att använda egen Solana RPC eller plattformens avräkningsregister för att bekräfta transaktionssignaturer. ## Anslutningsanvisningar Utvecklare bör prioritera att fokusera på de aktuella betalningskraven som returneras i realtid, snarare än att kopiera exempelbelopp eller adresser från dokumentationen: * `accepts[].maxAmountRequired` är det maximala belopp som kan signeras för den aktuella förfrågan. * `accepts[].asset` är den USDC-kontrakt eller mint som ska användas för denna förfrågan. * `accepts[].extra.chainId`, `accepts[].extra.facilitatorAddress` och `accepts[].extra.verifyingContract` kommer att delta i EVM-typad data signering. * `upp till` kräver att plånboken först ger tillstånd för målchain USDC med Permit2; om det inte är auktoriserat kommer det att returnera `PERMIT2_ALLOWANCE_REQUIRED`. * Om det tydligt önskas att använda efterhandsmätning, vänligen skicka in `preferScheme: 'upp till'` i TypeScript SDK, annars kommer SDK att välja det första tillgängliga kravet som returneras av servern under det nätverket. ## Områden som kan verifieras offentligt Innan anslutning kan dessa offentliga ingångar och SDK-beteenden verifieras: * API-förfrågningar utan `Authorization` eller `PAYMENT-SIGNATURE` kommer att returnera `402 Payment Required`, och `accepts` i svaret är den enda signeringsgrunden för denna förfrågan. * TypeScript SDK och Python SDK erbjuder båda en betalningshanterare, SDK:s transportlager kommer att anropa hanteraren och försöka igen efter att ha mottagit 402. * `https://facilitator.acedata.cloud/.well-known/x402`: returnerar Facilitatorns stöd för nätverk, schema och protokolländpunkter; API-priserna baseras fortfarande på den aktuella 402 som returneras av målförfrågan. * `https://facilitator.acedata.cloud/supported`: returnerar Facilitatorns stöd för nätverk och schema. * X402Client-förvaret innehåller avancerade verktyg för verifiering på kedjan, som kan användas för att bekräfta signaturer, omförsök och avräkningsbeteende; verktygens utdata ersätter inte den online API:s returnerade `accepts`. `upp till` tillhör efterhandsmätning avräkning, lämplig för chattkomplettering, modellanrop och andra verkliga användningar som endast är kända efter svaret. För närvarande erbjuder endast Bas `upp till`; om signaturverifieringen misslyckas, kontrollera att chain id, facilitatoradress, spenderare, USDC-kontrakt och Permit2-tillstånd överensstämmer med 402-svaret. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.