Помощь
Выберите, куда обратиться: личный кабинет, документация или поддержка.
Личный кабинет
Платежи, возвраты, настройки заказов и API-токены - lk.atolpay.ru.
Документация API
Методы, сценарии оплаты, коды ошибок и примеры на четырех языках.
Телефон
8 800 505-47-47 - звонок по России бесплатный.
Почта
pay@atol.ru - вопросы по подключению и работе сервиса.
Доступ к тестовой среде (sandbox): подключается самостоятельно - пункт меню «Перейти в sandbox» в личном кабинете lk.atolpay.ru. Разработчикам - обзор API.
FAQ
АТОЛ Pay - сервис приема платежей экосистемы АТОЛ. Он принимает оплату банковской картой, через СБП и T-Pay на готовой платежной странице и умеет автоматически отправлять чеки в АТОЛ Онлайн - фискализация по 54-ФЗ происходит в том же процессе, что и оплата.
Юридические лица и ИП, зарегистрированные в РФ. Для подключения нужен доступ в личный кабинет lk.atolpay.ru и онбординг в одном из банков-партнеров: Альфа-Банк, Т-Банк или Газпромбанк.
Подключение занимает от 15 минут - все оформляется онлайн. Регистрация в личном кабинете занимает несколько минут, дальше - анкета выбранного банка. Документов минимум: для ООО достаточно паспорта руководителя.
Нет. Платежные ссылки позволяют принимать оплату без сайта: вы создаете платеж, получаете ссылку на платежную страницу и отправляете ее клиенту в мессенджере, письме или счете.
Если передавать блок receipt при регистрации платежа, чек автоматически фискализируется через провайдера АТОЛ Онлайн - отдельная интеграция с кассой не нужна. Для сложных сценариев (предоплата и зачет аванса, маркировка, агентские схемы) используется прямая интеграция с API АТОЛ Онлайн v5.
Торговый эквайринг - прием безналичной оплаты в офлайн-точке: покупатель платит картой, смартфоном или по QR-коду на терминале у кассы. Интернет-эквайринг работает на сайте, в приложении и по ссылке - без терминала. В АТОЛ Pay оба вида подключаются в одном личном кабинете.
Если кассы еще нет, подойдет смарт-терминал АТОЛ СТБ 6: касса и эквайринг в одном устройстве, чек печатается сразу после оплаты. Если касса уже есть, к ней подключается пинпад АТОЛ ПТ-2 - он работает с любым кассовым ПО и принимает карты, QR СБП и оплату частями.
Альфа-Банк, Т-Банк, ВТБ и Точка. Ставку каждого банка для вашей категории бизнеса показывает калькулятор на странице, а итоговые условия банк подтверждает после рассмотрения заявки.
Банковская карта (Мир, Visa, Mastercard), Система быстрых платежей (оплата из приложения любого банка - участника СБП) и оплата через мобильное приложение банка T-Pay.
Сначала средства замораживаются на счете покупателя (холдирование), затем списываются отдельным запросом. Пока средства заморожены, платеж можно отменить без комиссии - удобно, когда нужно подтвердить наличие товара перед списанием.
Возвраты и отмены - полные и частичные - выполняются через API или личный кабинет. Если чек по платежу был фискализирован автоматически, чек «Возврат прихода» тоже сформируется автоматически.
Да. Карта привязывается к идентификатору покупателя buyerId, после чего доступна оплата в один клик без повторного ввода реквизитов.
Да. Интернет-эквайринг АТОЛ Pay подключают ИП и юрлица, зарегистрированные в РФ: нужен расчетный счет и анкета банка-партнера в личном кабинете. Отдельных тарифов для ИП нет - комиссия 0,5–2,9 % зависит от вида деятельности и оборота, подключение бесплатное, запуск занимает от 15 минут.
Платежная страница - готовая страница оплаты, на которую сайт или приложение перенаправляет покупателя по ссылке paymentUrl. Покупатель выбирает карту, СБП или T-Pay и платит, а 3-D Secure, антифрод и возврат на ваш сайт уже настроены на стороне АТОЛ Pay.
Создайте платеж в личном кабинете или запросом POST /v1/ecom/payments с суммой и номером заказа. В ответе придет paymentUrl - это и есть ссылка на оплату. Отправьте ее клиенту в мессенджере, письме или SMS: он заплатит картой, через СБП или T-Pay, а вы получите уведомление об оплате.
В своей платежной форме данные карты вводятся на вашем сайте, а 3-D Secure, проверку на мошенничество и новые способы оплаты приходится встраивать самим. На платежной странице АТОЛ Pay покупатель вводит данные карты на стороне сервиса, проверки проходят там же, а вашему сайту остается зарегистрировать платеж и обработать уведомление.
Банковская карта, СБП и T-Pay - из тех, что подключены в личном кабинете. Если набор одинаков для всех заказов, задайте его в разделе «Настройки > Настройки заказов»: тогда способы меняются без правок в коде. Если набор зависит от заказа, передайте массив paymentMethods при регистрации платежа.
3-D Secure - подтверждение оплаты картой кодом на странице банка, который выпустил карту. На платежной странице проверку проводит АТОЛ Pay: при необходимости он перенаправляет покупателя к банку за кодом. Если авторизация не прошла, статус 12 означает, что оплату можно повторить, а статус 3 - что заказ нужно зарегистрировать заново.
Да, это двухстадийная оплата: передайте sessionType: twoStep при регистрации платежа. После оплаты на платежной странице сумма блокируется на счете покупателя - это холдирование средств. Списание запросите не позднее чем через 7 суток методом deposit или кнопкой «Провести списание» в личном кабинете, иначе заморозка истечет. Пока средства заморожены, платеж можно отменить без комиссии.
Да. Передайте buyerId - идентификатор покупателя в вашей системе - при регистрации платежа. После успешной оплаты карта сохранится, и ее можно использовать для оплаты в один клик и рекуррентных списаний. Список карт запрашивают по buyerId, а привязку удаляют, когда покупатель отвязывает карту в вашем сервисе.
АТОЛ Pay показывает страницу с результатом оплаты и кнопкой «Вернуться в магазин» - она ведет на returnUrl из запроса регистрации платежа. Статус ваш сервер получает отдельно: уведомление type: payment приходит на notificationUrl, а если оно задержалось, статус можно запросить методом GET /v1/ecom/payments/{orderId}/status.
Банковской картой, через СБП - из приложения любого банка-участника - и через приложение T-Pay. Все подключенные способы собраны на одной платежной странице, а набор задают в настройках личного кабинета или в запросе платежа.
Онлайн-оплаты в АТОЛ Pay проводят Альфа-Банк, Т-Банк и Газпромбанк. Банк выбирают при подключении и заполняют его анкету в личном кабинете.
Комиссия - 0,5–2,9 %: ставка зависит от вида деятельности (MCC-кода) и оборота и удерживается только с успешных платежей. Подключение и обслуживание бесплатны, абонентской платы нет. Точную ставку вы увидите при заполнении заявки на подключение.
Отправьте запрос POST /v1/ecom/payments/{orderId}/cancel или оформите операцию в личном кабинете - вернуть можно всю сумму или часть. Одностадийный платеж в день оплаты отменяется, в другие дни по нему проходит возврат. Если платеж был с чеком, чек «Возврат прихода» сформируется автоматически.
Не больше 7 суток после оплаты: за это время вызовите метод deposit или нажмите «Провести списание» в личном кабинете. Автоматически деньги не списываются - если не запросить списание, заморозка истечет.
Платеж все равно проводится: ошибка фискализации не отменяет транзакцию. Результат отправки чека приходит отдельным уведомлением type=fiscal - по нему видно, ушел ли чек в АТОЛ Онлайн.
При регистрации платежа вы передаете блок receipt с позициями заказа. После успешной оплаты АТОЛ Pay сам отправляет чек «Приход» в АТОЛ Онлайн (providerId 100), а при возврате - чек «Возврат прихода». Вы получаете уведомление type=fiscal с идентификатором чека.
Если между оплатой и передачей товара проходит время (чек предоплаты и чек зачета аванса), нужна маркировка (ФФД 1.2, mark_code), полные агентские схемы или чеки коррекции - фискализируйте напрямую через API АТОЛ Онлайн v5, а АТОЛ Pay используйте только для приема денег.
АТОЛ Онлайн v5 работает по ФФД 1.2. Версия ФФД и данные фискализации настраиваются в личном кабинете АТОЛ Pay в разделе «Провайдер чеков».
Формирование чеков - 1,5 % с каждой операции. Подключение бесплатное, абонентской платы нет. Отдельно оплачивается интернет-эквайринг АТОЛ Pay для приема платежей: его тариф зависит от вида деятельности и оборота. Точную стоимость под ваш бизнес рассчитает менеджер при подключении.
Сервис формирует чеки по онлайн-платежам, принятым через АТОЛ Pay, - оплатам картой и через СБП. По ним чек создает касса платежного агента. Если у вас есть и другие расчеты - наличные, оплата на месте, платежи через другого провайдера, - при подключении подскажем, как оформлять чеки по ним.
Задача сервиса - сформировать кассовый чек и отправить его покупателю. Все остальное в цепочке работает как обычно: чек формирует касса платежного агента с собственным фискальным накопителем, а данные в налоговую передает оператор фискальных данных. АТОЛ Чеки пользуются этой цепочкой, а не заменяют ее.
Сервис работает по агентской схеме: организация выступает платежным агентом с собственной кассой - формирует кассовый чек с признаком агента и передает данные в ФНС через ОФД в соответствии с 54-ФЗ и 161-ФЗ.
В чеке указываются ваши реквизиты как поставщика товара или услуги и признак агента - АТОЛ Pay. Это принципиальный момент: именно благодаря признаку агента выручка по чеку относится к вам, а не к нам, и у вас остаются корректные фискальные документы, подтверждающие доход.
АТОЛ Чеки работают в связке с интернет-эквайрингом АТОЛ Pay - оплата и формирование чека происходят в одном решении. Это позволяет формировать чеки автоматически и без ручной сверки платежей.
Фискализируются все онлайн-платежи, принятые через АТОЛ Pay, - оплаты банковскими картами и через СБП. На каждую из них автоматически формируется кассовый чек.
Кассовый чек отправляется покупателю автоматически: на электронную почту, указанную при оплате, либо по номеру телефона. Дополнительно чек доступен через оператора фискальных данных (ОФД).
При возврате формируется отдельный кассовый чек с признаком «возврат прихода» - он так же автоматически уходит покупателю и в ФНС через ОФД.
Ограничений нет. Сервис одинаково подходит и небольшому проекту с редкими продажами, и растущему бизнесу с большим потоком оплат: оборот, количество чеков и число платежей ничем не лимитированы.
Сервис работает со всеми основными системами: ОСН, УСН («доходы» и «доходы минус расходы»), ПСН и ЕСХН. Вы указываете свою систему при подключении, и она автоматически проставляется в каждом чеке - вручную настраивать ничего не нужно.
До одного рабочего дня. Нужно зарегистрироваться в АТОЛ Pay, создать магазин и активировать сервис АТОЛ Чеки. После активации чеки формируются автоматически.
Облачная касса - онлайн-касса, которая работает в дата-центре оператора: чеки по интернет-оплатам формируются и передаются в ОФД без оборудования в офисе. Для платежей через АТОЛ Pay эту роль выполняет АТОЛ Онлайн - касса арендуется в сервисе, а чек уходит автоматически после оплаты.
Агентский чек - кассовый чек с признаком агента: его формирует касса платежного агента, а в чеке указаны реквизиты поставщика товара или услуги. Покупатель получает чек по 54-ФЗ, а выручка по нему относится к продавцу, а не к агенту.
Если покупатель платит сейчас, а товар получает позже, по 54-ФЗ это два фискальных события. В момент оплаты пробивают чек «Предоплата 100%», при передаче товара - чек «Полный расчет» с зачетом аванса: внесенную предоплату указывают видом оплаты 2 - «предварительная оплата, зачет аванса». Такие чеки ваш бэкенд отправляет напрямую в АТОЛ Онлайн v5, а платеж в АТОЛ Pay регистрируют без блока receipt.
Если платеж зарегистрирован с блоком receipt, при его отмене или возврате АТОЛ Pay сам отправляет в АТОЛ Онлайн чек «Возврат прихода» и присылает уведомление type=fiscal с receiptType sell_refund. При прямой интеграции чек возврата прихода пробивают операцией sell_refund: сумма равна возвращаемым позициям, а вид оплаты - тот же, которым платил покупатель.
Чек коррекции исправляет расчет, проведенный без кассы или с ошибкой, например если чек не пробился при сбое. В АТОЛ Онлайн v5 его регистрируют операциями sell_correction, buy_correction и их возвратами, а в correction_info указывают тип: self - ошибку нашли вы, instruction - коррекция по предписанию налогового органа. По платежу с блоком receipt АТОЛ Pay чеки коррекции не формирует, они доступны только в прямой интеграции.
Коды маркировки передают по ФФД 1.2 в прямой интеграции с АТОЛ Онлайн v5 - в блоке receipt платежа АТОЛ Pay их нет. В позиции указывают payment_object 33 (маркируемый товар с кодом маркировки), mark_processing_mode "0", planned_status и объект mark_code; код gs1m передают целиком в Base64. Результат проверки приходит в marks_result: значение 15 означает, что проверка пройдена.
Оплата не отменяется: если платеж прошел, а при фискализации возникла ошибка, транзакция все равно проведена. Результат приходит в уведомлении type=fiscal - при status: fail в нем есть errorCode и errorMessage. Отслеживайте такие уведомления: по ним видно, по каким заказам чек не сформирован.