Основы работы
Последнее обновление: 27.10.2024 14:54
Быстрый старт

Используйте функцию быстрого добавления валют и направлений обмена, это позволит значительно ускорить процесс настройки обменника. Перейдите в раздел "Валюты" и нажмите кнопку "Добавить" - "Быстрое добавление". После добавления валюты, проделайте такие же шаги в разделе "Направления обмена".

Ручной режим

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

Процесс обмена

1) Пользователь создает и оплачивает заявку на обмен согласно инструкции.

2) После успешной оплаты, пользователю необходимо нажать кнопку "Оплата произведена".

3) Оператор проверяет транзакцию в истории платежной системы. Если платеж поступил, оператор в ручную производит выплату по заявке на обмен и изменяет её статус на "Выполнена".

Отключение кнопки подтверждения оплаты

Для этого перейдите в раздел "Настройки приложения" - "Настройка ручной обработки платежа".

Добавление поля для ввода идентификатора транзакции об оплате

Для этого перейдите в раздел "Настройки приложения" - "Настройка ручной обработки платежа".

Редактирование инструкции по оплате

Для изменения стандартного текста инструкции, перейдите в раздел "Настройки шаблона" - "Слова и текст документа". Вы так же можете указать уникальную инструкцию на странице редактирования направления обмена, в разделе "Описание".

Полуавтоматический режим

Для начала работы в полуавтоматическом режиме необходимо настроить мерчант. После чего выберите "Мерчант обработки входящих платежей" на странице редактирования направления обмена.

Процесс обмена

1) Пользователь создает и оплачивает заявку на обмен, используя форму оплаты или платежные реквизиты мерчанта.

2) После успешной оплаты, заявка на обмен автоматически изменяет статус на "Оплачена".

3) Оператор в ручную производит выплату по заявке на обмен и изменяет её статус на "Выполнена".

Система бонусов

Система бонусов позволяет производить обмен на более выгодных условиях для постоянных клиентов. Бонус прибавляется к сумме получаемой валюты во время обмена. Размер бонуса может зависеть от оборота обменов или быть уникальным для конкретного пользователя. Оборот обменов рассчитывается автоматически в базовой валюте баланса пользователя, после каждого успешно завершенного обмена.

Для настройки системы бонусов, перейдите в раздел "Настройки приложения" - "Настройка системы бонусов".

Баланс пользователя

Баланс пользователя является внутренней валютой, которая используется в работе реферальной и инвестиционной программ, а так же может выступать в качестве кошелька электронной платежной системы.

Любая валюта или направление обмена может использоваться для работы с балансом пользователя. Вы можете создать валюту "Balance USD", используя строку идентификатор "BALANCE" и работать с ней, как и с любой другой валютой. Ввод и вывод средств происходит через направление обмена с мерчантом обработки входящих/исходящих платежей "Баланс пользователя".

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

Реферальная программа

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

Для настройки реферальной программы, перейдите в раздел "Настройки приложения" - "Настройка реферальной программы".

Базовый парсер курса

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

Для изменения базового парсера курса, перейдите в раздел "Настройки приложения" - "Общая настройка приложения".

Инвестиционная программа

Инвестирование происходит через открытие вклада в профиле пользователя с оплатой через баланс пользователя. Начисление процентов производится на баланс пользователя. Тело вклада будет возвращено в конце срока инвестирования.

Для настройки инвестиционной программы, перейдите в раздел "Настройки приложения" - "Настройка инвестиционной программы". Поле "Интервал начислений процентов" может содержать целое число от 1 до 365. Означает количество дней, через которое производится начисление процентов.

Автоматическое обновление курсов обмена

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

Пример настройки

Парсер курса Пара Способ расчета Тип коррекции Сумма коррекции Описание
HTX BTCUSDT - - - Получить курс обмена BTC/USDT на бирже HTX
Binance USDTETH Сумма Курс обмена отдаваемой валюты 100 Получить курс обмена USDT/ETH на бирже Binance (+100 USDT)
Forex USDUAH Проценты Курс обмена получаемой валюты -5 Получить курс обмена USD/UAH на Forex (-5 %)

