Инструкция к модулю Точка Банк Эквайринг

Что делает модуль

Модуль подключает интернет-магазин CS-Cart к интернет-эквайрингу банка «Точка». Покупатель оформляет заказ, выбирает способ оплаты с процессором «Точка Банк Эквайринг» и переходит на платёжную страницу банка. После оплаты модуль получает результат платежа, обновляет статус заказа по заданному сопоставлению и сохраняет данные операции в админке.

Модуль также поддерживает работу с платёжными операциями: просмотр истории, проверку статуса платежа, отмену, подтверждение списания для холдированных платежей и возвраты. Для фискализации можно включить передачу чеков в DigitalKassa.

Где находится модуль

• Модули → Управление модулями → Точка банк эквайринг — общие настройки модуля и сопоставление статусов заказа.
• Администрирование → Способы оплаты — создание или настройка способа оплаты с процессором «Точка Банк Эквайринг».
• Заказы → Просмотр заказов → карточка заказа — данные платежа, фискальные данные и действия по операции: подтверждение, отмена, возврат.
• Администрирование → Точка банк → Операции — журнал операций модуля с фильтрами по заказу, payment ID, статусу, типу операции и датам, если пункт меню доступен в вашей сборке.

Подготовка в личном кабинете банка

Перед настройкой в CS-Cart получите в банке «Точка» данные для интернет-эквайринга:

• customerCode — код клиента. Его можно ввести вручную или подставить кнопкой Из списка (Business) после сохранения API-токена.
• merchantId — идентификатор магазина. Его можно ввести вручную или подставить кнопкой Из списка (REG, активен). Для подбора merchantId сначала должен быть указан customerCode.
• Client ID — идентификатор клиента для API банка. Поле рекомендуется заполнить для корректной работы интеграции.
• Токен API — токен авторизации для запросов к API банка.
• Секретный ключ webhook — ключ для проверки подписи уведомлений от банка.

Если планируется фискализация через DigitalKassa, дополнительно подготовьте actor, token, group ID и при необходимости секрет подписи webhook DigitalKassa.

Настройка способа оплаты

1. Откройте Администрирование → Способы оплаты и создайте или откройте способ оплаты для банка «Точка».
2. В поле процессора выберите Точка Банк Эквайринг.
3. Перейдите к параметрам процессора и заполните основные поля.

Основные параметры процессора

• Режим тестирования — включает работу с тестовым окружением банка. Используйте его для проверки интеграции без реальных списаний.
• Код клиента (customerCode) — код клиента банка «Точка».
• ID магазина (merchantId) — идентификатор магазина в системе банка. Обычно это числовой идентификатор, выданный банком.
• Client ID — идентификатор клиента для API банка.
• Токен API — токен авторизации для создания платежей, проверки статусов и выполнения операций.
• Секретный ключ webhook — используется для проверки подписи входящих уведомлений от банка.
• Валюта — валюта платежей. Для российских платежей обычно используется RUB.
• Режим оплаты — одностадийная оплата или двухстадийный сценарий с холдированием. Важно: режим холдирования определяется настройками мерчанта на стороне банка; модуль умеет подтвердить холдированный платёж отдельной операцией capture.
• Способы оплаты — доступные методы на платёжной стороне: банковская карта, СБП, Tinkoff, Долями. Если ничего не выбрано, по умолчанию используется карта.

Webhook банка

В настройках способа оплаты модуль показывает готовый URL для webhook уведомлений. Скопируйте его и укажите в личном кабинете банка «Точка» для уведомлений по платежам.

Webhook нужен, чтобы модуль мог автоматически получить итоговый статус платежа, проверить подпись уведомления, обновить заказ и зафиксировать событие в журнале. Если секретный ключ webhook не заполнен, проверка подписи не сможет защитить входящее уведомление.

Сопоставление статусов заказа

В настройках модуля задайте, в какой статус CS-Cart переводить заказ при успешной и неуспешной оплате:

