Подключение эквайринга Альфа-Банка к 1С: настройка и проверка

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

Большинство ошибок при подключении возникает не на этапе «ввести логин и пароль», а из-за несоответствия версий: конфигурация 1С слишком старая для актуальной библиотеки подключаемого оборудования (БПО), драйвер терминала не той разрядности, либо терминал работает в режиме, который конфигурация не поддерживает. Поэтому начинать стоит с проверки совместимости, а не с установки.

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

Что подготовить до начала настройки

До установки чего-либо в 1С соберите исходные данные. Для торгового эквайринга это: сам POS-терминал (Альфа-Банк обычно предоставляет Ingenico, Verifone или PAX), договор эквайринга с реквизитами терминала (TID — идентификатор терминала, MID — идентификатор торговой точки), драйвер от банка или производителя терминала. Для интернет-эквайринга — логин (merchant login) и пароль API из личного кабинета эквайринга Альфа-Банка, а также доступ к настройкам обратных уведомлений (callback).

Проверьте версию вашей конфигурации 1С. В типовых решениях (Розница, УТ 11, КА 2, ERP) работа с эквайринговыми терминалами реализована через «Библиотеку подключаемого оборудования» (БПО). Если конфигурация давно не обновлялась, актуальный драйвер может не заработать — обновите конфигурацию или хотя бы БПО до текущей версии. Платформа 1С должна соответствовать минимальным требованиям конфигурации.

Уточните у менеджера банка, в каком режиме работает терминал: «встроенный в кассу» (терминал управляется из 1С, операции инициируются кассиром из документа оплаты) или «автономный» (кассир набирает сумму на терминале вручную, а в 1С операция только отражается). Встроенный режим удобнее и исключает ошибки ввода суммы, но требует корректной настройки драйвера.

Выбор способа интеграции

Способ подключения зависит от того, где принимается оплата и какая конфигурация используется. Ниже сопоставлены основные варианты.

Если терминал и касса физически рядом, а кассир пробивает чеки в 1С — выбирайте встроенный режим через драйвер. Если касса работает на стороннем решении, а 1С используется только для учёта, достаточно автономного режима с загрузкой реестра операций. Интернет-эквайринг имеет смысл подключать через готовый модуль для вашей конфигурации или через доработку по документации API Альфа-Банка.

Маршрут решения

Как выбрать действие

Кассир пробивает чеки в 1С:Розница или УТ и терминал стоит рядом с кассойНастраивайте встроенный режим через драйвер и подсистему «Подключаемое оборудование»

Оплата принимается на сайте или по ссылке в мессенджереИспользуйте интернет-эквайринг: получите API-ключи и настройте обмен через модуль или обработку

Терминал уже работает автономно, а в 1С нужен только учётНастройте отражение эквайринговых операций документом «Операция по платёжной карте» и загрузку реестра

Подключение POS-терминала к 1С

Подключение выполняется в несколько шагов: физическое подключение терминала, установка драйвера, добавление оборудования в 1С и тест операции. Терминал подключается к компьютеру кассира по USB или работает по сети (Ethernet/Wi-Fi) — способ зависит от модели. Для сетевых терминалов зафиксируйте статический IP-адрес устройства, иначе после перезагрузки роутера 1С потеряет связь с терминалом.

Драйвер Альфа-Банк предоставляет через службу поддержки эквайринга или личный кабинет; часто используется драйвер производителя терминала с банковскими настройками. Устанавливайте драйвер той же разрядности, что и клиент 1С (32 или 64 бита) — несовпадение разрядности является одной из самых частых причин ошибки «Компонента не загружена».

1. 1
   Подключите терминал к компьютеру по USB или к локальной сети, убедитесь, что устройство включено и прошло загрузку
2. 2
   Установите драйвер терминала от Альфа-Банка или производителя, перезапустите сеанс 1С
3. 3
   В 1С откройте «Администрирование» → «Подключаемое оборудование» (в Рознице — раздел «Настройка оборудования»)
4. 4
   Добавьте новое оборудование типа «Эквайринговый терминал», выберите установленный драйвер из списка
5. 5
   Заполните параметры подключения: порт или IP-адрес, TID, параметры связи из документов банка
