Установка

Для начало необходимо установить модуль “PDF-документы“ от cs-cart, который необходим для корректной работы нашего модуля. Данный модуль входит в стандартный пакет модулей от cs-cart.

После скачивания модуля, его установка производится штатными средствами CS-Cart, на странице Панель администратора → Модули → Скачанные модули → Кнопка Шестеренка → Ручная установка (Для версии CS-Cart более 4.18.1)

Нажимаем Загрузить, в появившемся окне выбираем файл модуля, далее Загрузить и установить.

Настройка

Необходимую информацию по настройке модуля вы также можете найти на странице Панель администратора → Модули → Скачанные модули → Номинальные счета Точка Банк → Настройки → Дополнительная информация в настройках модуля

После установки, переходим в его настройки. Для этого выполняем следующие действия: Панель администратора → Модули → Скачанные модули → Номинальные счета Точка Банк → Настройки и выполняем следующие действия:

1. Для начала работы с модулем необходимо отправить заявку в Точка Банк с текстом:

   “Прошу предоставить доступ на тестовый и препрод слои. Доступ до api точки сервиса cyclops c ip-адреса: 00.00.00.00”

   Вместо “00.00.00.00” в заявке необходимо указать свой ip-адрес.

2. После того как доступ будет предоставлен, необходимо сгенерировать ключи. Для этого выполняем следующие шаги:

   1. В блоке ‘Ключи’ активируем чекбоксы:

      • Показывать приватные ключи - отвечает за отображение приватных ключей и сертификата в настройках способа оплаты с процессором “MS: Точка банк”. Также добавляет в настройки модуля, в блок "Ключи", два поля: "Публичный ключ" и "Приватный ключ" (недоступные для редактирования), а также кнопку "Генерировать ключи", необходимую для генерации ключей в указанных полях.

        

      • Разрешить редактирование ключей - включает возможность редактирования полям с ключами в настройках способа оплаты "MS: Точка банк", а также в настройках модуля в блоке "Ключи" для полей "Публичный ключ", "Приватный ключ".

        

   2. Заполняем поле "Идентификатор площадки" значением, которое предоставит Точка Банк после того, как мы сообщим им название нашей площадки, и после этого они создадут его индикатор, который, скорее всего, будет соответствовать названию площадки.

      

   3. Нажимаем кнопку “Генерировать ключи”, которая автоматически сгенерирует значения полей:

      • Отпечаток ключа - значение должно совпадать с тем, что выдаётся каждой площадке.
      • Публичный ключ - ключ, который содержится в файле rsaacert.pem(необходимый для Точка банка) и генерируется при нажатии на кнопку “Генерировать ключи”.
      • Приватный ключ - ключ, который генерируется при нажатии на кнопку “Генерировать ключи“.

Никому не показывайте значение в поле “Приватный ключ“.

Нажимаем кнопку “Сохранить”

4. В блоке “Ключи” после сохранения появится ссылка 'rsaacert.pem'. При нажатии на неё произойдёт загрузка файла, который необходимо передать сотрудникам Точка Банка.

   

5. После передачи файла сотрудникам Точка Банка вы получите информацию, содержащую отпечаток ключа. Этот отпечаток должен совпадать со значением в поле “Отпечаток ключа”.

   Если отпечаток ключа, переданный сотрудниками банка, не совпадает со значением в поле “Отпечаток ключа” в настройках, выполните следующие действия:

   1. Удалите значения из полей “Отпечаток ключа”, “Публичный ключ”, “Приватный ключ”.
   2. Нажимаем кнопку “Сохранить”
   3. Нажимаем появившуюся кнопку “Генерировать ключи” и жмем заново кнопку “Сохранить”
   4. Нажимаем на появившуюся ссылку 'rsaacert.pem' - произойдёт загрузка файла, который необходимо передать сотрудникам Точка Банка (действие аналогичное пункту ‘e’).
   5. Если отпечаток ключа, переданный сотрудниками банка, совпадает со значением в поле "Отпечаток ключа" в настройках — всё в порядке. Если нет — повторяем действия заново.

Действия, представленные выше, также актуальны, если вы по какой-то причине хотите обновить данные в полях 'Отпечаток ключа', 'Публичный ключ', 'Приватный ключ'.

