Перейти к основному контенту

Платежи: 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 уведомлений конкретного магазина.