6. 6
   Нажмите «Тест устройства» — драйвер должен сообщить об успешном соединении с терминалом
7. 7
   Проведите тестовую оплату минимальной суммой из документа «Оплата платёжной картой» или чека ККМ
8. 8
   Выполните отмену (void) тестовой операции и сверку итогов, чтобы проверить оба сценария

Настройка в типовых конфигурациях

В 1С:Розница и УТ 11 эквайринговый терминал привязывается к кассе ККМ и к «Эквайрингу» в справочнике контрагентов: создаётся договор эквайринга с указанием банка-эквайера и комиссии. Это нужно, чтобы программа корректно рассчитывала суммы зачисления и формировала отчёт по эквайринговым операциям. Убедитесь, что в настройках кассы включён признак «Использовать эквайринговый терминал» и выбрано добавленное оборудование.

В конфигурациях на БСП (ERP, КА) логика аналогична: раздел «Настройка подключаемого оборудования», тип «Эквайринговые терминалы», затем привязка к кассе. Если в списке драйверов нет нужного, драйвер добавляется внешней компонентой через «Загрузить драйвер из файла» — файл предоставляет банк или производитель.

Подключение интернет-эквайринга Альфа-Банка

Интернет-эквайринг Альфа-Банка работает через REST API: 1С (или сайт, связанный с 1С) регистрирует заказ в системе банка, получает ссылку на платёжную страницу, покупатель оплачивает, а банк отправляет уведомление о результате. Учётные данные — логин вида «ваш_логин-api» и пароль — выдаются в личном кабинете эквайринга после заключения договора.

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

Типовой запрос регистрации заказа в API выглядит так (метод и адрес шлюза уточняйте в актуальной документации банка, они могут меняться):

POST https://pay.alfabank.ru/payment/rest/register.do
?userName=ВАШ_ЛОГИН
&password=ВАШ_ПАРОЛЬ
&orderNumber=ЗАКАЗ-001
&amount=10000
&returnUrl=https://ваш-сайт/success

Сумма в API передаётся в копейках (10000 = 100,00 ₽) — ошибка в этом месте приводит к счетам в сто раз больше или меньше. После оплаты настройте в личном кабинете банка адрес callback-уведомлений, чтобы 1С или сайт автоматически получали подтверждение платежа, а не полагались на то, что покупатель вернётся на страницу успеха.

Отражение эквайринговых операций в учёте

Независимо от способа подключения, в учёте оплата картой отражается документом «Операция по платёжной карте» (в Рознице — автоматически при пробитии чека с оплатой картой). Деньги на расчётный счёт поступают за минусом комиссии банка, обычно на следующий рабочий день. В бухгалтерском учёте используется счёт 57 «Переводы в пути»: оплата картой — Дт 57 Кт 62 (или 90), зачисление на счёт — Дт 51 Кт 57, комиссия — Дт 91 (или 44) Кт 57.

В конце рабочего дня на терминале выполняется сверка итогов (закрытие дня эквайринга). Во встроенном режиме операция запускается из 1С, в автономном — кассиром на терминале. Пропуск сверки итогов может задержать зачисление средств и привести к расхождениям между данными 1С и реестром банка. Ежедневно сверяйте сумму эквайринговых операций в 1С с отчётом банка или выпиской.

Контрольные точки

Как проверить результат

Тест устройства в настройках оборудования

Норма

Драйвер сообщает об успешном соединении с терминалом

Тревожный признак

Ошибка «Компонента не загружена» или «Устройство не найдено» — проверяйте разрядность драйвера и подключение

Тестовая оплата из чека или документа оплаты

Норма

Терминал запрашивает карту, печатает слип, в 1С создаётся операция оплаты

Тревожный признак

1С падает с ошибкой связи или сумма на терминале отличается от суммы в документе

Отмена (void) тестовой операции

Норма

Операция отменяется, в 1С фиксируется отмена, деньги не списываются

Тревожный признак

Отмена недоступна — возможно, терминал в автономном режиме или неверные параметры

Сверка итогов и выписка

Норма

Сумма по терминалу совпадает с суммой операций в 1С и реестром банка

Тревожный признак

