> ## 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 Интеграционное руководство > Platform API guide - Ace Data Cloud X402 — это протокол платежей на блокчейне, основанный на HTTP `402 Payment Required`. С помощью возможностей X402 от Ace Data Cloud вызывающая сторона может осуществлять цепочечные платежи в USDC без создания API Token и предварительной пополнения баланса счета при каждом API запросе. Этот набор документов организован в порядке реальной интеграции: сначала выполните минимальный запрос, затем интегрируйте SDK, после этого изучите сеть, тарифные планы, оплату заказов и Facilitator. Рекомендуется читать по таблице сверху вниз. | Учебник | Подходящий сценарий | Ссылка | | - | - | - | | Быстрый старт | Сначала поймите процесс 402, `accepts` и `PAYMENT-SIGNATURE` с минимальным запросом | [X402 Быстрый старт](https://platform.acedata.cloud/documents/x402-quickstart) | | TypeScript SDK | Вызов API Ace Data Cloud в браузере, Node.js или фронтенд-приложениях | [Интеграция TypeScript SDK](https://platform.acedata.cloud/documents/x402-typescript-sdk) | | Python SDK | Вызов API в Python-сервисах, скриптах, Agent или потоках данных | [Интеграция Python SDK](https://platform.acedata.cloud/documents/x402-python-sdk) | | Оплата заказов | Оплата заказов в консоли Ace Data Cloud с помощью X402 | [Учебник по оплате заказов](https://platform.acedata.cloud/documents/x402-order-payment) | | Сеть и способы оплаты | Узнайте об активах, подписях и подходящих сценариях для Base, SKALE, Solana | [Сеть и способы оплаты](https://platform.acedata.cloud/documents/x402-networks) | | `exact` и `upto` | Различие между API с фиксированной ценой и API с постоплатой | [Описание тарифного плана](https://platform.acedata.cloud/documents/x402-metered-upto) | | Описание цен | Узнайте о связи цен X402 и единичной стоимости Credits, а также о реальных ценах на услуги | [Описание цен X402](https://platform.acedata.cloud/documents/x402-pricing) | | Facilitator | Понимание связи между `verify`, `settle` и собственным API для приема платежей | [Интеграция Facilitator](https://platform.acedata.cloud/documents/x402-facilitator) | | E2E и устранение неполадок | Проверка публичных входов, запуск инструментов для продвинутой проверки, выявление распространенных проблем 402, подписей и расчетов | [E2E проверка и устранение неполадок](https://platform.acedata.cloud/documents/x402-e2e-troubleshooting) | ## Рекомендуемый путь интеграции Если вы просто хотите вызывать API Ace Data Cloud, сначала используйте официальные SDK: * TypeScript: `@acedatacloud/sdk` + `@acedatacloud/x402-client` * Python: `acedatacloud` + `acedatacloud-x402` Публичные репозитории и адреса пакетов: | Проект | Адрес | | - | - | | 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 автоматически выполнит первый запрос без аутентификации, обработает `402 Payment Required`, вызовет обработчик платежей и повторит эти шаги с `PAYMENT-SIGNATURE`. Вам нужно только подготовить кошелек с USDC и выбрать желаемую сеть. Если вы хотите, чтобы ваш API также поддерживал прием платежей X402, вам необходимо прочитать документацию Facilitator, чтобы понять связь между `paymentRequirements`, `paymentPayload`, `/verify` и `/settle`. ## Статус поддержки Ace Data Cloud X402 прошел верификацию в публичном API, официальных SDK, Facilitator и цепочечных расчетах. В таблице ниже обобщены текущие состояния по наиболее часто используемым возможностям при интеграции разработчиков. | Возможность | Статус | Описание | | - | - | - | | Возможности Facilitator | Доступно | `https://facilitator.acedata.cloud/.well-known/x402` возвращает платежные сети и конечные точки протокола. | | API 402 `accepts` | Доступно | Неплатежные запросы возвращают доступные требования к платежам для Base, SKALE и Solana. | | TypeScript SDK | Доступно | `@acedatacloud/sdk` и `@acedatacloud/x402-client` могут автоматически обрабатывать 402, подписи и повторные попытки. | | Python SDK | Доступно | `acedatacloud` и `acedatacloud-x402` могут автоматически обрабатывать 402, подписи и повторные попытки. | | Base `exact` | Подтверждено на блокчейне | Подходит для API с фиксированной суммой и оплаты заказов. | | Base `upto` | Подтверждено на блокчейне | Подходит для API с постоплатой, таких как дополнение чата; в настоящее время единственная сеть, предлагающая `upto`. | | SKALE `exact` | Подтверждено на блокчейне | Подходит для сценариев платежей EVM с низкими затратами на газ. | | Solana `exact` | HTTP paid retry подтверждено | Подтверждено, что API paid retry соответствует модели ответа; для подтверждения подписи на блокчейне рекомендуется использовать собственный Solana RPC для сверки. | | Оплата заказов | Подтверждено на блокчейне | Оплата заказов Base `exact` завершена на блокчейне и обновила статус заказа. | Следующий вывод предназначен только для иллюстрации формата возвращаемых данных по проверенным путям. При фактической интеграции всегда ориентируйтесь на текущие `accepts`, возвращаемые API. ```text theme={null} пакеты @acedatacloud/sdk@2026.504.2 импорт успешно @acedatacloud/x402-client@2026.531.3 импорт успешно acedatacloud==2026.4.26.1 импорт успешно acedatacloud-x402==2026.5.31.3 импорт успешно API 402 статус 402 принимает eip155:8453/exact, eip155:8453/upto, solana:5eykt4.../exact, eip155:1187947933/exact TypeScript SDK содержимое ADC_TS_SDK_X402_OK Python SDK содержимое ADC_PY_SDK_X402_OK Base exact содержимое ADC_BASE_E2E_OK tx 0x408430ab3451bc22a51e510cdb4b063d6b9686724fea7a31fc109af20f5cd2f3 эксплорер https://basescan.org/tx/0x408430ab3451bc22a51e510cdb4b063d6b9686724fea7a31fc109af20f5cd2f3 SKALE exact содержимое ADC_SKALE_E2E_OK tx 0x9fd09901e74c763325fe118b2bc64765c3fca785b86b24a78b97964384db084f эксплорер https://skale-base-explorer.skalenodes.com/tx/0x9fd09901e74c763325fe118b2bc64765c3fca785b86b24a78b97964384db084f Base upto содержимое ADC_BASE_UPTO_OK tx 0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036 эксплорер https://basescan.org/tx/0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036 подписанный лимит 95215 атомных USDC значение перевода 3 атомных USDC Solana exact HTTP 402 -> HTTP 200 содержимое ADC_SOLANA_E2E_OK подпись цепочки не подтверждена в этом запуске Оплата заказа заказ 78481793-304e-47f7-bc0c-8231aec9cc1e состояние Завершено способ_оплаты X402 tx 0xfec08cc00a159ea1ec692b32faa9bf3d17595a986301169e689d94f58bc44151 эксплорер https://basescan.org/tx/0xfec08cc00a159ea1ec692b32faa9bf3d17595a986301169e689d94f58bc44151 ``` 说明： * npm и PyPI пакеты успешно установлены и импортированы в чистой среде. * Неоплаченный API запрос возвращает 402, `принимает` включает доступные способы оплаты для Base, SKALE и Solana. * `принимает[].сеть` является CAIP-2 идентификатором, при выборе сети клиентом необходимо соответствовать строке CAIP-2. * TypeScript SDK и Python SDK могут автоматически обрабатывать 402 и завершать повторную попытку оплаты. * Base `exact`, SKALE `exact`, Base `upto` и оплата заказа имеют открытые адреса для эксплорации. * Лимит подписи для Base `upto` составляет `95215` атомных USDC, фактическое расчетное значение составляет `3` атомных USDC, что отражает характеристику постфактумного расчета по фактическому использованию. * Solana `exact` подтвердил HTTP 402 -> HTTP 200 и вывод модели. Поскольку публичные RPC запросы могут быть ограничены, для строгой сверки рекомендуется использовать собственный Solana RPC или записи расчетов на стороне платформы для подтверждения подписи транзакции. ## Важные моменты при подключении При подключении разработчики должны в первую очередь обращать внимание на текущие требования к оплате, возвращаемые запросом, а не копировать примерные суммы или адреса из документации: * `принимает[].максимальнаяСуммаТребуется` — это максимальная сумма, которую можно подписать в текущем запросе. * `принимает[].актив` — это контракт или mint USDC, который будет использоваться в этом запросе. * `принимает[].дополнительно.chainId`, `принимает[].дополнительно.facilitatorAddress` и `принимает[].дополнительно.verifyingContract` будут участвовать в подписании EVM typed data. * `upto` требует, чтобы кошелек сначала предоставил разрешение Permit2 для целевой цепочки USDC; при отсутствии разрешения будет возвращено `PERMIT2_ALLOWANCE_REQUIRED`. * Если вы явно хотите использовать постфактумный расчет, передайте `preferScheme: 'upto'` в TypeScript SDK, в противном случае SDK выберет первый доступный требование, возвращенное сервером в этой сети. ## Область, которую можно публично проверить Перед подключением можно проверить эти публичные точки входа и поведение SDK: * API запросы без `Authorization` или `PAYMENT-SIGNATURE` вернут `402 Payment Required`, а `принимает` в ответе является единственным основанием для подписи этого запроса. * TypeScript SDK и Python SDK предоставляют обработчик платежей, уровень передачи SDK вызовет обработчик и повторит попытку после получения 402. * `https://facilitator.acedata.cloud/.well-known/x402`: возвращает поддерживаемые сети, схемы и конечные точки протокола Facilitator; цена API по-прежнему определяется 402, возвращаемым в реальном времени для целевого запроса. * `https://facilitator.acedata.cloud/supported`: возвращает поддерживаемые сети и схемы Facilitator. * Репозиторий X402Client содержит инструменты для высокоуровневой проверки на цепочке, которые могут использоваться для подтверждения подписей, повторных попыток и расчетного поведения; вывод инструментов не заменяет `принимает`, возвращаемый онлайн API. `upto` относится к постфактумному расчету, подходит для API, где фактическое использование, такое как дополнение чата или вызовы модели, становится известным только после ответа. В настоящее время только Base предоставляет `upto`; если проверка подписи не удалась, проверьте, соответствует ли идентификатор цепочки, адрес посредника, spender, контракт USDC и разрешение Permit2 ответу 402. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.