С чего начать
Прямая интеграция с API АТОЛ Pay Ecom и АТОЛ Онлайн v5 - четыре шага. С ИИ-ассистентом или своими руками.
Этот портал - для тех, кто делает прямую интеграцию по API: готовый плагин или платежная кнопка не подходят, код пишется на своей стороне. Документацию можно отдать ИИ-ассистенту через MCP - или читать самим. Путь один: четыре шага, одна развилка по фискализации, проверка в песочнице. Меняется только то, кто открывает справочники.
Магазин на CMS? Разработка не нужна
Для Tilda, 1С-Битрикс, Битрикс24, WooCommerce, OpenCart, CS-Cart и Drupal есть готовые модули АТОЛ Pay: установите модуль и укажите токен. Ссылки на скачивание и пошаговые инструкции - в разделе готовые модули CMS.
Одна запись в конфиге Claude, Cursor или VS Code - ассистент читает методы, поля и ошибки за вас и пишет код под ваш проект.
Своими рукамиЭтот портал, Swagger и готовые примеры на Node.js, Python, PHP и curl. На каждом шаге быстрого старта - что писать и куда смотреть.
Путь интеграции
Выберите, как будете работать
Документация одна. Разница - кто ее читает.
С ассистентом. Одна запись в конфиге - и он получает доступ ко всей документации этого портала: методам, полям, кодам ошибок, рецептам. См. конфиги подключения.
Своими руками. Ассистент не нужен. Держите под рукой примеры АТОЛ Pay и контракт платежей - это ваш рабочий стол на шагах 3–4. Карта страниц - в быстром старте.
Решите, нужна ли вам своя фискализация
Это единственная развилка, которую нужно пройти человеку: от нее зависит, делаете вы одну интеграцию или две. Ассистент ее за вас не закроет.
АТОЛ Pay Ecom. Чеки не нужны либо их пробивает АТОЛ Pay сам - из блока
receipt в запросе платежа. Один API, один callback.
АТОЛ Pay Ecom + АТОЛ Онлайн v5. Нужны маркировка, авансы, частичные отгрузки или чеки коррекции - чеки вы отправляете сами.
Подробное сравнение с таблицей и правилом выбора - сквозные кейсы использования.
Получите доступы и соберите интеграцию
Заведите кабинет на lk.atolpay.ru, запросите доступ в тестовую среду и сгенерируйте API-токен. Кабинет за вас не откроет ни ассистент, ни эта документация.
Дальше расходится:
- С ассистентом. Опишите задачу словами: язык и фреймворк, сценарий
оплаты, нужны ли чеки. Он сам возьмет план интеграции (
start_integration), готовые рецепты (get_recipe) и описания методов - и напишет код под ваш проект. См. примеры промптов. - Своими руками. Минимальный контур - регистрация платежа, редирект на
paymentUrls.main, обработчик callback и опрос статуса как fallback. Эталонные запросы - в примерах, порядок кусков кода - в быстром старте.
Проверьте результат в песочнице
Тестовая среда повторяет контракт боевой: платежи проходят по тестовым картам, деньги не списываются. Убедитесь, что платеж создается, callback приходит и статус меняется, - и только после этого переключайте адреса на боевые.
Ассистент создаст тестовый платеж сам; без него первый запрос - curl из быстрого старта. Тестовые карты и оба контура - на странице тестовых данных.
Пройти путь по шагам, с деталями
Справочники к шагам
Полное описание методов, полей и кодов ошибок, сверенное с официальной документацией АТОЛ. Ассистент читает их за вас; если идете сами - это ваши основные страницы, а не приложение к диалогу. Открывайте, когда нужно перепроверить ответ модели или разобрать ошибку руками.
Платежная страница, одностадийные и двухстадийные платежи, СБП, подписки, возвраты, чеки и callback-уведомления.
API АТОЛ Онлайн v5 - фискализация (ФФД 1.2)Удаленная регистрация чеков на арендованных кассах по 54-ФЗ: авторизация, регистрация документов, получение результатов обработки.
Информация о ККТ и ФНМониторинг арендованных касс: состояние фискального накопителя, наполненность, сроки замены, ошибки сети.
Инструменты MCP-сервераЧто именно ассистент вызывает на шагах 3–4: планы интеграции, рецепты, валидация чеков, живые вызовы API.
Оплата в точке продаж - на смарт-терминалах и пинпадах АТОЛ, без интеграции по API: Торговый эквайринг.
Как связаны продукты
Типовая связка для интернет-магазина:
- АТОЛ Pay Ecom принимает оплату на платежной странице (карта, СБП,
Т-Pay) - вы регистрируете платеж одним запросом
POST /v1/ecom/paymentsи перенаправляете покупателя по полученномуdata.paymentUrls.main. - Если при регистрации платежа передан блок
receipt, чек автоматически фискализируется через провайдера АТОЛ Онлайн (providerId: 100). - АТОЛ Онлайн v5 можно использовать и напрямую - если вы сами управляете очередью чеков на арендованных ККТ (приход, возврат, коррекция и т.д.).
- Сервис информации о ККТ и ФН позволяет мониторить состояние касс: наполненность фискального накопителя, неотправленные документы, срок замены ФН.