6. После того как Точка Банк добавит сертификат (файл, отправленный ранее) в свою систему и создаст тестовый слой, станет доступна кнопка “Тест подключения” и другие функции модуля. Когда банк подтвердит готовность к проверке, нажимаем кнопку “Тест подключения”.

   Пример данных, которые вы можете получить в виде ответа от банка, представлены на странице 'Дополнительная информация' в настройках.

   

   Между кнопкой “Тест подключения” и ссылкой 'rsaacert.pem' должна появиться надпись 'OK' — это значит, что ключи прошли проверку и есть связь с банком. В противном случае появится надпись 'ERROR' — это значит, произошла какая-то ошибка с ключами или при подключении к банку.

7. Для того чтобы предотвратить случайное изменение полей “Публичный ключ”, “Приватный ключ”, отключаем чекбокс “Разрешить редактирование ключей” - тогда вы не сможете случайно изменить значения в полях. Также можно полностью скрыть поля “Публичный ключ”, “Приватный ключ” - для этого отключаем второй чекбокс “Показывать приватные ключи”.

   

8. В блоке “Другие настройки“ вы сможете найти дополнительные параметры для настройки работы модуля:

   

   • Статус для отменённого заказа - заказы, переведённые в этот статус, позволяют перечислить полную стоимость заказа как комиссию маркетплейса.

     

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

   • Включить логирование - чекбокс, при активации которого система будет записывать в лог все запросы, поступающие от Точка Банка в ответ на наши запросы.

   • Максимальный размер файла логов - параметр, определяющий предельный размер лог-файлов. Модуль создает два файла: при заполнении файлов происходит перезапись более старого.

9. После выполнения предыдущих пунктов можно эмулировать платеж с использованием тестовых данных. Для этого выполните следующие действия:

   

   1. Заполняем в блоке ‘Тестовые данные’ поля ‘Номинальный счёт площадки’, ‘Номинальный счёт плательщика‘, ‘БИК плательщика’ значениями, которые вам предоставят после отправки заявки в первом пункте, — это необходимо для тестирования площадки. Данные поля будут доступны после активации чекбокса Режим теста на странице Настройки → Общее.
   2. В поле "Сумма пополнения счёта" вводим сумму для эмуляции (например: 10 000).
   3. Нажимаем кнопку 'Эмулировать платёж'. При успешной операции система отобразит уведомление, что деньги были успешно отправлены на счет в указанном размере.

