Платежи: TBank, ЮKassa, Evotor и Aqsi
Для кого эта инструкция
Инструкция для администратора, который подключает эквайринг или кассовые точки школы. После настройки сервис можно выбрать в операциях оплаты, а для ЮKassa — передать ей URL уведомлений DoCRM.
Где находится
Нажмите шестерёнку внизу левого меню → «Общие настройки» → найдите карточку «Настройки платежей». Карандаш в правом верхнем углу карточки открывает общие параметры платежей. Для TBank, ЮKassa, Evotor и Aqsi используйте карандаш рядом с названием соответствующего блока внутри этой карточки.
Что нужно перед началом
Подготовьте данные от сервиса: идентификатор терминала или магазина, API-ключ, токен, пароль и параметры налогообложения, если их запрашивает форма. Для настроек платежей нужна возможность роли «Устанавливать настройки школы».
Не вставляйте ключи в название конфигурации. Название видно в DoCRM и должно помогать отличать точки оплаты, а секреты остаются только в предназначенных для них полях.
Настройте TBank
В блоке «TBank: Подключенные эквайринги» нажмите карандаш → в окне «Редактирование TBank эквайринга» нажмите «Добавить эквайринг». В новом блоке заполните:
- «Адреса» — если терминал относится не ко всей школе;
- «Имя конфигурации»;
- «Система налогообложения», «Ставка налога» и «Версия ФФД»;
- «Идентификатор терминала», «Пароль» и «Токен».
Нажмите «Сохранить». Чтобы изменить или удалить точку, вернитесь в то же окно; для удаления используйте «Удалить эквайринг» и затем сохраните изменения.
Настройте ЮKassa и URL уведомлений
В блоке «YouKassa: Подключенные эквайринги» нажмите карандаш → «Редактирование ЮКасса эквайринга» → «Добавить эквайринг». Заполните «Адреса», «Имя конфигурации», «ShopId» и «Токен», затем нажмите «Сохранить».
После сохранения вернитесь в карточку «Настройки платежей». У нужной конфигурации появится строка «YooKassa: Webhook для …» с URL вида https://***.docrm.org/api/PaymentApi/PaymentNotificationYooKassa?id=…, где *** — поддомен вашей школы. Скопируйте именно URL нужной конфигурации в настройки уведомлений ЮKassa.
Важно: для нескольких магазинов ЮKassa у каждого эквайринга свой URL с отдельным идентификатором. Не подменяйте его общим URL из нижней части карточки.
Настройте Aqsi
В блоке «Aqsi: Точки оплаты» нажмите карандаш → «Редактирование Aqsi эквайрингов» → «Добавить терминал». Для терминала заполните «Api Ключ», «Адреса», «Айди терминала», «Имя терминала» и «Тип терминала». В типе доступны «Касса», «Терминал» и «Магазин».
Сохраните изменения. При оплате DoCRM показывает только те точки Aqsi, которые доступны по выбранному адресу клиента; если подходящей точки нет, оплату через Aqsi завершить нельзя.
Проверьте уже подключённый Evotor
Если в карточке присутствует блок «Evotor: Точки оплаты», нажмите карандаш рядом с его заголовком. В окне «Редактирование Evotor точек оплаты» можно изменить «Название» и «CashboxId» каждой точки, добавить ещё одну точку или удалить существующую, после чего нажать «Сохранить».
Важно: в рассмотренном экране DoCRM кнопка открытия редактора Evotor появляется только при уже существующей точке. Для первоначального подключения, если блока нет, не создавайте произвольную конфигурацию через другой сервис — уточните способ подключения у команды, которая обслуживает Evotor.
Настройте общие параметры платежей
В карточке «Настройки платежей» нажмите верхний карандаш. В окне «Редактирование настроек платежей» можно изменить «Название товара в чеке» и список «Типы платежей».
Для ручного типа нажмите «Добавить», укажите название и нажмите «Сохранить». У существующего типа можно отправить его «В архив» или вернуть «Из архива». По иконке настроек открывается окно «Настройки типа платежей», где переключателями задаются «Начислять бонусные баллы клиенту» и «Начислять бонус продавцу».
Системные типы платежей, используемые DoCRM, нельзя переименовать; их можно только архивировать. Перед архивированием убедитесь, что тип не нужен сотрудникам при приёме оплат.
Готово: подключённые эквайринги и кассовые точки отображаются в карточке «Настройки платежей», а для ЮKassa скопирован URL уведомлений конкретного магазина.