• Успешно — статус для оплаченных заказов. По умолчанию используется открытый статус заказа.
• Неуспешно — статус для отклонённых или отменённых платежей. По умолчанию используется неуспешный статус.

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

Фискализация и DigitalKassa

Если нужно отправлять чеки, включите параметр Отправлять чек для 54-ФЗ и заполните фискальные параметры:

• Система налогообложения — ОСН, УСН, патент и другие поддерживаемые варианты.
• Ставка НДС по умолчанию — применяется к товарам без отдельной ставки.
• Признак способа расчёта — например полный расчёт, предоплата 100%, аванс или кредит.
• Признак предмета расчёта — товар или услуга.

Для передачи чеков в DigitalKassa включите Включить отправку чеков в DigitalKassa и заполните:

• Actor (DigitalKassa) — идентификатор актора.
• Token (DigitalKassa) — токен авторизации.
• ID группы DigitalKassa — идентификатор группы касс.
• Система налогообложения DigitalKassa — используется при формировании чека.

После успешной оплаты модуль может отправить чек в DigitalKassa и сохранить фискальные данные в заказе. Если настройки DigitalKassa включены, в параметрах способа оплаты доступна кнопка тестовой отправки чека.

Как проходит оплата

1. Покупатель оформляет заказ и выбирает способ оплаты «Точка Банк Эквайринг».
2. Модуль проверяет обязательные параметры: customerCode, merchantId и API token.
3. Модуль создаёт платёж в API банка и передаёт сумму, валюту, номер заказа, ссылку возврата и выбранные способы оплаты.
4. Если включена передача чека, к запросу добавляются фискальные данные.
5. Покупатель перенаправляется на платёжную страницу банка.
6. После оплаты модуль получает редирект или webhook, проверяет статус платежа через API и обновляет заказ.

Операции в карточке заказа

После создания платежа в заказе сохраняется payment ID. В карточке заказа отображаются платёжные и фискальные данные, а также доступные действия:

• Подтвердить списание — используется для подтверждения холдированного платежа.
• Отменить платёж — отменяет платёж, если операция поддерживается банком для текущего статуса.
• Полный или частичный возврат — создаёт возврат по payment ID.
• Все операции — открывает журнал операций, связанных с платежом.

Доступность действий зависит от статуса платежа, настроек банка и ответа API.

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

1. Включите тестовый режим в настройках процессора, если проверка должна пройти без реального списания.
2. Убедитесь, что заполнены customerCode, merchantId, API token и webhook secret.
3. Сохраните способ оплаты и скопируйте webhook URL в личный кабинет банка.
4. Создайте тестовый заказ на витрине и выберите оплату через банк «Точка».
5. Проверьте, что покупатель перенаправляется на платёжную страницу банка.
6. Завершите тестовую оплату и убедитесь, что заказ получил статус из сопоставления.
7. Откройте карточку заказа и проверьте payment ID, статус операции и фискальные данные.
8. Проверьте журнал операций и, если доступно, журнал webhook-уведомлений.
9. Если используется холдирование, выполните подтверждение списания и проверьте результат.
10. Если используются возвраты, выполните тестовый полный или частичный возврат.
11. Если включена DigitalKassa, проверьте отправку тестового чека и появление данных чека в заказе.

Если оплата не проходит

• Проверьте, что customerCode, merchantId и API token заполнены без лишних пробелов.
• Убедитесь, что выбран правильный режим: тестовый или боевой.
• Проверьте, что в банке активирован интернет-эквайринг для нужного merchantId.
• Сверьте webhook URL и секретный ключ webhook в настройках банка и CS-Cart.
• Проверьте журнал операций: в нём сохраняются запросы, ответы, статусы и ошибки API.
• Если чек не отправляется, отдельно проверьте настройки DigitalKassa: actor, token, group ID и систему налогообложения.