> ## 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 Przewodnik integracji > Platform API guide - Ace Data Cloud X402 to oparty na HTTP `402 Payment Required` protokół płatności na łańcuchu. Dzięki możliwościom X402 w Ace Data Cloud, wywołujący może dokonywać płatności na łańcuchu bez tworzenia tokena API i bez wcześniejszego doładowania salda konta, płacąc bezpośrednio USDC w każdej prośbie API. Zestaw dokumentów jest zorganizowany według rzeczywistej kolejności integracji: najpierw wykonaj minimalne żądanie, następnie zintegrować SDK, a potem zrozumieć sieć, plany taryfowe, płatności za zamówienia i Facilitator. Zaleca się czytanie według poniższej tabeli od góry do dołu. | Poradnik | Scenariusz zastosowania | Link | | - | - | - | | Szybki start | Najpierw zrozum 402, `accepts` i proces `PAYMENT-SIGNATURE` za pomocą minimalnego żądania | [Szybki start X402](https://platform.acedata.cloud/documents/x402-quickstart) | | TypeScript SDK | Wywoływanie API Ace Data Cloud w przeglądarkach, Node.js lub aplikacjach frontendowych | [Integracja TypeScript SDK](https://platform.acedata.cloud/documents/x402-typescript-sdk) | | Python SDK | Wywoływanie API w usługach Python, skryptach, Agentach lub potokach danych | [Integracja Python SDK](https://platform.acedata.cloud/documents/x402-python-sdk) | | Płatność za zamówienie | Płatność za zamówienia w konsoli Ace Data Cloud za pomocą X402 | [Poradnik płatności za zamówienie](https://platform.acedata.cloud/documents/x402-order-payment) | | Sieć i metody płatności | Zrozumienie aktywów, podpisów i scenariuszy zastosowania w Base, SKALE, Solana | [Sieć i metody płatności](https://platform.acedata.cloud/documents/x402-networks) | | `exact` i `upto` | Rozróżnienie między API o stałej cenie a API z rozliczeniem po zużyciu | [Opis planów taryfowych](https://platform.acedata.cloud/documents/x402-metered-upto) | | Opis cenowy | Zrozumienie relacji między ceną X402 a jednostkową ceną kredytów oraz rzeczywistymi cenami usług | [Opis cen X402](https://platform.acedata.cloud/documents/x402-pricing) | | Facilitator | Zrozumienie relacji między `verify`, `settle` a własnym API do odbioru płatności | [Integracja Facilitator](https://platform.acedata.cloud/documents/x402-facilitator) | | E2E i rozwiązywanie problemów | Sprawdzanie publicznych punktów dostępu, uruchamianie zaawansowanych narzędzi weryfikacyjnych, lokalizowanie typowych problemów z 402, podpisami i rozliczeniami | [Weryfikacja E2E i rozwiązywanie problemów](https://platform.acedata.cloud/documents/x402-e2e-troubleshooting) | ## Zalecana ścieżka integracji Jeśli chcesz tylko wywołać API Ace Data Cloud, najpierw użyj oficjalnego SDK: * TypeScript: `@acedatacloud/sdk` + `@acedatacloud/x402-client` * Python: `acedatacloud` + `acedatacloud-x402` Publiczne źródła i adresy pakietów: | Projekt | Adres | | - | - | | Ace Data Cloud SDK | [https://github.com/AceDataCloud/SDK](https://github.com/AceDataCloud/SDK) | | Klient X402 | [https://github.com/AceDataCloud/X402Client](https://github.com/AceDataCloud/X402Client) | | Facilitator X402 | [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 Klient X402 | [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 Klient X402 | [https://pypi.org/project/acedatacloud-x402/](https://pypi.org/project/acedatacloud-x402/) | SDK automatycznie obsłuży pierwsze żądanie bez uwierzytelnienia, zinterpretuje `402 Payment Required`, wywoła handler płatności i powtórzy te kroki z `PAYMENT-SIGNATURE`. Musisz tylko przygotować portfel z USDC i wybrać sieć, której chcesz użyć. Jeśli chcesz, aby Twoje API również obsługiwało płatności X402, musisz przeczytać dokumentację Facilitator, aby zrozumieć relacje między `paymentRequirements`, `paymentPayload`, `/verify` i `/settle`. ## Status wsparcia Ace Data Cloud X402 został zweryfikowany w publicznym API, oficjalnym SDK, Facilitatorze i ścieżkach rozliczeń na łańcuchu. Poniższa tabela podsumowuje aktualny status według najczęściej używanych wymiarów możliwości przez deweloperów. | Możliwość | Status | Opis | | - | - | - | | Możliwości Facilitator | Dostępne | `https://facilitator.acedata.cloud/.well-known/x402` zwraca sieci płatności i punkty końcowe protokołu. | | API 402 `accepts` | Dostępne | Nieopłacone żądania zwracają dostępne wymagania płatności dla Base, SKALE i Solana. | | TypeScript SDK | Dostępne | `@acedatacloud/sdk` i `@acedatacloud/x402-client` automatycznie obsługują 402, podpisy i powtórzenia. | | Python SDK | Dostępne | `acedatacloud` i `acedatacloud-x402` automatycznie obsługują 402, podpisy i powtórzenia. | | Base `exact` | Zweryfikowane na łańcuchu | Odpowiednie dla API o stałej kwocie i płatności za zamówienia. | | Base `upto` | Zweryfikowane na łańcuchu | Odpowiednie dla API z pomiarem po zużyciu, obecnie jedyna sieć oferująca `upto`. | | SKALE `exact` | Zweryfikowane na łańcuchu | Odpowiednie dla scenariuszy płatności EVM o niskich kosztach gazu. | | Solana `exact` | HTTP paid retry zweryfikowane | Zweryfikowane API paid retry i odpowiedzi modelu; zaleca się użycie własnego rozliczenia RPC Solana. | | Płatność za zamówienie | Zweryfikowane na łańcuchu | Płatność za zamówienia Base `exact` została zakończona na łańcuchu i zaktualizowano status zamówienia. | Poniższe wyjście służy wyłącznie do ilustracji formatu zwrotu zweryfikowanej ścieżki. Podczas rzeczywistej integracji zawsze kieruj się aktualnymi `accepts` zwracanymi przez API. ```text theme={null} pakiety @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 ``` Uwagi: * Pakiety npm i PyPI zostały zainstalowane i zaimportowane pomyślnie w czystym środowisku. * Nieopłacone żądanie API zwraca 402, `accepts` zawiera dostępne metody płatności dla Base, SKALE i Solana. * `accepts[].network` to identyfikator CAIP-2, przy wyborze sieci przez klienta należy dopasować zgodnie z ciągiem CAIP-2. * TypeScript SDK i Python SDK automatycznie obsługują 402 i wykonują ponowną próbę płatności. * Base `exact`, SKALE `exact`, Base `upto` oraz płatność za zamówienie mają publicznie dostępne adresy eksploratora. * Limit podpisu dla Base `upto` wynosi `95215` atomic USDC, rzeczywiste rozliczenie wynosi `3` atomic USDC, co odzwierciedla cechę rozliczania na podstawie rzeczywistego zużycia. * Solana `exact` zweryfikowała HTTP 402 -> HTTP 200 oraz wyjście modelu. Ze względu na możliwe ograniczenia zapytań RPC publicznych, w przypadku ścisłego uzgadniania zaleca się korzystanie z własnego RPC Solana lub potwierdzenie podpisu transakcji na zapisach rozliczeniowych platformy. ## Uwagi dotyczące integracji Podczas integracji deweloperzy powinni najpierw zwrócić uwagę na aktualne wymagania dotyczące płatności zwracane przez żądanie, a nie kopiować przykładowe kwoty lub adresy z dokumentacji: * `accepts[].maxAmountRequired` to maksymalna kwota, którą można podpisać w bieżącym żądaniu. * `accepts[].asset` to kontrakt USDC lub mint, który ma być użyty w tym żądaniu. * `accepts[].extra.chainId`, `accepts[].extra.facilitatorAddress` i `accepts[].extra.verifyingContract` będą uczestniczyć w podpisie danych typu EVM. * `upto` wymaga, aby portfel najpierw autoryzował USDC na docelowej sieci za pomocą Permit2; w przypadku braku autoryzacji zwróci `PERMIT2_ALLOWANCE_REQUIRED`. * Jeśli wyraźnie chcesz użyć rozliczenia na podstawie rzeczywistego zużycia, przekaż w TypeScript SDK `preferScheme: 'upto'`, w przeciwnym razie SDK wybierze pierwszy dostępny wymóg zwrócony przez serwer w danej sieci. ## Zakres publicznej weryfikacji Przed integracją można najpierw zweryfikować te publiczne punkty dostępu i zachowanie SDK: * Żądania API bez `Authorization` lub `PAYMENT-SIGNATURE` zwrócą `402 Payment Required`, a `accepts` w odpowiedzi jest jedyną podstawą podpisu dla tego żądania. * TypeScript SDK i Python SDK oferują handler płatności, warstwa transportowa SDK po otrzymaniu 402 wywoła handler i spróbuje ponownie. * `https://facilitator.acedata.cloud/.well-known/x402`: zwraca sieci, schematy i punkty końcowe protokołu wspierane przez Facilitatora; cena API nadal opiera się na 402 zwracanym w czasie rzeczywistym dla docelowego żądania. * `https://facilitator.acedata.cloud/supported`: zwraca sieci i schematy wspierane przez Facilitatora. * Repozytorium X402Client zawiera zaawansowane narzędzia do weryfikacji on-chain, które mogą być używane do potwierdzania podpisów, ponownych prób i zachowań rozliczeniowych; wyniki narzędzi nie zastępują zwracanych przez API `accepts`. `upto` należy do rozliczenia na podstawie rzeczywistego zużycia, odpowiedniego dla uzupełniania czatu, wywołań modelu i innych API, gdzie rzeczywiste zużycie jest znane dopiero po odpowiedzi. Obecnie tylko Base oferuje `upto`; jeśli weryfikacja podpisu nie powiedzie się, sprawdź, czy identyfikator sieci, adres ułatwiający, spender, kontrakt USDC i limit Permit2 są zgodne z odpowiedzią 402. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.