> ## 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 Guide d'intégration > Platform API guide - Ace Data Cloud X402 est un protocole de paiement en chaîne basé sur HTTP `402 Payment Required`. Grâce aux capacités X402 d'Ace Data Cloud, l'appelant peut effectuer un paiement en chaîne directement en USDC à chaque requête API sans créer de jeton API ni précharger le solde du compte. Ce groupe de documents est organisé selon l'ordre d'intégration réel : d'abord exécuter une requête minimale, puis intégrer le SDK, et enfin comprendre le réseau, le plan de facturation, le paiement des commandes et le Facilitateur. Il est conseillé de lire le tableau ci-dessous de haut en bas. | Tutoriel | Scénario d'application | Lien | | - | - | - | | Démarrage rapide | Comprendre d'abord le processus 402, `accepts` et `PAYMENT-SIGNATURE` avec une requête minimale | [Démarrage rapide X402](https://platform.acedata.cloud/documents/x402-quickstart) | | SDK TypeScript | Appeler l'API Ace Data Cloud dans un navigateur, Node.js ou une application frontale | [Intégration SDK TypeScript](https://platform.acedata.cloud/documents/x402-typescript-sdk) | | SDK Python | Appeler l'API dans un service Python, un script, un Agent ou un pipeline de données | [Intégration SDK Python](https://platform.acedata.cloud/documents/x402-python-sdk) | | Paiement de commande | Payer les commandes du tableau de bord Ace Data Cloud avec X402 | [Tutoriel de paiement de commande](https://platform.acedata.cloud/documents/x402-order-payment) | | Réseaux et méthodes de paiement | Comprendre les actifs, les signatures et les scénarios d'application de Base, SKALE, Solana | [Réseaux et méthodes de paiement](https://platform.acedata.cloud/documents/x402-networks) | | `exact` et `upto` | Différencier l'API à prix fixe et l'API de facturation postérieure | [Explication du plan de facturation](https://platform.acedata.cloud/documents/x402-metered-upto) | | Explication des prix | Comprendre la relation entre les prix X402 et le prix unitaire des crédits, ainsi que les prix réels des services | [Explication des prix X402](https://platform.acedata.cloud/documents/x402-pricing) | | Facilitateur | Comprendre les liens serveur pour `verify`, `settle` et l'API de collecte auto-construite | [Intégration Facilitateur](https://platform.acedata.cloud/documents/x402-facilitator) | | E2E et dépannage | Vérifier les points d'entrée publics, exécuter des outils de validation avancés, localiser les problèmes courants de 402, de signature et de règlement | [Validation E2E et dépannage](https://platform.acedata.cloud/documents/x402-e2e-troubleshooting) | ## Chemin d'intégration recommandé Si vous souhaitez simplement appeler l'API Ace Data Cloud, utilisez d'abord le SDK officiel : * TypeScript : `@acedatacloud/sdk` + `@acedatacloud/x402-client` * Python : `acedatacloud` + `acedatacloud-x402` Adresses des sources et des paquets publics : | Projet | Adresse | | - | - | | 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) | | Facilitateur 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/) | Le SDK gérera automatiquement la première requête sans authentification, analysera le `402 Payment Required`, appellera le gestionnaire de paiement et réessaiera ces étapes avec `PAYMENT-SIGNATURE`. Vous devez simplement préparer un portefeuille contenant des USDC et choisir le réseau que vous souhaitez utiliser. Si vous souhaitez que votre API prenne également en charge les paiements X402, vous devez lire la documentation du Facilitateur pour comprendre la relation entre `paymentRequirements`, `paymentPayload`, `/verify` et `/settle`. ## État de support Ace Data Cloud X402 a été validé sur l'API publique, le SDK officiel, le Facilitateur et le chemin de règlement en chaîne. Le tableau ci-dessous résume l'état actuel selon les dimensions de capacité les plus couramment utilisées lors de l'intégration par les développeurs. | Capacité | État | Description | | - | - | - | | Capacités du Facilitateur | Disponible | `https://facilitator.acedata.cloud/.well-known/x402` retourne les réseaux de paiement et les points de terminaison du protocole. | | API 402 `accepts` | Disponible | Les requêtes non payées retourneront les exigences de paiement disponibles pour Base, SKALE et Solana. | | SDK TypeScript | Disponible | `@acedatacloud/sdk` et `@acedatacloud/x402-client` gèrent automatiquement 402, les signatures et les réessais. | | SDK Python | Disponible | `acedatacloud` et `acedatacloud-x402` gèrent automatiquement 402, les signatures et les réessais. | | Base `exact` | Validé en chaîne | Adapté pour les API à montant fixe et le paiement des commandes. | | Base `upto` | Validé en chaîne | Adapté pour les API de mesure postérieure comme la complétion de chat, actuellement le seul réseau à offrir `upto`. | | SKALE `exact` | Validé en chaîne | Adapté pour les scénarios de paiement EVM à faible coût de gaz. | | Solana `exact` | HTTP paid retry validé | API paid retry validé avec réponse de modèle ; il est conseillé d'utiliser votre propre RPC Solana pour la réconciliation. | | Paiement de commande | Validé en chaîne | Le paiement de commande Base `exact` a été réglé en chaîne et l'état de la commande a été mis à jour. | La sortie suivante est uniquement à des fins d'illustration des formes de retour des chemins validés. Lors de l'intégration réelle, veuillez toujours vous référer à l'`accepts` retourné par l'API actuelle. ```text theme={null} packages @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 Base exact content ADC_BASE_E2E_OK tx 0x408430ab3451bc22a51e510cdb4b063d6b9686724fea7a31fc109af20f5cd2f3 explorer https://basescan.org/tx/0x408430ab3451bc22a51e510cdb4b063d6b9686724fea7a31fc109af20f5cd2f3 SKALE exact content ADC_SKALE_E2E_OK tx 0x9fd09901e74c763325fe118b2bc64765c3fca785b86b24a78b97964384db084f explorer https://skale-base-explorer.skalenodes.com/tx/0x9fd09901e74c763325fe118b2bc64765c3fca785b86b24a78b97964384db084f Base upto content ADC_BASE_UPTO_OK tx 0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036 explorer https://basescan.org/tx/0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036 signed ceiling 95215 atomic USDC transfer value 3 atomic USDC Solana exact 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 ``` Remarques : * Les paquets npm et PyPI ont été installés et importés avec succès dans un environnement propre. * Les requêtes API non payées renvoient 402, `accepts` contient les méthodes de paiement disponibles pour Base, SKALE et Solana. * `accepts[].network` est l'identifiant CAIP-2, le client doit correspondre à la chaîne CAIP-2 lors du choix du réseau. * Les SDK TypeScript et Python peuvent tous deux gérer automatiquement le 402 et effectuer une nouvelle tentative de paiement. * Les adresses explorer pour Base `exact`, SKALE `exact`, Base `upto` et le paiement de commande sont toutes accessibles publiquement. * La limite de signature pour Base `upto` est de `95215` USDC atomiques, le règlement réel est de `3` USDC atomiques, ce qui reflète la caractéristique de règlement basé sur la mesure réelle. * Solana `exact` a validé HTTP 402 -> HTTP 200 et la sortie du modèle. Étant donné que les requêtes RPC publiques peuvent être limitées, il est conseillé d'utiliser un RPC Solana propre ou des enregistrements de règlement côté plateforme pour confirmer la signature de la transaction lors d'un rapprochement strict. ## Considérations d'intégration Lors de l'intégration, les développeurs doivent d'abord se concentrer sur les exigences de paiement en temps réel renvoyées par la requête actuelle, plutôt que de copier les montants ou adresses d'exemple dans la documentation : * `accepts[].maxAmountRequired` est le montant maximum pouvant être signé pour la requête actuelle. * `accepts[].asset` est le contrat ou le mint USDC à utiliser pour cette requête. * `accepts[].extra.chainId`, `accepts[].extra.facilitatorAddress` et `accepts[].extra.verifyingContract` participeront à la signature des données typées EVM. * `upto` nécessite que le portefeuille autorise d'abord le USDC de la chaîne cible via Permit2 ; sans autorisation, cela renverra `PERMIT2_ALLOWANCE_REQUIRED`. * Si vous souhaitez clairement utiliser la mesure postérieure, veuillez passer `preferScheme: 'upto'` dans le SDK TypeScript, sinon le SDK choisira le premier besoin disponible renvoyé par le serveur sous ce réseau. ## Portée vérifiable publiquement Avant l'intégration, vous pouvez d'abord vérifier ces points d'entrée publics et le comportement des SDK : * Les requêtes API sans `Authorization` ou `PAYMENT-SIGNATURE` renverront `402 Payment Required`, et `accepts` dans la réponse est la seule base de signature pour cette requête. * Les SDK TypeScript et Python fournissent tous deux un gestionnaire de paiement, la couche de transport du SDK appellera le gestionnaire et réessaiera une fois après avoir reçu 402. * `https://facilitator.acedata.cloud/.well-known/x402` : renvoie les réseaux, schémas et points de terminaison pris en charge par le Facilitateur ; le prix de l'API reste conforme au 402 renvoyé en temps réel pour la requête cible. * `https://facilitator.acedata.cloud/supported` : renvoie les réseaux et schémas pris en charge par le Facilitateur. * Le dépôt X402Client contient des outils de vérification avancés en chaîne, pouvant être utilisés pour confirmer les signatures, les tentatives de réessai et le comportement de règlement ; la sortie des outils ne remplace pas le `accepts` renvoyé par l'API en ligne. `upto` appartient à un règlement basé sur la mesure postérieure, adapté aux API où la mesure réelle n'est connue qu'après la réponse, comme pour les complétions de chat ou les appels de modèle. Actuellement, seul Base propose `upto` ; si la vérification de la signature échoue, veuillez vérifier si l'identifiant de chaîne, l'adresse du facilitateur, le dépensier, le contrat USDC et l'allocation Permit2 correspondent à la réponse 402. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.