Перейти к содержимому

С чего начать

Прямая интеграция с API АТОЛ Pay Ecom и АТОЛ Онлайн v5 - четыре шага. С ИИ-ассистентом или своими руками.

Этот портал - для тех, кто делает прямую интеграцию по API: готовый плагин или платежная кнопка не подходят, код пишется на своей стороне. Документацию можно отдать ИИ-ассистенту через MCP - или читать самим. Путь один: четыре шага, одна развилка по фискализации, проверка в песочнице. Меняется только то, кто открывает справочники.

Магазин на CMS? Разработка не нужна

Для Tilda, 1С-Битрикс, Битрикс24, WooCommerce, OpenCart, CS-Cart и Drupal есть готовые модули АТОЛ Pay: установите модуль и укажите токен. Ссылки на скачивание и пошаговые инструкции - в разделе готовые модули CMS.

Путь интеграции

Выберите, как будете работать

Документация одна. Разница - кто ее читает.

С ассистентом. Одна запись в конфиге - и он получает доступ ко всей документации этого портала: методам, полям, кодам ошибок, рецептам. См. конфиги подключения.

Своими руками. Ассистент не нужен. Держите под рукой примеры АТОЛ Pay и контракт платежей - это ваш рабочий стол на шагах 3–4. Карта страниц - в быстром старте.

Решите, нужна ли вам своя фискализация

Это единственная развилка, которую нужно пройти человеку: от нее зависит, делаете вы одну интеграцию или две. Ассистент ее за вас не закроет.

Подробное сравнение с таблицей и правилом выбора - сквозные кейсы использования.

Получите доступы и соберите интеграцию

Заведите кабинет на lk.atolpay.ru, запросите доступ в тестовую среду и сгенерируйте API-токен. Кабинет за вас не откроет ни ассистент, ни эта документация.

Дальше расходится:

  • С ассистентом. Опишите задачу словами: язык и фреймворк, сценарий оплаты, нужны ли чеки. Он сам возьмет план интеграции (start_integration), готовые рецепты (get_recipe) и описания методов - и напишет код под ваш проект. См. примеры промптов.
  • Своими руками. Минимальный контур - регистрация платежа, редирект на paymentUrls.main, обработчик callback и опрос статуса как fallback. Эталонные запросы - в примерах, порядок кусков кода - в быстром старте.

Проверьте результат в песочнице

Тестовая среда повторяет контракт боевой: платежи проходят по тестовым картам, деньги не списываются. Убедитесь, что платеж создается, callback приходит и статус меняется, - и только после этого переключайте адреса на боевые.

Ассистент создаст тестовый платеж сам; без него первый запрос - curl из быстрого старта. Тестовые карты и оба контура - на странице тестовых данных.

Пройти путь по шагам, с деталями

Справочники к шагам

Полное описание методов, полей и кодов ошибок, сверенное с официальной документацией АТОЛ. Ассистент читает их за вас; если идете сами - это ваши основные страницы, а не приложение к диалогу. Открывайте, когда нужно перепроверить ответ модели или разобрать ошибку руками.

Оплата в точке продаж - на смарт-терминалах и пинпадах АТОЛ, без интеграции по API: Торговый эквайринг.

Как связаны продукты

Типовая связка для интернет-магазина:

  1. АТОЛ Pay Ecom принимает оплату на платежной странице (карта, СБП, Т-Pay) - вы регистрируете платеж одним запросом POST /v1/ecom/payments и перенаправляете покупателя по полученному data.paymentUrls.main.
  2. Если при регистрации платежа передан блок receipt, чек автоматически фискализируется через провайдера АТОЛ Онлайн (providerId: 100).
  3. АТОЛ Онлайн v5 можно использовать и напрямую - если вы сами управляете очередью чеков на арендованных ККТ (приход, возврат, коррекция и т.д.).
  4. Сервис информации о ККТ и ФН позволяет мониторить состояние касс: наполненность фискального накопителя, неотправленные документы, срок замены ФН.