10. После выполнения всех предыдущих пунктов можно приступить к настройке бенефициаров (продавцов). Для этого переходим на страницу “Информация бенефициара“ в настройках модуля.

    

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

    1. Поля профиля в отдельной вкладке - если отмечено, поля, используемые для Точка Банка, будут отображаться в отдельной вкладке “Точка банк” в панели администратора при редактировании продавца. Например на странице Панель администратора → Продавцы→ Продавцы → CS-Cart

       

       

       Если чекбокс не отмечен, во вкладке “Точка Банк” будут отображаться только стандартные поля модуля:

       • Идентификатор бенефициара - это уникальный номер или код, присваиваемый бенефициарному владельцу в системе банка или реестре.
       • Документ по бенефициару - это подтверждающий документ, удостоверяющий статус или права бенефициара.

       Остальные поля профиля останутся на своих обычных позициях в интерфейсе.

       

    2. Деактивировать бенефициара - при смене статуса аккаунта продавца на "Выкл" его номинальный счет будет отключен, а все средства автоматически переведутся на привязанную карту (реальный счет), либо - если реальный счет не указан - на виртуальный счет площадки.

       Если чекбокс не отмечен, при деактивации продавца автоматическое отключение бенефициара в Точка Банк происходить не будет — вам потребуется вручную деактивировать продавца в системе банка.

    3. Статус при деактивации - если по какой-либо причине невозможно деактивировать бенефициара, система установит статус, который можно выбрать в данной настройке.

    4. ТБ: создать сделку - при запросе вывода средств в бухгалтерском учете система автоматически предлагает создать сделку в Точка Банке

    5. ТБ: создать сделку - при запросе вывода средств поле будет заблокировано.

    6. Активировать бенефициара - когда вы поменяете статус у аккаунта продавца на 'Вкл' его номинальный счет будет активирован (будет отправлен запрос на активацию бенефициара).

       Далее вам потребуется настроить поля для работы с бенефициарами. 

       Для начала необходимо для продавцов создать или включить требуемые поля профиля при отсутствии. Для этого выполняем следующие действия, переходим в Панель администратора → Настройки → Поля профиля → Информация о продавце.

       Добавляем следующие поля:

       1. Юридический тип

          • Тип: Список вариантов
          • Варианты:
            • J - Юр. лицо
            • I - ИП
            • F - Физ. лицо

       2. Полное наименование организации

          • Тип: Поле ввода

            Примечание: Можно активировать существующее поле

       3. ИНН (10 цифр)

          • Тип: Поле ввода

            Примечание: Можно активировать существующее поле

       4. КПП (9 цифр)

          • Тип: Поле ввода

       5. Имя

          • Тип: Поле ввода

            Примечание: Можно активировать существующее поле

       6. Фамилия

          • Тип: Поле ввода

            Примечание: Можно активировать существующее поле

       7. Отчество

          • Тип: Поле ввода

            Примечание: Можно активировать существующее поле

       8. Дата рождения

          • Тип: Дата

       9. Место рождения

          • Тип: Поле ввода

       10. Серия паспорта

           • Тип: Поле ввода

       11. Номер паспорта

           • Тип: Поле ввода

       12. Дата выдачи паспорта

           • Тип: Дата

       13. Адрес регистрации

           • Тип: Поле ввода или Текстовая область

             Примечание: Можно активировать существующее поле

       14. Резидент

           • Тип: Флажок

       15. БИК

           • Тип: Поле ввода

             Примечание: Можно активировать существующее поле

       16. Расчетный счет

           • Тип: Поле ввода

             Примечание: Можно активировать существующее поле

       Рекомендации:

       • Поля с пометкой "можно активировать существующее" не требуют создания новых
       • Для новых полей необходимо строго соблюдать указанные типы и форматы
       • Все поля должны быть доступны для выбора в соответствующем разделе настроек профиля

       На примере создания поля "Юридический тип" разберём последовательность действий:

       1. Нажимаем кнопку ‘Добавить поле‘.

          

       2. В открывшемся окне заполните поля следующим образом:

          • Название → введите "Юридический тип"

          • Код → укажите "legal_type"

          • Тип → выберите "Список вариантов" из доступных опций

            

       3. Далее перейдите во вкладку «Варианты» и добавьте три значения: J - Юр. лицо, I - ИП, F - Физ. лицо (как показано на изображении)

          

       4. Нажимаем кнопку ‘Сохранить‘.

       Проделываем аналогичные действия для остальных полей при их отсутствии:

       Далее возвращаемся к настройкам модуля:

       Для последующих полей, а именно: Поле с юридическим типом, Поле с полным наименованием организации, Поле с ИНН, Поле с КПП, Поле с именем, Поле с фамилией, Поле с отчеством, Поле с датой рождения, Поле с местом рождения, Поле с серией паспорта, Поле с номером паспорта, Поле с датой выдачи паспорта, Поле с адресом регистрации, Поле с признаком резидентства, Поле с БИК, Поле с номером расчетного счета - необходимо выбрать значения, которые мы только что создали, с соответствующими названиями, то есть:

       • для "Поле с юридическим типом" выбираем значение "Юридический тип",

       • для "Поле с ИНН" выбираем "ИНН",

       • для "Поле с КПП" выбираем "КПП",

         и так далее для всех остальных полей (как показано на изображении).

       

       

       

       Далее нажимаем кнопку “Сохранить”.

       Затем переходим во вкладку "Точка Банк" в панели администратора при редактировании необходимого продавца и проверяем, правильно ли отобразились только что созданные поля.

       

       

       Заполняем все поля продавца и нажимаем на кнопку “Сохранить”. После этого у продавца должно автоматически заполниться поле “Идентификатор бенефициара”. Если этого не произошло, проверьте правильность введенных данных и нажмите кнопку “Получить ID бенефициара”

       

       

       Далее нажимаем кнопку "Загрузить" в поле "Документ по бенефициару" и загружаем документ-оферту, по которому вы работаете с данным продавцом. После чего у вас отработает алгоритм и появятся два новых поля, заполненных автоматически: 

       1. Идентификационный номер документа - это идентификационный номер документа, который можно либо скачать, либо посмотреть данные: id, тип, номер и статус добавления в виде массива данных, нажав на ссылку «Получить информацию о документе».

          

       2. Виртуальный счет - это виртуальный счет, в котором можно посмотреть: виртуальный счет, данные бенефициара и транзакции, проведенные по данному счету, нажав на ссылку «Посмотреть виртуальный счет».

          

       Заполняем данные всех необходимых продавцов и повторяем действия, представленные выше, для получения Идентификатора бенефициара и Идентификационного номера документа. На этом настройка бенефициаров завершена.

11. Теперь рассмотрим работу модуля с платежами.

    Для начала переходим в Панель администратора → Настройки → Способ оплаты и выбираем способ оплаты, в котором мы хотим использовать систему Точка Банка, затем активируем чекбокс "Использовать с Точкой Банком".

    

    Затем переходим на страницу: Панель администратора → Заказы → Оплата Точка Банком.

    

    Здесь мы видим несколько блоков с информацией:

    1. Нераспределенная сумма - это сумма которая пришла с эквайринга в систему Точка банка но еще не распределилась по заказам.

       При переходе на страницу "Оплата Точка Банком" скрипт автоматически распределит всю сумму, представленную в данном блоке, начиная со самого старого заказа. Если суммы не хватит, то заказ будет частично распределен либо останется в ожидании. Данный статус вы сможете увидеть в самом правом столбце таблицы ниже.

       Статус, при котором сумма по заказам будет распределена, указывается на странице Панель администратора → Настройки → Статусы. Для этого переходим на данную страницу, выбираем статус заказа, при котором нужно выполнять распределение, и активируем чекбокс "ТБ: распределить средства".

       

    2. Вкладка "Нераспределенные заказы" - это таблица с заказами, которые были оплачены при помощи системы оплаты, в которой мы заранее активировали чекбокс "Использовать с Точкой Банком".

       

    3. Вкладка "Входящие платежи" - это таблица со всеми входящими платежами из Точка Банка. При нажатии на элемент в столбце ID платежа вы сможете увидеть всю информацию о платеже (если вы имеете права главного администратора).

       

       

    4. Вкладка "Исходящие платежи" - это таблица со всеми исходящими платежами в Точка Банк. При нажатии на элемент в столбце ID платежа вы также сможете увидеть всю информацию о платеже (если вы имеете права главного администратора).

       

       

    5. Вкладка "Сделки" - это сделки по заказам. При нажатии на элемент в столбце ID сделки вы увидите всю информацию о сделке: какие платежи были совершены, на какого продавца, документы и другие данные (если вы имеете права главного администратора).

    6. Кнопка "Распределить автоматически" - если в блоке "Нераспределенная сумма" значение не равно нулю и имеются новые заказы, то при нажатии на эту кнопку система автоматически распределит платежи.

       

12. Рассмотрим вариант, когда продавец хочет вывести средства на свой расчетный счет:

    1. Необходимо зайти от имени продавца

    2. Перейти в Инструменты продавца → Бухгалтерский учет, где он сможет увидеть следующие информационные блоки:

       

       • Текущий баланс - это счет продавца

       • Остаток на виртуальном счете - если у продавца есть заказы, которые еще не были переведены на виртуальный счет

       • Подтвержденная сумма - это сумма по заказам, которые уже перешли в статус, когда можно выплачивать продавцу.

         Статус, при котором сумма по заказам будет передана продавцу, указывается на странице Панель администратора → Настройки → Статусы. Для этого переходим на данную страницу, выбираем статус заказа и активируем чекбокс "ТБ: считать заказ выполненным".

         

       • Вкладка “Транзакции” - это таблица операций, проведенных с продавцом.

       • Вкладка “Вывод средств с баланса” - это раздел, где представлена таблица со статусами вывода средств на баланс.

         Можно раскрыть один из платежей и увидеть поле ID сделки. Если вывод средств был успешно проведён, то отобразится уникальный ID, который вы можете найти в таблице на странице Оплата Точка Банком во вкладке Сделки.

         

         Чтобы продавец мог запросить средства, необходимо нажать значок "+ Запросить вывод средств", ввести сумму в поле "Сумма платежа", активировать чекбокс “ТБ: создать сделку” чтобы использования текущую подтвержденную суммы или указать другую сумму (не превышающую подтвержденную), добавить комментарий и нажать кнопку "Создать”.

         

         После этого главный администратор должен перейти по пути Панель администратора → Продавцы → Бухгалтерский учет, затем открыть вкладку "Вывод средств с баланса", где будет отображен запрос продавца на вывод средств.

         

       • Чтобы подтвердить сделку, главный администратор должен нажать на ссылку в столбце "Статус" и выбрать пункт "Подтвержден". Если сделка не сможет выполниться через Точка Банк, статус автоматически изменится на "Отклонен"; в обратном случае — на "Подтвержден", средства будут переведены на счет продавца, а в сделке появится ссылка “ID сделки” для просмотра деталей операции.

         

    На этом настройка модуля завершена.