Точка Банк Эквайринг: Инструкция

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

Модуль «Точка Банк Эквайринг» подключает интернет-магазин к эквайрингу Точка Банка и автоматически обрабатывает оплату заказов через платежный шлюз банка.

Установка

1. Загрузите модуль в папку addons вашего магазина.
2. Откройте Модули → Управление модулями.
3. Найдите «Точка Банк Эквайринг» и нажмите Установить.

Включение модуля

1. Убедитесь, что статус модуля — Вкл..

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

Настройка выполняется через способ оплаты: Администрирование → Способы оплаты. Создайте или откройте способ оплаты с процессором «Точка Банк Эквайринг».

Настройка модуля: Основные параметры

После создания способа оплаты «Точка Банк Эквайринг» перейдите на вкладку Настроить (или аналогичную, например, «Параметры») в параметрах этого способа оплаты. Там вам станут доступны поля для ввода данных, полученных от Точка Банка:

• API Key (Ключ API): Уникальный ключ для аутентификации в системе Точка Банка. Получается в личном кабинете Точка Банка после регистрации эквайринга.
• Shop ID (ID магазина): Идентификатор вашего магазина в системе Точка Банка. Также предоставляется банком.
• Test mode (Тестовый режим): Опция для включения/отключения тестового режима работы эквайринга. Используйте для проверки интеграции без реальных транзакций.
• Customer Code (Код клиента): Идентификатор клиента, используемый Точка Банком.
• Merchant ID (ID продавца): Идентификатор продавца в системе Точка Банка.
• Client ID (ID клиента): Идентификатор клиента для OAuth авторизации.
• API Token (Токен API): Дополнительный токен для доступа к API.
• Webhook Secret (Секретный ключ для проверки подписи webhook уведомлений от банка): Этот ключ используется для верификации подлинности уведомлений, поступающих от Точка Банка. Получается в личном кабинете Точка Банка.
• Currency (Валюта): Валюта платежей, принимаемых через данный способ оплаты. Должна соответствовать валюте вашего магазина.
• Payment Mode (Режим оплаты): Определяет, как будет происходить списание средств (например, одностадийная или двухстадийная оплата, когда средства сначала блокируются, а затем списываются).
• Payment Methods (Методы оплаты): Выберите доступные методы оплаты (например, банковские карты, СБП).
• Send Receipt (Отправлять чек): Включить или отключить автоматическую отправку чеков (для 54-ФЗ).
• Tax System (Система налогообложения): Укажите вашу систему налогообложения для фискализации чеков (например, ОСН, УСН Доходы, УСН Доходы минус расходы).
• Default Tax Rate (Ставка НДС по умолчанию): Ставка налога, применяемая по умолчанию к товарам и доставке, если не указана иная.
• Payment Method (Метод оплаты для чека): Метод оплаты, который будет указан в фискальном чеке (например, «Электронными средствами»).
• Payment Object (Предмет расчета для чека): Предмет расчета, который будет указан в фискальном чеке (например, «Товар», «Услуга»).

Настройка модуля: Фискализация DigitalKassa / 54-ФЗ

Для автоматической фискализации чеков через сервис DigitalKassa настройте следующие параметры:

• DigitalKassa Enabled (Включить DigitalKassa): Активируйте эту опцию для использования DigitalKassa.
• DigitalKassa Actor (Идентификатор актора DigitalKassa): Уникальный идентификатор актора в системе DigitalKassa.
• DigitalKassa Token (Токен DigitalKassa): API-токен для авторизации в DigitalKassa.
• DigitalKassa Group ID (ID группы DigitalKassa): Идентификатор группы для DigitalKassa.
• DigitalKassa SNO (Система налогообложения DigitalKassa): Укажите систему налогообложения, если она отличается от основной.

Рекомендуется провести тестовую отправку чека через DigitalKassa для проверки корректности настроек.

Webhook / Callback сценарий

Для корректной обработки статусов платежей и автоматического обновления заказов необходимо настроить уведомления (webhook) в личном кабинете Точка Банка. Используйте следующий URL для получения уведомлений:

[Ваш_домен]/app/addons/ms_tochka/callback.php

Замените [Ваш_домен] на доменное имя вашего магазина. Убедитесь, что этот URL доступен извне.

Как проверить обработку уведомлений:

1. После проведения тестовой оплаты в Точка Банке проверьте логи вашего сервера или модуля (если предусмотрено), чтобы убедиться, что уведомление от банка было получено и обработано.
2. Удостоверьтесь, что статус заказа в CS-Cart обновился корректно.

Операции в карточке заказа (Возвраты и Подтверждение холдирования)

После успешной оплаты в карточке заказа (Заказы → Просмотр заказов → [Выбранный заказ]) появятся дополнительные данные и кнопки для управления платежом:

• Статусы платежа: Отображается текущий статус операции (например, «Оплачен», «Холдирован»).
• ID платежа: Уникальный идентификатор транзакции в системе Точка Банка.
• Фискальные данные: Информация о фискализации чека (если используется DigitalKassa).
• История операций: Детальная информация обо всех действиях, связанных с платежом.
• Возврат средств (Refund): Если платеж был успешно проведен, появится кнопка для частичного или полного возврата средств. Используйте её, если необходимо отменить или вернуть оплату покупателю.
• Подтверждение холдирования (Capture): Если в настройках был выбран двухстадийный режим оплаты (холдирование), появится кнопка для подтверждения списания заблокированных средств. Это завершает транзакцию и списывает деньги с карты покупателя.

Важно: Все действия по возврату и подтверждению холдирования будут отображены в истории операций заказа.

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

1. Создайте тестовый заказ на витрине.
2. Выберите способ оплаты «Точка Банк Эквайринг».
3. Завершите тестовую оплату.
4. Проверьте, что статус заказа изменился в соответствии с вашим сопоставлением.
5. В личном кабинете Точка Банка убедитесь, что тестовая транзакция зарегистрирована.
6. Если активирован тестовый режим фискализации, проверьте, что тестовый чек отправлен и доступен в DigitalKassa.
7. Проверьте раздел «Операции» в карточке тестового заказа на наличие всех данных (ID платежа, статусы).
8. Если настроено холдирование, подтвердите платеж и убедитесь в списании.
9. Попробуйте сделать возврат средств для тестового заказа.

Полезно знать

• Перед запуском убедитесь, что эквайринг в Точка Банке активирован и магазин подключен.
• После обновлений модуля проверяйте корректность сопоставления статусов.
• Для получения API-ключей и Shop ID свяжитесь со службой поддержки Точка Банка или найдите информацию в вашем личном кабинете.