Торговецs

Creating Торговец

Чтобы просмотреть и найти всех Торговцев, перейдите Settings -> Users -> Торговецs, затем, чтобы создать нового Торговца, нажмите кнопку + New Торговец:

Ниже перечислены все поля, доступные для заполнения:

Название поля	Описание	Необходимость
Login	Логин, необходимый для входа в систему. Не может быть изменён после создания.	Обязательное
Password	Пароль для входа. Чтобы изменить его, обратитесь в службу поддержки.	Обязательное
Отображаемое имя	Название торговца, которое будет отображаться.	Обязательное
E-mail	Контактный адрес электронной почты, который будет добавлен к этой учётной записи торговца.	Обязательное
Контрольный ключ	Секретный ключ, который будет использоваться для подписания запросов.	Обязательное
Платёжная группа	В настоящее время не используется. «Common» — значение по умолчанию. Не может быть изменено после создания.	Обязательное
Name	Отображает имя контактного лица торговца. Оно будет показано только в сведениях о торговце.	Обязательное
Surname	Отображает фамилию контактного лица торговца. Это имя будет показано только в сведениях о торговце.	Обязательное
Параметр Business type	Покажет тип бизнеса торговца.	Необязательное
Количество одобренных сессий для возвращающегося клиента	Показывает, после скольких одобренных транзакций плательщик будет считаться возвращающимся для торговца.	Необязательное
Страна регистрации	Отображает страну торговца.	Необязательное
URL сайта торговца	URL сайта Торговца теперь можно задать на экране деталей Торговца и включить в email-уведомления (макрос MERCHANT_SITE_URL).	Необязательное
Organization	Отображает название организации торговца.	Необязательное
Теги	Отображает теги, по которым торговца можно найти в системе позже.	Необязательное
Дескриптор API	Менеджер может задать параметр API descriptor в профиле Торговец. Это значение будет возвращаться вместо значений шлюза, указанных в Gate Details.	Необязательное
Email for Notifications	Торговец email addresses for automated notifications regarding transaction status changes to Fraud or Chargeback. Supports multiple recipients.	Необязательное

Описание: Торговец details

Экран позволяет просматривать все детали созданного торговца, изменять настройки, настраивать баланс торговца и просматривать связанные endpoint’ы.

Linked Endpoints

В этом разделе по умолчанию отображаются включённые конечные точки, связанные с торговцем. При выборе Show disabled endpoints таблица будет заменена и отобразит отключённые связанные конечные точки.

Описание: Account balance

Введение

Менеджер может настраивать и просматривать несколько балансов для каждой учётной записи Торговец и запрашивать балансы через API с доступом Менеджер. Эти балансы рассчитывают общие накопленные средства от транзакций, связанных с Торговец. Расчёт балансов поддерживает настроенные тарифные планы, включая STH — краткосрочный холд и RR — Rolling Reserve.
Менеджер может добавлять корректировки к балансам Торговца в интерфейсе или с помощью API корректировок, чтобы отразить нетранзакционные изменения баланса Торговца. См. Получение корректировок баланса.
По умолчанию Торговцы не могут видеть свои балансы в интерфейсе или запрашивать балансы через API с доступом торговца, однако эту функцию можно предоставить каждому Торговцу отдельно.

Балансы торговца можно настроить на вкладке Accounts экрана сведений о торговце.
Для настройки расчёта балансов выполните следующие действия:
1. Установите конфигурацию учётной записи, чтобы определить, как и какие транзакции и тарифы должны влиять на балансы.
2. Установите Balances для нужных currencies и endpoints.
3. Установите переопределение конфигурации учётной записи для конкретных балансов (при необходимости).

First balance is funded by sale transactions and defunded by payout transactions and is set up for USD currency, also Торговец rates applied for sale transactions. Second balance has override for sale transactions which will deduct balance with amount calculated from manager rate plan.

Ниже приведён пример полностью настроенного баланса с выделенными шагами.

Конфигурация учётной записи

Счета Торговца можно настроить через вкладку Accounts. Пример окна счетов см. ниже:

Application Rate Direction

Для транзакций с rate only можно выбрать как ADD, так и DEDUCT. Для каждой транзакции ставка применения может задаваться по-разному. Например, если для транзакции Payout необходимо списать комиссию помимо списания суммы самого Payout, выберите DEDUCT в настройке Apply direction.

Application Impact on Balance

Разные типы транзакций учитываются по-разному при расчёте балансов. Список влияния операций на баланс приведён в таблице ниже:

