.. meta:: :description: Создавайте и настраивайте аккаунты Торговцев в UI менеджера Payneteasy: назначайте endpoint'ы, проекты, параметры тарификации и права доступа. .. _usermerchant: Торговецs ######### .. role:: ex .. role:: code Creating Торговец ================= Чтобы просмотреть и найти всех Торговцев, перейдите :code:`Settings -> Users -> Торговецs`, затем, чтобы создать нового Торговца, нажмите кнопку :code:`+ New Торговец`: .. image:: ../../_static/images/createmerchantnew.png Ниже перечислены все поля, доступные для заполнения: .. list-table:: :widths: 40, 46, 14 :header-rows: 1 :class: longtable table-text-justify table-text-center * - Название поля - Описание - Необходимость * - :code:`Login` - Логин, необходимый для входа в систему. **Не может быть изменён после создания**. - :ex:`Обязательное` * - :code:`Password` - Пароль для входа. Чтобы изменить его, обратитесь в службу поддержки. - :ex:`Обязательное` * - :code:`Отображаемое имя` - Название торговца, которое будет отображаться. - :ex:`Обязательное` * - :code:`E-mail` - Контактный адрес электронной почты, который будет добавлен к этой учётной записи торговца. - :ex:`Обязательное` * - :code:`Контрольный ключ` - Секретный ключ, который будет использоваться для подписания запросов. - :ex:`Обязательное` * - :code:`Платёжная группа` - В настоящее время не используется. «Common» — значение по умолчанию. **Не может быть изменено после создания**. - :ex:`Обязательное` * - :code:`Name` - Отображает имя контактного лица торговца. Оно будет показано только в сведениях о торговце. - :ex:`Обязательное` * - :code:`Surname` - Отображает фамилию контактного лица торговца. Это имя будет показано только в сведениях о торговце. - :ex:`Обязательное` * - Параметр :code:`Business type` - Покажет тип бизнеса торговца. - :ex:`Необязательное` * - :code:`Количество одобренных сессий для возвращающегося клиента` - Показывает, после скольких одобренных транзакций плательщик будет считаться возвращающимся для торговца. - :ex:`Необязательное` * - :code:`Страна регистрации` - Отображает страну торговца. - :ex:`Необязательное` * - :code:`URL сайта торговца` - URL сайта Торговца теперь можно задать на экране деталей Торговца и включить в email-уведомления (макрос MERCHANT_SITE_URL). - :ex:`Необязательное` * - :code:`Organization` - Отображает название организации торговца. - :ex:`Необязательное` * - :code:`Теги` - Отображает теги, по которым торговца можно найти в системе позже. - :ex:`Необязательное` * - :code:`Дескриптор API` - Менеджер может задать параметр :ex:`API descriptor` в профиле Торговец. Это значение будет возвращаться вместо значений шлюза, указанных в :ref:`Gate Details`. - :ex:`Необязательное` * - :code:`Email for Notifications` - Торговец email addresses for automated notifications regarding transaction status changes to Fraud or Chargeback. Supports multiple recipients. - :ex:`Необязательное` Описание: Торговец details ================ | Экран позволяет просматривать все детали созданного торговца, изменять настройки, настраивать баланс торговца и просматривать связанные endpoint'ы. Linked Endpoints ^^^^^^^^^^^^^^^^ | В этом разделе по умолчанию отображаются включённые конечные точки, связанные с торговцем. При выборе :ex:`Show disabled endpoints` таблица будет заменена и отобразит отключённые связанные конечные точки. | .. image:: ../../_static/images/get_balance/linkedendpointsnew.png :alt: Описание: linked endpoints :align: center :width: 700 .. _manager_merchant_accounts: Описание: Account balance =============== Введение ^^^^^^^^^^^^ | Менеджер может настраивать и просматривать несколько балансов для каждой учётной записи Торговец и `запрашивать балансы через API с доступом Менеджер `_. Эти балансы рассчитывают общие накопленные средства от транзакций, связанных с Торговец. Расчёт балансов поддерживает настроенные тарифные планы, включая :code:`STH` — краткосрочный холд и :code:`RR` — Rolling Reserve. | Менеджер может добавлять корректировки к балансам Торговца в интерфейсе или с помощью `API корректировок `_, чтобы отразить нетранзакционные изменения баланса Торговца. См. `Получение корректировок баланса `_. | По умолчанию Торговцы не могут видеть свои балансы в интерфейсе или `запрашивать балансы через API с доступом торговца `_, однако эту функцию можно предоставить каждому Торговцу отдельно. | | Балансы торговца можно настроить на вкладке Accounts экрана сведений о торговце. | Для настройки расчёта балансов выполните следующие действия: | 1. Установите :ref:`конфигурацию учётной записи`, чтобы определить, как и какие транзакции и тарифы должны влиять на :ref:`балансы`. | 2. Установите :ref:`Balances` для нужных :ref:`currencies` и :ref:`endpoints`. | 3. Установите :ref:`переопределение конфигурации учётной записи` для конкретных :ref:`балансов` (при необходимости). First balance is funded by :code:`sale` transactions and defunded by :code:`payout` transactions and is set up for :ex:`USD` currency, also Торговец rates applied for :code:`sale` transactions. Second balance has override for sale transactions which will deduct balance with amount calculated from manager rate plan. Ниже приведён пример полностью настроенного баланса с выделенными шагами. .. image:: ../../_static/images/get_balance/configuredbalancenew.png :alt: Описание: configured balance :align: center :width: 650 .. _account_configuration: Конфигурация учётной записи ^^^^^^^^^^^^^^^^^^^^^ Счета Торговца можно настроить через вкладку :ex:`Accounts`. Пример окна счетов см. ниже: .. image:: ../../_static/images/get_balance/accountstabnew.png :alt: Описание: accounts tab :align: center :width: 800 .. _application_rate_direction: Application Rate Direction ~~~~~~~~~~~~~~~~~~~~~~~~~~ Для транзакций с :code:`rate only` можно выбрать как :code:`ADD`, так и :code:`DEDUCT`. Для каждой транзакции ставка применения может задаваться по-разному. Например, если для транзакции Payout необходимо списать комиссию помимо списания суммы самого Payout, выберите :code:`DEDUCT` в настройке :code:`Apply direction`. .. _application_impact_on_balance: Application Impact on Balance ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Разные типы транзакций учитываются по-разному при расчёте балансов. Список влияния операций на баланс приведён в таблице ниже: .. list-table:: :widths: 50, 50 :header-rows: 1 :class: longtable * - Транзакция тип - Описание: Impact on balance * - :code:`sale` - Add * - :code:`capture` - Add * - :code:`dispute` - Add * - :code:`chargeback_reversal` - Add * - :code:`arbitration` - Add * - :code:`payout_cancel` - Add * - :code:`chargeback` - Deduct * - :code:`prearbitration` - Deduct * - :code:`reversal` - Deduct * - :code:`payout` - Deduct * - :code:`перевод (deposit2card)` - Deduct * - :code:`preauth` - Описание: Rate only * - :code:`cancel` - Описание: Rate only * - :code:`fraud` - Описание: Rate only * - :code:`retrieval` - Описание: Rate only * - :code:`pan_eligibility` - Описание: Rate only * - :code:`create_card_mapping` - Описание: Rate only * - :code:`update_card_mapping` - Описание: Rate only * - :code:`inquire_card_mapping` - Описание: Rate only * - :code:`delete_card_mapping` - Описание: Rate only * - :code:`mfo_scoring` - Описание: Rate only * - :code:`account_verification` - Описание: Rate only * - :code:`void` - Описание: Rate only Rate Types ~~~~~~~~~~ Для каждого типа транзакции Менеджер может отдельно применить ставку (комиссию). Возможные типы ставок: * Ничего * Торговец * Реселлер * Менеджер * Dealer * Acquirer .. _date_bump_func: Date Bumping Functions ~~~~~~~~~~~~~~~~~~~~~~ | Функции сдвига даты позволяют выбрать, когда средства будут зачислены на счёт. Возможные значения: * :code:`ASAP` — зачисление средств без задержки. Не включает :code:`STH` и :code:`Rolling Reserve`. * :code:`ASAP_plus_RR` — зачисление средств ASAP с учётом :code:`Rolling reserve`. Не включает :code:`STH`. * :code:`DAY + n` — зачисление средств с :code:`STH` после указанного количества дней + :code:`Rolling Reserve`. * :code:`BDAY + n` — зачисление средств с :code:`STH` после указанного количества рабочих дней + :code:`Rolling Reserve`. | .. image:: ../../_static/images/get_balance/date_bump_new.png :alt: Описание: date bump :align: center :width: 400 Добавить конфигурацию учётной записи ------------------------- Чтобы создать новый баланс учётной записи, добавьте :ex:`конфигурацию учётной записи` и баланс: 1. Чтобы добавить новую конфигурацию учётной записи, нажмите :code:`+Add` в поле конфигурации и настройте тип транзакции и ставки, которые будут зачислять или списывать средства с баланса согласно настройкам, описанным в :ref:`Accounts Configuration`. При необходимости можно выбрать гейт и endpoint: если оставить их пустыми, конфигурация баланса будет работать для всех гейтов и endpoint выбранного Торговец. | .. image:: ../../_static/images/get_balance/addconfnew.png :alt: Описание: add conf :align: center :width: 300 .. _balances: Balances ^^^^^^^^ Описание: Add balance ~~~~~~~~~~~ 2. Чтобы добавить новый баланс учётной записи, нажмите кнопку :code:`+Add` в поле балансов учётной записи и задайте баланс, имя менеджера и валюту. Подробная настройка баланса описана ниже в этом разделе. | .. image:: ../../_static/images/get_balance/adding_account_balance_new.png :alt: Добавление баланса учётной записи :align: center :width: 300 Types ~~~~~ Для каждого баланса существуют четыре типа средств: Balance Total ------------- Balance Total — сумма средств, рассчитанная на основе конфигурации, включая :code:`STH` и :code:`RR`. | .. image:: ../../_static/images/get_balance/currbalancenew.png :alt: Описание: balance total :align: center :width: 870 Balance Live ------------ Balance Live — сумма средств, рассчитанная на основе конфигурации, исключая :code:`STH` и :code:`RR`. | .. image:: ../../_static/images/get_balance/livebalancenew.png :alt: Описание: live balance :align: center :width: 870 | .. admonition:: Example Balance Live = Balance Total - STH - RR. Short-Term Holds ---------------- Краткосрочные удержания — сумма средств, рассчитанная на основе :code:`функции переноса даты`. | .. image:: ../../_static/images/get_balance/sthnew.png :alt: sth :align: center :width: 870 | .. admonition:: Example Транзакции, проведённые сегодня с 11:01 до 11:59, будут зачислены в 12:01 в день, когда они должны быть зачислены согласно параметру :ex:`DAY + n` или :ex:`BDAY + n`. Rolling Reserve --------------- Rolling Reserve (Long-Term Holds or Holds from Rate Plan) - amount of funds calculated based on the rate plan hold. Max Rolling Reserve - a limit on the amount of Rolling Reserve. | .. image:: ../../_static/images/get_balance/MaxRR.png :alt: Max Rolling Reserve :align: center :width: 870 | Max Rolling Reserve можно изменить в появившемся окне «Изменить Max Rolling Reserve». Чтобы установить или отредактировать Max Rolling Reserve, нажмите значение :ex:`-`. | .. image:: ../../_static/images/get_balance/ChangeMaxRR.png :alt: Change Max Rolling Reserve :align: center :width: 400 .. Warning:: Rolling reserve will be credited to balance on :ex:`Transaction Date + Period from Rate Plan + 1 day`. When the Max Rolling Reserve limit is reached, the total amount of hold funds will not increase and the Rolling Reserve calculated from next transactions will be added to balance live instead. Also, If the Max Rolling Reserve is set later and is less than the current accumulated Rolling Reserve, then the Rolling Reserve calculated from next transactions will be added to the balance live. .. _endpoint_setting: Endpoint Setting ~~~~~~~~~~~~~~~~ Существует возможность выбрать один или несколько endpoint'ов для каждого баланса, по которым будет рассчитываться баланс. Конечную точку можно добавить при создании баланса: | .. image:: ../../_static/images/get_balance/adding_account_balance_new.png :alt: Описание: add acc balance :align: center :width: 400 | Либо её можно указать для существующего баланса, нажав на одну из областей, выделенных на рисунке: | .. image:: ../../_static/images/get_balance/accbeditnew.png :alt: Описание: acc debit :align: center :width: 870 | На этом рисунке также показана разница между балансами, настроенными с указанным Endpoint и без него. .. _currencies_balances: Multiple Balances In One Валюта ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Для одной валюты может быть настроено несколько балансов. In this case, only one of the balances can be without the specified Endpoints. When creating all subsequent balances, it is mandatory to specify the Endpoint. The calculation is made for each balance separately: the balance without the specified Endpoints is counted only for those Endpoints for which a separate balance has not been created. | .. image:: ../../_static/images/get_balance/editbalancenew.png :alt: Описание: edit balance :align: center :width: 400 .. _account_configuration_override: Переопределение конфигурации учётной записи ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Существует возможность изменить конфигурацию для каждого баланса (не для всех балансов Торговца). В этом случае нужно нажать кнопку :code:`Конфигурация`, как на рисунке ниже: | .. image:: ../../_static/images/get_balance/confoverridenew.png :alt: Описание: conf over ride :align: center :width: 870 | После этого нажмите кнопку :code:`Добавить`: .. image:: ../../_static/images/get_balance/overrideaddnew.png :alt: Описание: over ride add :align: center :width: 870 | В этом окне можно изменить настройки баланса, как и в :ex:`Конфигурации` .. warning:: Если переопределён хотя бы один тип операции, баланс рассчитывается по переопределённой конфигурации и только для переопределённых операций. Если для типов операций нет переопределения, баланс рассчитывается по основной конфигурации. Пример: для баланса 191 операции Sale и Payout переопределены, что означает, что для этого баланса основная конфигурация не действует. .. image:: ../../_static/images/get_balance/confoverridedone.png :alt: Описание: Описание: conf over ride done :align: center :width: 750 Чтобы удалить :ex:`переопределение конфигурации`, нажмите кнопку :code:`Удалить всё` и подтвердите удаление. Creation Date Changing ~~~~~~~~~~~~~~~~~~~~~~ Чтобы изменить дату создания баланса, нажмите кнопку :code:`Изменить дату создания`: .. image:: ../../_static/images/get_balance/change_date_account_balance_new.png :alt: Дата изменения баланса учётной записи :align: center :width: 870 Выберите дату создания и нажмите кнопку :code:`Обновить`: | .. image:: ../../_static/images/get_balance/change_date_confirm_account_balance_new.png :alt: Дата изменения подтверждения баланса учётной записи :align: center :width: 300 | После изменения даты создания используйте :ref:`reconciliation` для перерасчёта баланса. Export Balance Transactions ~~~~~~~~~~~~~~~~~~~~~~~~~~~ Чтобы использовать сверку баланса, нажмите кнопку :code:`Сверка баланса`: .. image:: ../../_static/images/get_balance/recexbutnew.png :alt: Описание: rece xbut :align: center :width: 870 | | Чтобы экспортировать транзакции баланса, нажмите кнопку :code:`Export Transactions` и выберите период транзакций: | .. image:: ../../_static/images/get_balance/recexbut1new.png :alt: Описание: rece xbut :align: center :width: 870 | .. image:: ../../_static/images/get_balance/period_field_new.png :alt: Описание: period field :align: center :width: 500 | .. note:: Максимальный период — 31 день. .. note:: Дата отсчитывается как :ex:`[day_From, day_To)`, поэтому последний день не будет включён в интервал. Файл CSV содержит следующие поля: | .. image:: ../../_static/images/get_balance/balanceexp.png :alt: Описание: balance exp :align: center :width: 870 | .. warning:: Поля «Reserve date» и «STH date» содержат дату и время, когда сумма повлияет на баланс. Дата STH в отчёте не учитывает часовой период, описанный в типах баланса. .. _accounts_reconciliation: Balance Reconciliation ~~~~~~~~~~~~~~~~~~~~~~ Сверка позволяет пересчитать баланс после изменений. Чтобы сверить баланс, нажмите 3 точки рядом с балансом, затем кнопку :code:`Reconciliation Balance` и после кнопку :code:`Reconcile`: | .. image:: ../../_static/images/get_balance/recexbutnew.png :alt: Описание: rece xbut :align: center :width: 870 | .. note:: Сверяются только общий и доступный балансы. RR и STH нельзя сверить; их сумма будет зачислена на доступный баланс согласно конфигурации на момент создания транзакции. :code:`Move Rolling Reserve` позволяет вручную перевести скользящий резерв на активный баланс до даты освобождения удержания. Чтобы переместить скользящий резерв, нажмите три точки рядом с балансом, затем :code:`Move Rolling Reserve`: | .. image:: ../../_static/images/get_balance/move_rolling_reserve.png :alt: Описание: rece xbut :align: center :width: 870 | Adjustments ^^^^^^^^^^^ Корректировки позволяют изменять сумму балансов без выполнения транзакций. Список корректировок и полную сумму корректировки можно просмотреть, нажав кнопку :code:`Adjustments`: | .. image:: ../../_static/images/get_balance/adjnew.png :alt: adj :align: center :width: 870 | Для удобства пользователей корректировки можно отсортировать по ID с помощью кнопки ниже: | .. image:: ../../_static/images/get_balance/adjIDfilter.png :alt: Описание: adj ID filter :align: center :width: 870 Manual Adjustment ~~~~~~~~~~~~~~~~~ Сумма корректировки и внешний источник корректировки обязательны. :code:`Adjustments` для баланса можно выполнить через кнопку :code:`Add+`: | .. image:: ../../_static/images/get_balance/adjclicknew.png :alt: Описание: adj click :align: center :width: 870 | При добавлении корректировки можно указать следующие поля: * Описание: Adjustment amount * External ID * Описание: External source * Описание: External info .. note:: :code:`Сумма корректировки` и :code:`Внешний источник` являются обязательными полями: | .. image:: ../../_static/images/get_balance/adjaddnew.png :alt: Добавить корректировку :align: center :width: 400 Adjustment API ~~~~~~~~~~~~~~ Помимо ручных корректировок, можно выполнять корректировки через API. Для этого необходимо создать :code:`tsv`, заархивировать его и отправить через API. Команда API с примерами указана в `документации по интеграции `_. Export Adjustments ~~~~~~~~~~~~~~~~~~ Чтобы экспортировать все корректировки для определённого баланса, нажмите :code:`Export`, укажите период времени и снова нажмите :code:`Export`. CSV-файл корректировок будет скачан автоматически. .. note:: Максимальный период — 31 день Загруженный файл содержит следующие поля: * Create Date * Adjustment Сумма * Adjustment Application Date * External Adjustment Unique Id * External Source Name * External Adjustment Info Первая строка файла содержит период и сумму всех корректировок. .. image:: ../../_static/images/get_balance/adj_ex.png :alt: Описание: adj ex :align: center :width: 870 Scheduled Adjustment ~~~~~~~~~~~~~~~~~~~~ Эта функция помогает настроить ежемесячную/еженедельную комиссию, которую можно устанавливать в назначенные даты каждого месяца/недели. :code:`Scheduled` корректировки баланса можно создать кнопкой :code:`Add+`: | .. image:: ../../_static/images/get_balance/scheduledadd.png :alt: Описание: scheduled add :align: center :width: 870 | При добавлении корректировки можно указать следующие поля: * Дата первой корректировки * Дата последней корректировки * Сумма * Валюта * Автоматически прекращать создание корректировок при отключении торговца * Автоматически прекращать корректировки, когда баланс становится отрицательным или нулевым * Я осознаю, что создание такой корректировки может существенно повлиять на баланс Торговца и привести к его неконтролируемому изменению в долгосрочной перспективе, что может вызвать финансовые потери из-за возможности неограниченного вывода средств вследствие неконтролируемого увеличения баланса Торговца. **Этот флажок обязателен** | .. image:: ../../_static/images/get_balance/scheduledadd1.png :alt: Описание: Описание: scheduled add1 :align: center :width: 870 :code:`Status` указывает, активна ли корректировка. Её также можно включить или выключить, нажав на неё: | .. image:: ../../_static/images/get_balance/scheduledstatus.png :alt: Описание: scheduled status :align: center :width: 870 | :code:`ID` — уникальный идентификатор запланированной корректировки: | .. image:: ../../_static/images/get_balance/scheduledid.png :alt: Описание: scheduled id :align: center :width: 870 | :code:`Период` показывает, какое расписание выбрано для следующей корректировки: | .. image:: ../../_static/images/get_balance/scheduledperiod.png :alt: Описание: scheduled period :align: center :width: 870 | :code:`Дата` показывает интервал времени от первой до последней корректировки: | .. image:: ../../_static/images/get_balance/scheduleddate.png :alt: Описание: scheduled date :align: center :width: 870 | :code:`Дата следующего расписания` показывает, когда будет следующая запланированная корректировка: | .. image:: ../../_static/images/get_balance/schedulednextdate.png :alt: Описание: scheduled next date :align: center :width: 870 | :code:`Дата последнего запуска` показывает, когда была последняя запланированная корректировка: | .. image:: ../../_static/images/get_balance/scheduledlastate.png :alt: Описание: scheduled lastate :align: center :width: 870 | :code:`Сумма` показывает сумму корректировки: | .. image:: ../../_static/images/get_balance/scheduledamount.png :alt: Описание: scheduled amount :align: center :width: 870 | :code:`Автоматически` показывает, при каких условиях запланированная корректировка будет остановлена: | .. image:: ../../_static/images/get_balance/scheduledautomatic.png :alt: Описание: scheduleda utomatic :align: center :width: 870 | :code:`Редактировать` можно использовать для изменения запланированной корректировки: | .. image:: ../../_static/images/get_balance/schedulededit.png :alt: Описание: scheduled edit :align: center :width: 870 | :code:`Удалить` можно использовать для удаления запланированной корректировки: | .. image:: ../../_static/images/get_balance/scheduleddelete.png :alt: Описание: scheduled delete :align: center :width: 870