Формулы

Используя формулу в качестве парсера курса и выражение в качестве пары, можно рассчитать курс обмена из нескольких источников, используя при этом арифметические и логические операторы.

Написание формулы начинается с буквы "S" (отдаваемая валюта) или "R" (получаемая валюта), это позволит установить курс обмена в формате "X = 1" или "1 = X". Для получения курса обмена используйте запись "{ПАРСЕРКУРСА:ПАРА}".

Примеры формул

Рассчитать курс обмена BCH/LTC на бирже Binance:

S {BINANCE:BCHUSDT} / {BINANCE:LTCUSDT}

Рассчитать средний курс обмена BTC/USDT на биржах Binance, HTX:

R ({BINANCE:BTCUSDT} + {HUOBI:BTCUSDT}) / 2

Получить курс обмена BTC/USDT на бирже HTX, если его не удалось получить на бирже Binance:

S {BINANCE:BTCUSDT} ? {BINANCE:BTCUSDT} : {HUOBI:BTCUSDT}

Рассчитать курс обмена UAH/DOGE, используя ПриватБанк и биржу Binance:

R {PRIVATBANK:UAHUSD} * {BINANCE:DOGEUSDT}

Получить курс обмена ETH/USD, если курс обмена USDT/USD на бирже WhiteBIT меньше 0.90 или больше 1.10, иначе получить курс обмена ETH/USDT:

S {WHITEBIT:USDTUSD} < 0.90 || {WHITEBIT:USDTUSD} > 1.10 ? {WHITEBIT:ETHUSD} : {WHITEBIT:ETHUSDT}

Рассчитать курс обмена USDT/TRX в формате 1 USDT = X TRX используя биржу WhiteBIT:

R 1 / {WHITEBIT:TRXUSDT}

Калькулятор формул

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

1) Вставьте или начните писать формулу в поле "Формула".

2) Заполните значения переменных в поле "Переменные", имитируя реальный курс обмена. Что бы автоматически сгенерировать список переменных формулы, удалите все данные из поля.

3) Изменяйте любые данные и наблюдайте финальный курс обмена.

Константы

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

Пример использования констант

Получить курс обмена USD/UAH используя ПриватБанк и увеличить его в процентном соотношении на значение константы UAHFEE:

R {PRIVATBANK:USDUAH} + (({PRIVATBANK:USDUAH} * {CONSTANT:UAHFEE}) / 100)

Получить курс обмена ETH/USDT на бирже Binance если в качестве значение константы USEBINANCE установлена единица, иначе получить курс обмена ETH/USDT на бирже WhiteBIT:

R {CONSTANT:USEBINANCE} == 1 ? {BINANCE:ETHUSDT} : {WHITEBIT:ETHUSDT}

Для настройки констант, перейдите в раздел "Настройки приложения" - "Настройка констант парсера курса".

Динамический курс обмена

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

Экспорт курсов обмена

Для получения данных необходимо отправить GET запрос на один из URL-адресов:

Формат URL-адрес
XML https://ВАШ.ДОМЕН/rates-export/xml
TXT https://ВАШ.ДОМЕН/rates-export/txt
JSON https://ВАШ.ДОМЕН/rates-export/json
JSON https://ВАШ.ДОМЕН/rates-export-another-json-v1

Ограничение доступа

Доступ к данным может быть ограничен при помощи токена доступа. Для настройки токена доступа, перейдите в разделе "Настройки приложения" - "Настройка экспорта курсов".

Пример URL-адреса с токеном доступа:

https://ВАШ.ДОМЕН/rates-export/json/ТОКЕН_ДОСТУПА
© Exchanger CMS, 2018 - 2024. Скрипт обменника валют. Все права защищены. Пользовательское соглашение.