Транзакция тип	Описание: Impact on balance
sale	Add
capture	Add
dispute	Add
chargeback_reversal	Add
arbitration	Add
payout_cancel	Add
chargeback	Deduct
prearbitration	Deduct
reversal	Deduct
payout	Deduct
перевод (deposit2card)	Deduct
preauth	Описание: Rate only
cancel	Описание: Rate only
fraud	Описание: Rate only
retrieval	Описание: Rate only
pan_eligibility	Описание: Rate only
create_card_mapping	Описание: Rate only
update_card_mapping	Описание: Rate only
inquire_card_mapping	Описание: Rate only
delete_card_mapping	Описание: Rate only
mfo_scoring	Описание: Rate only
account_verification	Описание: Rate only
void	Описание: Rate only

Rate Types

Для каждого типа транзакции Менеджер может отдельно применить ставку (комиссию). Возможные типы ставок:

Ничего
Торговец
Реселлер
Менеджер
Dealer
Acquirer

Date Bumping Functions

Функции сдвига даты позволяют выбрать, когда средства будут зачислены на счёт. Возможные значения:

ASAP — зачисление средств без задержки. Не включает STH и Rolling Reserve.

ASAP_plus_RR — зачисление средств ASAP с учётом Rolling reserve. Не включает STH.

DAY + n — зачисление средств с STH после указанного количества дней + Rolling Reserve.

BDAY + n — зачисление средств с STH после указанного количества рабочих дней + Rolling Reserve.

Добавить конфигурацию учётной записи

Чтобы создать новый баланс учётной записи, добавьте конфигурацию учётной записи и баланс:

Чтобы добавить новую конфигурацию учётной записи, нажмите +Add в поле конфигурации и настройте тип транзакции и ставки, которые будут зачислять или списывать средства с баланса согласно настройкам, описанным в Accounts Configuration. При необходимости можно выбрать гейт и endpoint: если оставить их пустыми, конфигурация баланса будет работать для всех гейтов и endpoint выбранного Торговец.

Balances

Описание: Add balance

Чтобы добавить новый баланс учётной записи, нажмите кнопку +Add в поле балансов учётной записи и задайте баланс, имя менеджера и валюту. Подробная настройка баланса описана ниже в этом разделе.

Types

Для каждого баланса существуют четыре типа средств:

Balance Total

Balance Total — сумма средств, рассчитанная на основе конфигурации, включая STH и RR.

Balance Live

Balance Live — сумма средств, рассчитанная на основе конфигурации, исключая STH и RR.

Example

Balance Live = Balance Total - STH - RR.

Short-Term Holds

Краткосрочные удержания — сумма средств, рассчитанная на основе функции переноса даты.

Example

Транзакции, проведённые сегодня с 11:01 до 11:59, будут зачислены в 12:01 в день, когда они должны быть зачислены согласно параметру DAY + n или BDAY + n.

Rolling Reserve

Скользящий резерв (долгосрочные удержания или удержания из тарифного плана) — сумма средств, рассчитанная на основе удержания по тарифному плану. Максимальный скользящий резерв — лимит суммы скользящего резерва.

Max Rolling Reserve можно изменить в появившемся окне «Изменить Max Rolling Reserve». Чтобы установить или отредактировать Max Rolling Reserve, нажмите значение -.

Предупреждение

Скользящий резерв будет зачислен на баланс в дату транзакции + период из тарифного плана + 1 день. При достижении максимального лимита скользящего резерва общая сумма удерживаемых средств не увеличивается, а скользящий резерв, рассчитанный по следующим транзакциям, вместо этого сразу добавляется на баланс. Кроме того, если максимальный скользящий резерв установлен позднее и меньше текущего накопленного скользящего резерва, резерв, рассчитанный по следующим транзакциям, сразу добавляется на баланс.

Endpoint Setting

Существует возможность выбрать один или несколько endpoint’ов для каждого баланса, по которым будет рассчитываться баланс.

Конечную точку можно добавить при создании баланса:

Либо её можно указать для существующего баланса, нажав на одну из областей, выделенных на рисунке:

На этом рисунке также показана разница между балансами, настроенными с указанным Endpoint и без него.

Multiple Balances In One Валюта

Для одной валюты может быть настроено несколько балансов.

В этом случае только один из балансов может быть без указанных Endpoint. При создании всех последующих балансов обязательно указывать Endpoint. Расчёт выполняется для каждого баланса отдельно: баланс без указанных Endpoint учитывается только для тех Endpoint, для которых отдельный баланс не создан.

Переопределение конфигурации учётной записи

Существует возможность изменить конфигурацию для каждого баланса (не для всех балансов Торговца).

В этом случае нужно нажать кнопку Конфигурация, как на рисунке ниже:

После этого нажмите кнопку Добавить:

В этом окне можно изменить настройки баланса, как и в Конфигурации

