.. meta:: :description: Customers Management в UI менеджера SBC: модуль для проектирования пользовательских платёжных процессов, адаптированных под конкретные бизнес-процессы торговца. .. _customer_management: Customers Management #################### .. role:: ex .. role:: code Введение ============ Customer Management - is a module which allows to set custom payment flow. It is located at Settings -> Customers management. This screen contains the list of all Merchants in the system tat are connected to Customers Management. | .. image:: ../_static/images/CMStotal.png :width: 700 :align: center :alt: pic107 manager faq | На этом экране можно выполнить поиск по торговцам или добавить нового торговца (конфигурацию) в модуль управления клиентами, нажав :code:`Add new` в правом верхнем углу экрана. Adding New Merchant To Customer Management ========================================== После нажатия кнопки :code:`Добавить новую` появится этот экран: | .. image:: ../_static/images/CMSnewMerchant1.png :width: 500 :align: center :alt: pic107 manager faq | .. image:: ../_static/images/CMSnewMerchant2.png :width: 500 :align: center :alt: pic107 manager faq | Сначала выберите Торговца в поле :code:`Merchant`, который будет подключён к системе Customer Management. | Затем выберите один из режимов работы: :code:`CRM(API)` или :code:`Платёжный Шлюз`. - :code:`CRM(API)` позволяет определять клиента по :ex:`merchant customer id`. Если параметр :ex:`customer level` присутствует в вызовах API, создаются ненастроенные уровни. - :code:`Платёжный Шлюз` — позволяет определить клиента по внутреннему :ex:`идентификатору клиента`. | В поведении по умолчанию выберите :code:`Проект` или :code:`Неизвестный уровень`. - :code:`Project` — если в вызовах API присутствует ненастроенный уровень клиента, будут использованы настройки Project и Endpoint (:code:`Client definition`). - :code:`Unknown Level` — если в вызовах API присутствует ненастроенный уровень клиента, будут использованы настройки уровня Unknown. .. warning:: Любая неправильная настройка может привести к остановке обработки платежей. | После выбора :code:`Operation mode` и :code:`Default behaviour` (по желанию) выберите один из вариантов или оба: - Сбрасывать индивидуальные настройки платежей при изменении уровня клиента. - Автоматически добавить все проекты торговца на уровень Unknown | После добавления торговца в Customer Management можно редактировать или удалить конфигурацию. CRM ------------------------------ :code:`CRM (API)` — позволяет определить клиента по :ex:`идентификатору клиента торговца`. | Параметры, используемые в конфигурации :code:`CRM`: - :ex:`merchant_customer_identifier` - :ex:`customer_level` .. warning:: customer_id не должен включаться в запрос. .. uml:: :align: center title CRM operation mode start :(1) Receiving [merchant_customer_identifier] and [customer_level] from Connecting Party; if ( (2) System will check if such user was already registered in Customer Management. Does customer with such [merchant_customer_identifier] already exist? ) then (Yes) :(3) Customer was already registered in Customer Management. Customer is being identified by merchant_customer_identifier; :(4) Routing will be chosen according to the level sent in the request. Customer level in the system will be set equal to customer_level in request.; else (No) :(5) Registering new customer in Customer Management with id passed in merchant_customer_identifier. New Customer is being identified by merchant_customer_identifier; :(6) Routing will be chosen according to the level sent in the request. Customer level in the system will be set equal to customer_level in request.; endif :(7) Routing being adjusted according to level specifications.; stop | (3), (5) :ex:`merchant_customer_identifier` не следует передавать с пустым значением. Если :ex:`merchant_customer_identifier` отправлен с пустым значением, Клиент будет создан в Customer Management и может быть идентифицирован только с помощью Client Definition, настроенного на уровне Проекта или Endpoint. | (4), (6) Если :ex:`customer_level` передаётся пустым, клиенту будет присвоен пустой уровень либо :code:`Unknown level`, если настроено поведение по умолчанию :ex:`Unknown level`. .. warning:: Неправильно переданные параметры могут привести к неверной маршрутизации транзакций или к тому, что они вообще не будут обработаны. Платёжный Шлюз ------------------------------ :code:`PNE (GATE)` — позволяет определить клиента по внутреннему идентификатору клиента. | Параметры, используемые в конфигурации :code:`PNE`: - :ex:`customer_id` - :ex:`customer_level` .. warning:: merchant_customer_identifier не должен включаться в запрос. .. uml:: :align: center title PNE (GATE) operation mode start :(1) Receiving [customer_id] and [customer_level] from Connecting Party.; if ( (2) System will check if such user was already registered in Customer Management. Does customer with such [customer_id] exist? ) then (yes) :(3) Customer was already registered in Customer Management. Customer is being identified by customer_id; :(4) Routing is chosen according to the level of customer in Customer Management. Customer level in the system will be set equal to customer_level in request.; else (No) :(5) In case of customer with customer_id value sent in the request have not been found in Customer Management, routing rules won't be applied.; endif :(7) Routing being adjusted according to level specifications; stop | (3), (5) Если :ex:`customer_id` передаётся пустым, проверяется :ex:`Client Definition`, заданный на уровне проекта или конечной точки, и, если клиент не найден, будет создан новый клиент с новым :ex:`customer_id`. | (4), (6) Если :ex:`customer_level` отправлен пустым, маршрутизация будет настроена в соответствии со сконфигурированным поведением по умолчанию :ex:`Unknown level` или :ex:`Project`. .. warning:: Неправильно переданные параметры могут привести к неверной маршрутизации транзакций или к тому, что они вообще не будут обработаны. Level Configuration =================== Конфигурацию уровней можно выполнить для :code:`Deposits` и :code:`Withdrawals`. Чтобы добавить конфигурации, нажмите кнопку :code:`+` и выберите валюту. | .. image:: ../_static/images/CMSleveladd.png :width: 500 :align: center :alt: pic107 manager faq | .. note:: Валюта может различаться в зависимости от валют, в которых доступны проекты торговца. | .. image:: ../_static/images/CMSlevel.png :width: 500 :align: center :alt: pic107 manager faq | :code:`unknown` — уровень по умолчанию, который будет создан автоматически. | На экране выше все уровни будут отображены со следующей информацией: - Параметр :code:`Level name` - :code:`Проекты` — все проекты торговца, подключённые к Customer Management. - :code:`Created` и :code:`Modified` — показывают время создания или изменения конфигурации. | Нажмите кнопку редактирования, чтобы изменить название уровня, добавить или удалить проекты из уровня, либо выбрать :code:`Delete "currency"`, чтобы удалить всю конфигурацию для валюты. Конфигурация уровня клиента ---------------------------- Нажмите :code:`Level Название`, чтобы открыть настройку уровня клиента. В открывшемся окне выберите :code:`Level configuration`, чтобы настроить пользовательский платёжный поток для уровня клиента, или Filters, чтобы добавить дополнительные проверки для уровня. .. image:: ../_static/images/CMScustomerlevel.png :width: 500 :align: center :alt: pic107 manager faq | На этом экране отображается информация об уровне: :code:`Payment direction` — пополнение или выплата, :code:`Currency`, Параметр :code:`Level name`, :code:`Status` — показывает статус уровня (активен/отключён). | .. image:: ../_static/images/CMSconfig.png :width: 500 :align: center :alt: pic107 manager faq | В разделе :code:`Payment methods` отображаются все доступные методы Payment Cashier. При нажатии на любой из методов появляется окно :code:`Configuration`. | В разделе :code:`Конфигурация` нажмите :code:`Сбросить по умолчанию`, чтобы восстановить все настройки по умолчанию; | Установите или снимите флажок :code:`Show in form`, чтобы показать/скрыть выбранный способ оплаты из формы Payment Cashier; | Установите минимальную/максимальную сумму, которая задаст или переопределит эти параметры на уровне конечной точки. | Нажмите кнопку :code:`Сохранить`, чтобы применить конфигурацию. | | В :code:`списке шлюзов` выберите, какой маршрут Routing или шлюз будет доступен для выбранного уровня. | | После всех настроек изменённые способы оплаты будут перемещены на вкладку :code:`Edited`. Все неизменённые способы будут показаны на вкладке :code:`Default`. Filters ------- Фильтры транзакций в Системе предназначены для отклонения определённых транзакций по различным причинам. | .. image:: ../_static/images/CMSfilters.png :width: 500 :align: center :alt: pic107 manager faq | Существуют фильтры трёх уровней: - Частота использования идентификатора клиента за последние 24 часа (дневной лимит) - Частота использования идентификатора клиента за последние 7 дней (недельный лимит). - Частота использования идентификатора клиента за последний месяц (месячный лимит) | .. list-table:: :widths: 40, 50, 10 :header-rows: 1 :class: longtable table-text-justify table-text-center * - Название - Описание - Значение * - Лимит суммы - Максимальная общая сумма транзакций за последние 24 часа (неделю, месяц) для точного идентификатора клиента - 99999 * - Календарная неделя начинается с воскресенья - | «Да»: календарная неделя начинается с воскресенья, | «Нет»: календарная неделя начинается с понедельника - Yes/No * - Для всех валют торговца в CMS - будет рассчитана текущая общая сумма или количество транзакций за последние 24 часа (неделю, месяц) для этого идентификатора Клиента: «Да» — для всех уровней Торговца во всех валютах в направлении платежа (пополнение или вывод) с конвертацией в валюту текущего уровня для сравнения с лимитом суммы; «Нет» — только для текущего уровня. - * - Лимит количества - Максимальное общее количество транзакций за последние 24 часа (неделю, месяц) для точного идентификатора клиента - 99999 * - Исключить транзакции Cancel - - * - Использовать календарный день - - **Коды ошибок** .. list-table:: :widths: 25, 25, 50 :header-rows: 1 :class: longtable * - # - Код - Название * - 19000 - - Daily сумма лимит превышен for клиент id * - 19001 - - Daily количество лимит превышен for клиент id * - 19002 - - Weekly сумма лимит превышен for клиент id * - 19003 - - Weekly количество лимит превышен for клиент id * - 19004 - - Monthly сумма лимит превышен for клиент id * - 19005 - - Monthly количество лимит превышен for клиент id Customers ========= Для :code:`Customers` можно выполнить индивидуальную настройку. В зависимости от переданных параметров (:code:`customer_id`, :code:`customer_level`, :code:`merchant_customer_identifier`) клиент может быть создан автоматически или вручную на экране :code:`Customers`. Нажмите :code:`Customers`, чтобы открыть экран :code:`Customers`. .. image:: ../_static/images/CMScustomer.png :width: 500 :align: center :alt: pic107 manager faq | На этом экране будут отображаться все клиенты с краткой информацией. .. image:: ../_static/images/CMScustomerfilter2.png :width: 500 :align: center :alt: pic107 manager faq | Как показано на изображении выше, нажмите :code:`1` — :code:`Show filter`, чтобы открыть дополнительные критерии поиска. Во всплывающем окне выберите следующие критерии: Customer IDs Платёжного Шлюза, Merchant Customer IDs, название уровня пополнения, название уровня вывода средств, Email или диапазон дат (даты создания). | Можно добавлять, изменять или удалять информацию из панели :code:`2` или через раздел фильтров. | Выберите группу клиентов или всех, чтобы :code:`Set global limit` или :code:`Change level` — для всех выбранных клиентов. | Нажмите :code:`Создать`, чтобы создать нового клиента. | .. image:: ../_static/images/CMScreatecustomer.png :width: 500 :align: center :alt: pic107 manager faq | Нажмите :code:`Загрузить`, чтобы скачать список всех клиентов с их данными. | | Нажмите :code:`Upload`, чтобы загрузить список клиентов с их реквизитами, используя параметры, показанные ниже: .. image:: ../_static/images/CMSupload.png :width: 500 :align: center :alt: pic107 manager faq | :code:`Загрузить CSV` — для загрузки списка клиентов; | :code:`Скачать шаблон` — для загрузки примера файла; | :code:`Создать имитацию` — для создания клиентов с фиктивными данными. Common Settings --------------- При нажатии на идентификатор любого клиента откроется следующее окно: | .. image:: ../_static/images/CMScustomerconfig.png :width: 500 :align: center :alt: pic107 manager faq | В :code:`Common settings` отображается вся информация о клиенте. Нажмите :code:`Edit info`, чтобы изменить сведения о клиенте, кроме :code:`Customer ID` и :code:`Merchant customer ID`. Кнопка :code:`Virtual terminal` позволяет открыть виртуальный терминал со всеми данными клиента непосредственно с этого экрана. :code:`All orders` отображает все заказы, связанные с клиентом. Individual Payment Settings --------------------------- Индивидуальные настройки платежа позволяют настроить Cashier Payment Form для каждого клиента отдельно. Сначала выберите уровень и валюту. Затем выберите :code:`Use as global limit for customer`, если минимальная/максимальная сумма для валюты должна применяться ко всем доступным решениям. Выберите :code:`Payment methods` и при необходимости примените настройку. При нажатии :code:`Virtual terminal` откроется Virtual terminal со всей информацией о клиенте.