> ## 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. # Guida all'integrazione X402 > Platform API guide - Ace Data Cloud X402 è un protocollo di pagamento on-chain basato su HTTP `402 Payment Required`. Grazie alle capacità di X402 di Ace Data Cloud, il chiamante può effettuare pagamenti on-chain in USDC senza creare un API Token o pre-caricare il saldo dell'account, effettuando il pagamento direttamente in ogni richiesta API. Questo insieme di documenti è organizzato secondo l'ordine di integrazione reale: prima eseguire una richiesta minima, poi integrare l'SDK, e infine comprendere rete, piani tariffari, pagamento degli ordini e Facilitator. Si consiglia di leggere la tabella seguente dall'alto verso il basso. | Tutorial | Scenari applicabili | Link | | - | - | - | | Inizio rapido | Comprendere il processo 402, `accepts` e `PAYMENT-SIGNATURE` con una richiesta minima | [Inizio rapido X402](https://platform.acedata.cloud/documents/x402-quickstart) | | SDK TypeScript | Chiamare l'API di Ace Data Cloud in browser, Node.js o applicazioni front-end | [Integrazione SDK TypeScript](https://platform.acedata.cloud/documents/x402-typescript-sdk) | | SDK Python | Chiamare l'API in servizi Python, script, Agent o pipeline di dati | [Integrazione SDK Python](https://platform.acedata.cloud/documents/x402-python-sdk) | | Pagamento ordini | Utilizzare X402 per pagare ordini nella console di Ace Data Cloud | [Tutorial pagamento ordini](https://platform.acedata.cloud/documents/x402-order-payment) | | Rete e metodi di pagamento | Comprendere asset, firme e scenari applicabili per Base, SKALE, Solana | [Rete e metodi di pagamento](https://platform.acedata.cloud/documents/x402-networks) | | `exact` e `upto` | Distinguere tra API a prezzo fisso e API a pagamento posticipato | [Descrizione piani tariffari](https://platform.acedata.cloud/documents/x402-metered-upto) | | Descrizione prezzi | Comprendere la relazione tra i prezzi di X402 e il prezzo unitario dei Crediti, e i prezzi reali dei servizi | [Descrizione prezzi X402](https://platform.acedata.cloud/documents/x402-pricing) | | Facilitator | Comprendere i collegamenti server-side per `verify`, `settle` e API di pagamento personalizzate | [Integrazione Facilitator](https://platform.acedata.cloud/documents/x402-facilitator) | | E2E e risoluzione dei problemi | Controllare ingressi pubblici, eseguire strumenti di verifica avanzati, localizzare problemi comuni di 402, firme e regolamenti | [Verifica E2E e risoluzione dei problemi](https://platform.acedata.cloud/documents/x402-e2e-troubleshooting) | ## Percorso di integrazione consigliato Se desideri solo chiamare l'API di Ace Data Cloud, utilizza prioritariamente l'SDK ufficiale: * TypeScript: `@acedatacloud/sdk` + `@acedatacloud/x402-client` * Python: `acedatacloud` + `acedatacloud-x402` Indirizzi del codice sorgente e dei pacchetti pubblici: | Progetto | Indirizzo | | - | - | | SDK Ace Data Cloud | [https://github.com/AceDataCloud/SDK](https://github.com/AceDataCloud/SDK) | | Client X402 | [https://github.com/AceDataCloud/X402Client](https://github.com/AceDataCloud/X402Client) | | Facilitator X402 | [https://github.com/AceDataCloud/FacilitatorX402](https://github.com/AceDataCloud/FacilitatorX402) | | SDK npm | [https://www.npmjs.com/package/@acedatacloud/sdk](https://www.npmjs.com/package/@acedatacloud/sdk) | | Client X402 npm | [https://www.npmjs.com/package/@acedatacloud/x402-client](https://www.npmjs.com/package/@acedatacloud/x402-client) | | SDK PyPI | [https://pypi.org/project/acedatacloud/](https://pypi.org/project/acedatacloud/) | | Client X402 PyPI | [https://pypi.org/project/acedatacloud-x402/](https://pypi.org/project/acedatacloud-x402/) | L'SDK gestirà automaticamente la prima richiesta senza autenticazione, analizzerà il `402 Payment Required`, chiamerà il gestore dei pagamenti e ripeterà questi passaggi con `PAYMENT-SIGNATURE`. Devi solo preparare un wallet con USDC e scegliere la rete che desideri utilizzare. Se desideri che la tua API supporti anche i pagamenti X402, dovrai leggere la documentazione del Facilitator e comprendere la relazione tra `paymentRequirements`, `paymentPayload`, `/verify` e `/settle`. ## Stato di supporto Ace Data Cloud X402 ha completato la verifica su API pubbliche, SDK ufficiali, Facilitator e percorsi di regolamento on-chain. La tabella seguente riassume lo stato attuale secondo le dimensioni delle capacità più comunemente utilizzate dagli sviluppatori durante l'integrazione. | Capacità | Stato | Descrizione | | - | - | - | | Capacità del Facilitator | Disponibile | `https://facilitator.acedata.cloud/.well-known/x402` restituisce i punti finali di rete di pagamento e protocollo. | | API 402 `accepts` | Disponibile | Le richieste non pagate restituiranno i requisiti di pagamento disponibili per Base, SKALE e Solana. | | SDK TypeScript | Disponibile | `@acedatacloud/sdk` e `@acedatacloud/x402-client` gestiscono automaticamente 402, firme e ripetizioni. | | SDK Python | Disponibile | `acedatacloud` e `acedatacloud-x402` gestiscono automaticamente 402, firme e ripetizioni. | | Base `exact` | Verificato on-chain | Adatto per API a importo fisso e pagamento ordini. | | Base `upto` | Verificato on-chain | Adatto per API a misurazione posticipata come completamento chat, attualmente l'unica rete che offre `upto`. | | SKALE `exact` | Verificato on-chain | Adatto per scenari di pagamento EVM a basso costo di gas. | | Solana `exact` | HTTP paid retry verificato | Verificato il pagamento retry API e la risposta del modello; si consiglia di utilizzare il proprio RPC Solana per la riconciliazione. | | Pagamento ordini | Verificato on-chain | Il pagamento degli ordini Base `exact` è stato completato e lo stato dell'ordine è stato aggiornato. | Le seguenti uscite sono solo per illustrare la forma di ritorno dei percorsi verificati. Durante l'integrazione reale, fare sempre riferimento ai `accepts` restituiti dall'API corrente. ```text theme={null} pacchetti @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 stato 402 accetta eip155:8453/exact, eip155:8453/upto, solana:5eykt4.../exact, eip155:1187947933/exact TypeScript SDK contenuto ADC_TS_SDK_X402_OK Python SDK contenuto ADC_PY_SDK_X402_OK Base exact contenuto ADC_BASE_E2E_OK tx 0x408430ab3451bc22a51e510cdb4b063d6b9686724fea7a31fc109af20f5cd2f3 esplora https://basescan.org/tx/0x408430ab3451bc22a51e510cdb4b063d6b9686724fea7a31fc109af20f5cd2f3 SKALE exact contenuto ADC_SKALE_E2E_OK tx 0x9fd09901e74c763325fe118b2bc64765c3fca785b86b24a78b97964384db084f esplora https://skale-base-explorer.skalenodes.com/tx/0x9fd09901e74c763325fe118b2bc64765c3fca785b86b24a78b97964384db084f Base upto contenuto ADC_BASE_UPTO_OK tx 0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036 esplora https://basescan.org/tx/0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036 firmato limite 95215 atomic USDC valore di trasferimento 3 atomic USDC Solana exact HTTP 402 -> HTTP 200 contenuto ADC_SOLANA_E2E_OK firma della catena non confermata in questo run Pagamento ordine ordine 78481793-304e-47f7-bc0c-8231aec9cc1e stato Finito pay_way X402 tx 0xfec08cc00a159ea1ec692b32faa9bf3d17595a986301169e689d94f58bc44151 esplora https://basescan.org/tx/0xfec08cc00a159ea1ec692b32faa9bf3d17595a986301169e689d94f58bc44151 ``` Nota: * I pacchetti npm e PyPI sono stati installati e importati con successo in un ambiente pulito. * La richiesta API non pagata restituisce 402, `accetta` include i metodi di pagamento disponibili per Base, SKALE e Solana. * `accepts[].network` è un identificatore CAIP-2, il client deve abbinare la rete secondo la stringa CAIP-2. * Sia il TypeScript SDK che il Python SDK possono gestire automaticamente il 402 e completare il pagamento retry. * Gli indirizzi dell'esploratore per Base `exact`, SKALE `exact`, Base `upto` e pagamento dell'ordine sono tutti pubblicamente accessibili. * Il limite di firma per Base `upto` è di `95215` atomic USDC, il regolamento effettivo è di `3` atomic USDC, riflettendo la caratteristica di regolamento posteriore basata sul consumo reale. * Solana `exact` ha verificato HTTP 402 -> HTTP 200 e l'output del modello. Poiché le query RPC pubbliche possono essere limitate, si consiglia di utilizzare un proprio RPC Solana o registri di regolamento della piattaforma per confermare la firma della transazione. ## Considerazioni per l'integrazione Quando gli sviluppatori si integrano, si prega di prestare attenzione ai requisiti di pagamento in tempo reale restituiti dalla richiesta attuale, piuttosto che copiare gli importi o gli indirizzi di esempio nel documento: * `accepts[].maxAmountRequired` è l'importo massimo che può essere firmato per la richiesta attuale. * `accepts[].asset` è il contratto o mint USDC da utilizzare per questa richiesta. * `accepts[].extra.chainId`, `accepts[].extra.facilitatorAddress` e `accepts[].extra.verifyingContract` parteciperanno alla firma dei dati tipizzati EVM. * `upto` richiede che il portafoglio autorizzi prima il USDC della catena di destinazione tramite Permit2; se non autorizzato, restituirà `PERMIT2_ALLOWANCE_REQUIRED`. * Se si desidera esplicitamente utilizzare il calcolo posteriore, si prega di passare `preferScheme: 'upto'` nel TypeScript SDK, altrimenti il SDK selezionerà il primo requisito disponibile restituito dal server per quella rete. ## Ambito di verifica pubblica Prima di integrarsi, è possibile verificare questi ingressi pubblici e il comportamento del SDK: * Le richieste API senza `Authorization` o `PAYMENT-SIGNATURE` restituiranno `402 Payment Required`, e `accepts` nella risposta è l'unica base per la firma di questa richiesta. * Sia il TypeScript SDK che il Python SDK forniscono un gestore di pagamento, il livello di trasporto del SDK, dopo aver ricevuto il 402, chiamerà il gestore e riproverà una volta. * `https://facilitator.acedata.cloud/.well-known/x402`: restituisce le reti, gli schemi e i punti finali del protocollo supportati dal Facilitator; il prezzo API rimane basato sul 402 restituito in tempo reale dalla richiesta di destinazione. * `https://facilitator.acedata.cloud/supported`: restituisce le reti e gli schemi supportati dal Facilitator. * Il repository X402Client include strumenti avanzati di verifica on-chain, utilizzabili per confermare firme, retry e comportamenti di regolamento; l'output degli strumenti non sostituisce l'`accepts` restituito dall'API online. `upto` appartiene al regolamento di calcolo posteriore, adatto per API come completamento di chat, chiamate a modelli e altre quantità reali che si conoscono solo dopo la risposta. Attualmente solo Base offre `upto`; se la verifica della firma fallisce, si prega di controllare se l'id della catena, l'indirizzo del facilitatori, lo spender, il contratto USDC e l'autorizzazione Permit2 corrispondono alla risposta 402. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.