Подключение платёжной системы Assist

Assist (Ассист) — один из давних платёжных агрегаторов, который до сих пор встречается в проектах на 1С-Битрикс: приём карт, интернет-эквайринг, двухстадийные платежи и фискализация. Разберём подключение обработчика по шагам — от договора до боевого запуска.

Что такое Assist и когда его выбирают

Assist — платёжный агрегатор, который принимает оплату банковскими картами Visa, Mastercard и «Мир», а также через ряд альтернативных методов. В связке с 1С-Битрикс он работает по классической схеме редиректа: покупатель со страницы заказа перенаправляется на защищённый платёжный шлюз Assist, вводит данные карты там, а магазин получает уведомление о результате.

Модуль sale («Интернет-магазин») поставляется со встроенным обработчиком assist, поэтому дополнительных модулей из Marketplace ставить не нужно. Assist чаще выбирают там, где он уже был исторически подключён, где нужна двухстадийная оплата (авторизация с последующим списанием) или где банк-эквайер работает именно через этот процессинг.

Что подготовить до подключения

Настройка в админке займёт минуты, но она бессмысленна без реквизитов от процессинга. До начала работ соберите:

• Merchant_ID (идентификатор магазина) — выдаётся после заключения договора и активации личного кабинета Assist;
• доступ в личный кабинет Assist — там задаются URL возврата и адрес для уведомлений;
• согласованную валюту платежей (обычно RUB) — она должна совпадать с валютой заказа в Битрикс;
• решение по схеме списания: одностадийная (сразу списание) или двухстадийная (авторизация + подтверждение);
• данные для фискализации по 54-ФЗ, если чеки пробиваются на стороне Assist.

Проверьте, что домен магазина работает по https с валидным сертификатом: платёжный шлюз не примет возвраты на незащищённый адрес.

Создание платёжной системы в Битрикс

Все действия выполняются в административной части. Откройте раздел Магазин → Платёжные системы (страница sale_pay_system.php) и нажмите «Добавить платёжную систему».

1. В поле Обработчик выберите Assist из выпадающего списка.
2. Задайте служебное название и символьный код — они видны покупателю на шаге выбора оплаты.
3. Укажите, для каких типов плательщиков (физлицо, юрлицо) и площадок доступна система.
4. Перейдите на вкладку с настройками обработчика и заполните параметры значениями из личного кабинета Assist.

Настройки обработчика в Битрикс задаются через «бизнес-значения»: одно и то же поле можно связать со свойством заказа, константой или полем профиля. Для Assist большинство значений — константы (тип «Значение»), кроме суммы и номера заказа, которые система подставляет автоматически.

Ключевые параметры обработчика

Минимальный набор полей, без которых оплата не пройдёт, компактно сведён в таблицу.

При двухстадийной схеме дополнительно включается параметр отложенного списания: заказ сначала авторизуется (средства блокируются), а фактическое списание выполняется после подтверждения — например, при сборке заказа. Подтверждение и отмену авторизации инициируют из личного кабинета Assist или через его API.

Уведомления о статусе оплаты

Редиректа покупателя обратно на сайт недостаточно: клиент может закрыть вкладку, и заказ не отметится оплаченным. Достоверный источник статуса — серверное уведомление (callback), которое Assist отправляет напрямую на магазин.

В личном кабинете Assist в качестве адреса уведомлений и адресов возврата укажите страницы обработки Битрикс:

• URL уведомления / результата — служебный обработчик магазина, который принимает POST от Assist, проверяет подпись и переводит заказ в статус «Оплачен»;
• URL успеха — страница /personal/order/ или благодарности;
• URL отказа — возврат в корзину или на страницу заказа с сообщением об ошибке.

Корректный callback вызывает событие OnSalePaymentPaid, после чего срабатывают все привязанные к оплате сценарии: смена статуса, письмо покупателю, выгрузка в 1С. Именно поэтому «оплата на витрине прошла, а заказ не оплачен» — почти всегда проблема неправильного адреса уведомления, а не самого платежа.

Тестовый режим и приёмка

Перед боевым запуском переведите платёжную систему в тестовый режим — обработчик направит платежи на тестовый контур Assist, где списания не происходит. Прогоните полный сценарий:

1. оформите заказ на витрине и выберите оплату Assist;
2. убедитесь, что на шлюз ушли корректные Merchant_ID, сумма и номер заказа;
3. оплатите тестовой картой из документации Assist;
4. проверьте, что заказ в админке автоматически стал «Оплачен» после уведомления;
5. повторите сценарий с отменой оплаты и убедитесь, что заказ остался неоплаченным.

Типичные ошибки и диагностика

Большинство инцидентов повторяются от проекта к проекту. Сначала проверьте очевидное:

• Заказ не отмечается оплаченным. Неверный или недоступный URL уведомления, либо магазин закрыт basic-авторизацией/файрволом — Assist не может достучаться до callback.
• Расхождение суммы. Валюта платёжной системы не совпадает с валютой заказа, или включена комиссия, не учтённая в цене.
• Неверная подпись. Merchant_ID или секретные параметры перепутаны между тестовым и боевым контуром.
• Редирект на http. Возврат настроен на незащищённый адрес — шлюз его отклоняет.

Для разбора используйте журнал заказа и историю событий Assist в личном кабинете: там видно, какой запрос ушёл и какой ответ вернулся. В Битрикс включите протоколирование в настройках платёжной системы — оно фиксирует входящие уведомления и помогает поймать момент, где рвётся цепочка.

Итог

Подключение Assist к 1С-Битрикс сводится к трём вещам: создать платёжную систему на встроенном обработчике assist, аккуратно перенести Merchant_ID и параметры из личного кабинета и настроить серверное уведомление, которое переводит заказ в статус «Оплачен». Тестовый контур и полная приёмка — обязательный шаг перед боевым запуском.

Если нужно подключить Assist «под ключ», связать оплату с выгрузкой заказов в 1С или разобрать нестандартный сценарий с двухстадийными платежами и фискализацией — мы помогаем с интеграцией платёжных систем и последующим сопровождением магазина на Битрикс.