Расхождения — ищите незавершённые операции или ручные операции мимо 1С

Типичные ошибки и их устранение

Наиболее частые проблемы связаны с окружением, а не с самим эквайрингом. Ниже — ситуации, с которыми сталкиваются чаще всего, и способы их решения.

Если терминал встроен в кассу, но при оплате из чека возникает ошибка связи, проверьте последовательно: включён ли терминал и не «завис» ли он на экране меню (вернитесь на главный экран), занят ли COM-порт другой программой, не обновилась ли Windows с заменой драйвера USB-устройства. После обновлений Windows и 1С тест устройства стоит повторять в обязательном порядке.

Если интернет-эквайринг отклоняет карты покупателей, убедитесь, что в личном кабинете включены нужные способы оплаты (3-D Secure, сохранённые карты, СБП), а заказ не дублируется: API банка не позволяет регистрировать два заказа с одним номером — при повторной отправке используйте новый номер заказа или проверяйте статус существующего.

Перед массовым запуском проведите полный цикл на одной кассе: оплата, частичный возврат, полный возврат, отмена до закрытия дня и сверка итогов. Именно возвраты чаще всего выявляют недонастройки, которые не видны на простой оплате.

Ограничения и когда нужна помощь специалиста

Самостоятельно без глубокой доработки подключаются: POS-терминал в типовой конфигурации с актуальной БПО и автономный терминал с ручным отражением операций. Помощь программиста 1С потребуется, если нужна интеграция интернет-эквайринга по API в нетиповую или сильно доработанную конфигурацию, двухстадийные платежи (предавторизация с последующим списанием), рекуррентные (регулярные) платежи или разделение платежей между несколькими юрлицами.

Учтите ограничения: один терминал обычно привязан к одному договору эквайринга и одному юрлицу; возврат по карте возможен только на ту же карту и, как правило, в пределах суммы исходной операции; комиссию и сроки зачисления определяет договор с банком, а не настройки 1С. По вопросам комиссий, лимитов и смены реквизитов обращайтесь в поддержку эквайринга Альфа-Банка — эти параметры в 1С не меняются.

Частые вопросы

Можно ли подключить терминал Альфа-Банка к 1С без договора эквайринга?

Нет. Терминал и доступ к API выдаются только после заключения договора эквайринга с банком: банк регистрирует вашу торговую точку (MID) и терминал (TID) в платёжных системах. Без этих реквизитов ни терминал, ни интернет-эквайринг работать не будут.

Подходит ли один терминал для нескольких касс 1С?

Один POS-терминал физически работает с одним рабочим местом кассира. Если касс несколько, на каждую нужен свой терминал (или сетевой терминал, к которому кассы обращаются по очереди, но такой сценарий поддерживается не всеми драйверами и создаёт очереди в час пик). Для интернет-эквайринга один договор может обслуживать несколько точек приёмов платежей — уточните у банка.

Почему в 1С нет кнопки «Оплатить картой» в чеке?

Чаще всего не настроена связка кассы с эквайринговым терминалом: проверьте, что оборудование добавлено и проходит тест, в настройках кассы ККМ включено использование эквайрингового терминала, а в справочнике создан договор эквайринга с банком. После перезапуска сеанса 1С вид оплаты «Платёжная карта» станет доступен.

Как сделать возврат по карте через 1С?

Возврат оформляется документом «Возврат оплаты платёжной карты» (или чеком возврата в Рознице) со ссылкой на исходную операцию. Во встроенном режиме 1С передаёт команду на терминал автоматически; покупателю нужно предъявить ту же карту. Возврат возможен в пределах суммы исходной операции, а срок зачисления денег покупателю зависит от банка-эмитента карты.

Можно ли принимать оплату по СБП через Альфа-Банк в 1С?

Да, если в договоре с банком подключена оплата через Систему быстрых платежей. На кассе терминал или кассовая программа формирует QR-код, покупатель сканирует его приложением своего банка. В 1С такая оплата отражается аналогично эквайринговой операции; поддержка зависит от версии конфигурации и драйвера, поэтому предварительно проверьте сценарий на тестовой продаже.

Что делать, если после обновления 1С терминал перестал работать?

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