Как подключить АТОЛ Pay к 1С-Битрикс
Модуль АТОЛ Pay для интернет-магазина на 1С-Битрикс: загрузите архив, установите решение в Marketplace и добавьте платежную систему «Обработчик АТОЛ Pay».
Архив модуля - в центре загрузок АТОЛ или в Marketplace 1С-Битрикс
Что потребуется
- Подключенный интернет-эквайринг в личном кабинете АТОЛ Pay (lk.atolpay.ru)
- API-токен из раздела «Настройки > API Токены» личного кабинета
- 1С-Битрикс с ядром версии 16 или выше, редакция «Малый бизнес» или старше
- PHP 8.1
Установка и настройка
- 1
Загрузите и распакуйте архив
В «Контент > Структура сайта > Файлы и папки» откройте bitrix/modules, загрузите архив модуля и распакуйте его с заменой файлов - появится папка atol.pay.
- 2
Установите модуль
В «Marketplace > Установленные решения» найдите «Модуль платежей АТОЛ Pay» и в меню модуля нажмите «Установить».
- 3
Добавьте платежную систему
В «Магазин > Настройки > Платежные системы» добавьте платежную систему с обработчиком «АТОЛ Pay (atolpay)».
- 4
Укажите токен и параметры чека
Вставьте API-токен, включите передачу данных для чека, выберите систему налогообложения, признак способа и предмета расчета, ставку НДС.
- 5
Проверьте оплату в тестовом режиме
Включите тестовый режим и проведите платеж с токеном из тестового кабинета croc-sandbox-lk.atolpay.ru - доступ к нему выдают по запросу на 1@atol.ru. После проверки переключите модуль на боевую среду и боевой токен.
Фискализация чеков
Включите в настройках модуля передачу данных для чека и укажите систему налогообложения, ставку НДС и признак способа расчета. Чек «Приход» уйдет в АТОЛ Онлайн автоматически после оплаты, а чек «Возврат прихода» - при возврате. Отдельная интеграция с онлайн-кассой не нужна.
FAQ
Подключайтесь через платежную страницу по API - это один POST-запрос и редирект покупателя - или используйте платежные ссылки без разработки. Оба способа работают с любой платформой.
Да, sandbox подключается самостоятельно: зарегистрируйтесь в личном кабинете lk.atolpay.ru и выберите в меню «Перейти в sandbox». В тестовом кабинете уже подключены тестовые СБП и интернет-эквайринг без реальных денег; API-токен генерируется в разделе «Настройки > API Токены». API песочницы: croc-sandbox-api-mobile.atolpay.ru/v1/ecom/.
Если передавать блок receipt при регистрации платежа, чек автоматически фискализируется через провайдера АТОЛ Онлайн - отдельная интеграция с кассой не нужна. Для сложных сценариев (предоплата и зачет аванса, маркировка, агентские схемы) используется прямая интеграция с API АТОЛ Онлайн v5.
Подключение АТОЛ Pay
Подберем способ подключения, объясним условия и поможем пройти путь до первого платежа.