Предупреждение

Если переопределён хотя бы один тип операции, баланс рассчитывается по переопределённой конфигурации и только для переопределённых операций. Если для типов операций нет переопределения, баланс рассчитывается по основной конфигурации.

Пример: для баланса 191 операции Sale и Payout переопределены, что означает, что для этого баланса основная конфигурация не действует.

Чтобы удалить переопределение конфигурации, нажмите кнопку Удалить всё и подтвердите удаление.

Creation Date Changing

Чтобы изменить дату создания баланса, нажмите кнопку Изменить дату создания:

Выберите дату создания и нажмите кнопку Обновить:

Дата изменения подтверждения баланса учётной записи

После изменения даты создания используйте reconciliation для перерасчёта баланса.

Export Balance Transactions

Чтобы использовать сверку баланса, нажмите кнопку Сверка баланса:

Чтобы экспортировать транзакции баланса, нажмите кнопку Export Transactions и выберите период транзакций:

Примечание

Максимальный период — 31 день.

Примечание

Дата отсчитывается как [day_From, day_To), поэтому последний день не будет включён в интервал.

Файл CSV содержит следующие поля:

Предупреждение

Поля «Reserve date» и «STH date» содержат дату и время, когда сумма повлияет на баланс. Дата STH в отчёте не учитывает часовой период, описанный в типах баланса.

Balance Reconciliation

Сверка позволяет пересчитать баланс после изменений.

Чтобы сверить баланс, нажмите 3 точки рядом с балансом, затем кнопку Reconciliation Balance и после кнопку Reconcile:

Примечание

Сверяются только общий и доступный балансы. RR и STH нельзя сверить; их сумма будет зачислена на доступный баланс согласно конфигурации на момент создания транзакции.

Move Rolling Reserve позволяет вручную перевести скользящий резерв на активный баланс до даты освобождения удержания. Чтобы переместить скользящий резерв, нажмите три точки рядом с балансом, затем Move Rolling Reserve:

Adjustments

Корректировки позволяют изменять сумму балансов без выполнения транзакций.

Список корректировок и полную сумму корректировки можно просмотреть, нажав кнопку Adjustments:

Для удобства пользователей корректировки можно отсортировать по ID с помощью кнопки ниже:

Manual Adjustment

Сумма корректировки и внешний источник корректировки обязательны. Adjustments для баланса можно выполнить через кнопку Add+:

При добавлении корректировки можно указать следующие поля:

Описание: Adjustment amount
External ID
Описание: External source
Описание: External info

Примечание

Сумма корректировки и Внешний источник являются обязательными полями:

Adjustment API

Помимо ручных корректировок, можно выполнять корректировки через API.

Для этого необходимо создать tsv, заархивировать его и отправить через API. Команда API с примерами указана в документации по интеграции.

Export Adjustments

Чтобы экспортировать все корректировки для определённого баланса, нажмите Export, укажите период времени и снова нажмите Export. CSV-файл корректировок будет скачан автоматически.

Примечание

Максимальный период — 31 день

Загруженный файл содержит следующие поля:

Create Date
Adjustment Сумма
Adjustment Application Date
External Adjustment Unique Id
External Source Name
External Adjustment Info

Первая строка файла содержит период и сумму всех корректировок.

Scheduled Adjustment

Эта функция помогает настроить ежемесячную/еженедельную комиссию, которую можно устанавливать в назначенные даты каждого месяца/недели. Scheduled корректировки баланса можно создать кнопкой Add+:

При добавлении корректировки можно указать следующие поля:

Дата первой корректировки
Дата последней корректировки
Сумма
Валюта
Автоматически прекращать создание корректировок при отключении торговца
Автоматически прекращать корректировки, когда баланс становится отрицательным или нулевым
Я осознаю, что создание такой корректировки может существенно повлиять на баланс Торговца и привести к его неконтролируемому изменению в долгосрочной перспективе, что может вызвать финансовые потери из-за возможности неограниченного вывода средств вследствие неконтролируемого увеличения баланса Торговца. Этот флажок обязателен

Status указывает, активна ли корректировка. Её также можно включить или выключить, нажав на неё:

ID — уникальный идентификатор запланированной корректировки:

Период показывает, какое расписание выбрано для следующей корректировки:

Дата показывает интервал времени от первой до последней корректировки:

Дата следующего расписания показывает, когда будет следующая запланированная корректировка:

Дата последнего запуска показывает, когда была последняя запланированная корректировка:

Сумма показывает сумму корректировки:

Автоматически показывает, при каких условиях запланированная корректировка будет остановлена:

Редактировать можно использовать для изменения запланированной корректировки:

Удалить можно использовать для удаления запланированной корректировки: