# Настройка безопасности {% hint style="warning" %} **Внимание наша команда не несет ответсвенности!** За потери понесенные в результате взлома поэтому рекомендуем использовать холодные кошельки и не хранить все в доступе обменика во избежание больших потерь. {% endhint %} ## Рекомендации по безопасности 1. Не устанавливайте на ваше устройство стороннее ПО (с которого входите в админ панель) даже с магазина приложений приложение должно иметь хорошую репутацию. 2. Используйте [ограничение доступа по ИП](/nachalo-raboty/nastroika-bezopasnosti/ogranicheniya-dostupa-admin-paneli-po-ip) для доступа к админ панели. (если у вас динамический ИП установите свой [личный ВПН](/dlya-razrabotchikov/nastroika-vpn) со стабильным ип) 3. Проверяйте репутацию исполнителей! Никогда не переводите средства первым, исполнителям которые вам не знакомы лучше воспользуйтесь услугами гаранта (только проверенные сервисы гаранта) также не стесняйтесь спросить у нас совета или помощь по проведению сделок это бесплатно. 4. Для каждого администратора/оператора должен быть [создан админ аккаунт](/nachalo-raboty/nastroika-bezopasnosti/sozdanie-admina). 5. [Созданы специальные роли](/nachalo-raboty/nastroika-bezopasnosti/nastroika-prav-administratora-roli) операторов и администраторов (если их несколько) так чтоб оператор имел ограниченый доступ к функциям админ панели. 6. [Настройте дополнительную защиту](/nachalo-raboty/nastroika-bezopasnosti/nastroika-autentifikacii) входа в админ-панель с помощью 2FA и/или WebAuthn. 7. Следуйте инструкциям описаным в разделе [Настройка безопасности на сервере](/nachalo-raboty/nastroika-bezopasnosti/ustanovka-ogranichenie-po-header-host) 8. Регулярно обновляйте ПО для того чтоб оперативно получать наши обновления безопасности 9. Не используйте пароль для доступа который используете в других сервисах и не храните пароль на сторонних сервисам которым вы не можете доверить данные пароли (к примеру мы считаем 1password безопасным сервисом для сохранения ваших паролей но мы не можем гарантировать безопасность данных сервисов) 10. Не выполняете код в консоли разработчика без достаточных знаний о том что вы выполняете это может предоставить ваши данные авторизации мошенникам. 11. Не устанавливайте стороннее плагины в браузере. 12. Не устанавливайте сторонние скрипты в репозиторий exchanger-admin-web 13. Не открывайте порты mongodb redis ssh ftp api для внешнего доступа лучше использовать SSH туннель для доступа к данным сервиса. 14. Также для SSH [используйте UFW](/dlya-razrabotchikov/nastroika-firewall) или подобные правила для ограничение доступа к серверу только с вашего IP 15. Не передавайте ваши данные от Админ панели третим лица наша служба поддержки некогда не пишет вам и не просит передать данные для входа 16. Настраивайте авто выплаты только на направлениях в которых вы уверены.
Рекомендации безопасности от BestChange #### Безопасность доступа 1. 2FA входа в панель управления сайтом; 2. дополнительная защита для доступа к файлам сайта ОП помимо пароля, например, 2FA, доступ из офисной VPN; 3. доступ к панели администратора сайта только с определенных IP-адресов/браузеров/устройств; 4. разграничение прав доступа для разных сотрудников; 5. запрет или отсутствие прямого доступа к счетам и/или кошелькам, содержащим резерв ОП из панели администратора; 6. оповещение о факте входа в панель администратора; 7. оповещение о ключевых действиях оператора, администратора; 8. отслеживание активность в корневой папке сайта с оповещением о загрузке или изменении файлов; 9. запись истории ключевых действий оператора, администратора, активности в корневой папке сайта, загрузки или изменении файлов; 10. на устройствах, с которых осуществляется работа установлены платные антивирусные программы с оперативно обновляемыми базами и модулями; 11. принимаемые от пользователей файлы загружаются и просматриваются на устройствах, не связанных с рабочими процессами обменного пункта, при необходимости принять какие-либо файлы, кроме растровых это происходит при помощи соответствующего хостинга. #### Безопасность рабочего процесса 1. осуществление передачи реквизитов только через сайт обменного пункта; 2. в состав обязательных реквизитов входит актуальный E-mail клиента; 3. замена реквизитов по просьбе клиента осуществляться только по средствам указанного клиентом в заявке E-mail (с обязательной проверкой заголовка письма на подлинность адреса отправителя) или создания новой заявки; 4. на сайте ОП отсутствуют названия аккаунтов мессенджеров, вместо этого присутствуют кликабельные кнопки; 5. ссылки на обменные боты отсутствуют или скрыты для пользователей, переходящих из мониторинга; 6. прием криптовалют осуществляется на уникальные адреса (по крайней мере в рамках одной рабочей смены); 7. приема средств через банкинг производится после верификации счета или реквизиты для приема средств через банкинг содержат телефон, привязанный к банковской карте, с которой клиент осуществляет перевод, перед исполнением заявки производится проверка принадлежности номера к банковской карте и запрашивается подтверждение операции по номеру; 8. при отсутствии круглосуточной поддержки блокировать прием в мониторинг экспортного файла курсов из панели управления обменным пунктом в мониторинге в не рабочее время; 9. при работе с криптовалютами исключить вероятность нахождения нежелательной предыстории в отправляемых клиентам транзакциях \[обязательное]; 10. организовать AML-проверки транзакций и разместить соответствующую информацию на сайте обменного пункта на страницах обмена, передавать в мониторинг соответствующие метки, а также дополнить правила использования сайта обменного пункта. #### Проверка персонала 1. подписание соглашений, устанавливающих уровень ответственности сотрудников; 2. проведение тестов с применением полиграфа на регулярной основе.
# Создание админа Для того что бы создать администратора вам необходимо перейти в раздел **Администраторы** и нажать кнопку **Создать Админа** ![](/files/x23S824qHsquBAnpP6pB) В открытом модальном окне вам необходимо ввести: * Имя * Фамилию * [Права администратора ](/nachalo-raboty/nastroika-bezopasnosti/nastroika-prav-administratora-roli) * Электронную почту * Пароль для будущего администратора (2 раза) ![](/files/lFdEAptWKJDD65YxvqZU) # Настройка прав администратора (роли) Роли очень важны для разграничения прав доступа разных администраторов к разным возможностям в вашей админ панели. Например создав роль KYC officer и выдав ему доступы ``` exchanger/currency/verification/edit exchanger/currency/verification/get exchanger/currency/verification/get/one ``` То данный администратор сможет только просматривать список верификаций детали по одной верификации и изменять статус верификации. Вариантов ролей очень много вы сами определяете список таких ролей согласно вашего бизнеса. {% hint style="info" %} **Право \*ALL\*:** Данная роль дает не ограниченый доступ ко всем функциям администратора! У вас должен быть хотя-бы один администратор с правами \*ALL\* для дальнейшего управления и распределения прав и ролей. {% endhint %} Для того что бы настроить роль вам необходимо перейти в раздел **Администраторы**\ Под таблицей администраторов есть таблица ролей и кнопка создать роль \
![](/files/DZASOENixKayJiNusw4q) {% hint style="danger" %} **Внимание!** Используйте разрешение к эти методам с осторожностью: * **\*ALL\*** - доступ ко всем методам. * **edit-lvl** - право менять права доступа роли любому администратору (включая себя) * **register** - Создавать нового администратора (при создании он может выбрать себе любую роль) * **access/role/create** - Создание новой роли (в паре с одним из методов выше дает не ограниченый доступ данному админу) * **access/role/edit** - Право на редактирование любой роли (включая своей роли) * **users/profile/changePassword** - Изменять пароль любому администратору или пользователю (таким образом сможет сменить пароль главному администратору и войти в его аккаунт) * **users/profile/secure/otp/delete** - Удалять 2-fa безопасность для администратора или пользователя (может поставить под удар аккаунт пользователя) {% endhint %} **Раздел в разработке ...** Список админ методов: ``` access/role/create access/role/delete access/role/edit access/role/list activeAuth/delete activeAuth/list aml-api/get-aml aml-api/list aml-api/set-config-aml auth/get-token-for-app blacklist/add blacklist/list contact/create contact/delete contact/edit contact/sort delete edit-lvl exchanger/currency/create exchanger/currency/delete exchanger/currency/edit exchanger/currency/get exchanger/currency/get/one exchanger/currency/get/reserves exchanger/currency/sort exchanger/currency/verification/edit exchanger/currency/verification/get exchanger/currency/verification/get/one exchanger/favorite-rate/create exchanger/favorite-rate/delete exchanger/favorite-rate/edit exchanger/favorite-rate/get exchanger/favorite-rate/sort exchanger/fields/create exchanger/fields/delete exchanger/fields/edit exchanger/fields/get exchanger/order/comment/create exchanger/order/comment/delete exchanger/order/edit exchanger/order/get exchanger/order/list exchanger/order/manager/release exchanger/order/manager/set-me exchanger/order/update-status exchanger/order/update/partner-reward exchanger/order/update/payout-status exchanger/partner-order/get exchanger/partner-order/list exchanger/partner-order/update-status exchanger/partner-route/create exchanger/partner-route/delete exchanger/partner-route/edit exchanger/partner-route/get exchanger/partner-route/get/one exchanger/route/create exchanger/route/delete exchanger/route/edit exchanger/route/get exchanger/route/get/one faq/create faq/delete faq/edit faq/get/group faq/get/list faq/get/one faq/sort files/upload/image files/upload/static getNotify list merchant-and-payout/get-merchant merchant-and-payout/get-payout merchant-and-payout/list merchant-and-payout/set-config-merchant merchant-and-payout/set-config-payout module-api/get-module module-api/list module-api/set-config-module news/comment/delete news/create news/delete news/edit notify/add-channel notify/delete notify/edit notify/fcm/register notify/fcm/remove notify/get-channels parser/config/set parser/get parser/list parser/rates partners-block/create partners-block/delete partners-block/edit partners-block/list partners-block/sort register reviews/create reviews/delete reviews/edit reviews/get rule/create rule/delete rule/edit rule/list rule/sort site/auth/social/statistic site/logo/upload site/pm2/get-processes site/pm2/reboot-process site/settings/get site/settings/set site/status/set social-auth/edit social-auth/list static-page/create static-page/delete static-page/edit static-page/sort static/delete static/list statistic/get template/list timeline/get users/list users/online/list users/partners-statistic users/profile/access/block users/profile/access/unblock users/profile/auth users/profile/auth/token users/profile/changePassword users/profile/edit users/profile/edit/confirmActive users/profile/get users/profile/secure/otp/confirm users/profile/secure/otp/create users/profile/secure/otp/delete users/profile/timeline/get users/profile/wallets/balance users/profile/wallets/transaction/list users/statistic visits/statistic/get web-alerts/create web-alerts/delete web-alerts/get/list web-alerts/sort xml/status/get xml/status/set ``` # Настройка аутентификации Настройка аутентификации администратора {% stepper %} {% step %} ### Настройка CORS На странице "**Настройки сайта**" - в разделе "**Configs**" - в блоке "[**ADMIN SECURITY**](#user-content-fn-1)[^1]" - в поле "**Origin admin domain (CORS)**" введите домен вашей админ панели без https\://. Пример: `admin.exchanger.com` -> нажмите "**Save**". {% endstep %} {% step %} ### Настройки администратора Для настройки аутентификации администратора, в правом верхнем углу админ панели нажмите на имя администратора -> "[**Редактировать профиль**](#user-content-fn-2)[^2]" -> на странице настроек администратора откройте раздел "[**Доступ**](#user-content-fn-3)[^3]". {% endstep %} {% step %} ### 2FA Для подключения двухфакторной аутентификации, нажмите "[**Активировать**](#user-content-fn-4)[^4]" -> отсканируйте QR-код или укажите секретный код в приложении для двухэтапной аутентификации (Google Authenticator) -> введите 2FA -> нажмите "[**Подтвердить**](#user-content-fn-5)[^5]". {% hint style="warning" %} Для отключения 2FA, нажмите "[**Деактивировать**](#user-content-fn-6)[^6]" -> согласитесь с деактивацией -> введите 2FA либо пройдите аутентификацию через WebAuthn (если подключено) {% endhint %} {% endstep %} {% step %} ### WebAuthn Для подключения WebAuthn (например, FIDO2-ключа, Face ID / Touch ID, или passkey в iCloud / браузере), в разделе "*WebAuthn Devices"* нажмите "[**Set up new device**](#user-content-fn-7)[^7]" -> введите имя устройства -> [**выберите**](#user-content-fn-8)[^8] подходящий Passkey -> следуйте инструкциям на экране -> после успешного добавления вы увидите уведомление "[**Added device**](#user-content-fn-9)[^9]". {% hint style="warning" %} Для удаления устройства WebAuthn, нажмите "[**Remove device**](#user-content-fn-10)[^10]" -> пройдите аутентификацию через WebAuthn. {% endhint %} {% hint style="success" %} Вы можете добавить несколько устройств для WebAuthn. {% endhint %} {% endstep %} {% step %} ### Вход в аккаунт После подключения 2FA и/или WebAuthn, при входе в админ-панель, кроме логина и пароля, потребуется пройти дополнительную аутентификацию — ввести код 2FA или подтвердить вход через WebAuthn. {% endstep %} {% endstepper %} [^1]: ![](/files/xiAsZOparXYn9ECQjFmc) [^2]: ![](/files/fKbLYuFZc49kip4Io6qa) [^3]: ![](/files/jvhxAHsDzoa5dNVfCWUY) [^4]: ![](/files/DxHBJrjPkQnl1Zr8lNwO) [^5]: ![](/files/hcCZ5SsRALVPJ1mxuh5f) [^6]: ![](/files/IzholdQVxkwjNOYjfrUc) [^7]: ![](/files/iumQpnWn6YWDcuBCE2W9) [^8]: ![](/files/OxQWwuOpN9qcH92LbVFl) [^9]: ![](/files/SHoQ40EwwPgHSSc0KLsT) [^10]: ![](/files/ZpVGC6aw3jmlUdRoCH95) # Ограничения доступа админ панели по IP {% content-ref url="/pages/aTQXbXEz5iN5kTSfrA03" %} [Установка ограничения на CloudFlare](/nachalo-raboty/nastroika-bezopasnosti/ogranicheniya-dostupa-admin-paneli-po-ip/ustanovka-ogranicheniya-na-cloudflare) {% endcontent-ref %} {% content-ref url="/pages/UFnY0IEpeCZuwcQvSKnA" %} [Установка ограничений в админ панели](/nachalo-raboty/nastroika-bezopasnosti/ogranicheniya-dostupa-admin-paneli-po-ip/ustanovka-ogranichenii-v-admin-paneli) {% endcontent-ref %} # Установка ограничения на CloudFlare {% hint style="warning" %} **Важно:** Устанавливая ограничение на Cloudflare не забудьте [установить ограничение на API](#ogranichenie-vkhoda-na-api) это принципиально важно ограничение на CF лиш ограничивает визуальное отражение админ панели но не ограничивает запросы к Admin API. {% endhint %} 1. Для ограничения доступа к админ панели по IP вам необходимо войти в ваш аккаунт [CloudFlare](https://dash.cloudflare.com/) 2. Перейти в раздел [**Security -> WAF**](#user-content-fn-1)[^1] 3. Нажать кнопку [**Create rule**](#user-content-fn-2)[^2] в разделе Custom rules 4. Заполнить форму:
Rule name: **Admin block ip** When incoming requests match… Field: **Hostname** Operator: **is in** Value: %Домен вашей панели без https и слешей%
**AND** Field: **IP Source address** Operator: **is not in** Value: Ваш ип или несколько ип \ Then… **Block** \ После нажать кнопку: **Deploy** ### Пример как должно выглядеть правило
### Ограничение входа на API: [^1]: ![](/files/epUiV6253APRbGmfDNVi) [^2]: ![](/files/QmRAIRbLGcZcXUDOPxId) # Установка ограничений в админ панели На странице "Настройки сайта" - в разделе "Configs" - в блоке "ADMIN SECURITY" возможно настроить ограничение доступа к админ панели по IP.
Для настройки следуйте инструкции: {% hint style="info" %} Обратите внимание, что если у вас динамический IP, то рекомендуется настроить VPN профиль со статическим IP. Инструкция: [Настройка VPN](/dlya-razrabotchikov/nastroika-vpn) Устанавливайте ограничение доступа к админ панели только если у вас статический IP. {% endhint %} 1. В поле "Origin admin domain (CORS)" введите домен админ панели без https\://. Пример: `admin.exchanger.com` 2. В поле "Allow admin IPs" введите разрешенные IPv4 и IPv6 (через запятую без пробелов). Пример: `1.1.1.1,2.2.2.2,2001:0db8:85a3:0000:0000:8a2e:0370:7334` 3. Нажмите "Save". 4. В течение 15 минут настройки применяться и возможность авторизоваться в админ панель будет только с указанных IP из поля "Allow admin IPs". {% hint style="info" %} Для немендленного применения изменений, зайдите на страницу "Настройки сайта" - раздел "Server" -> нажмите "Reboot" напротив процесса `exchanger-api-http` -> подождите 1 минуту для перезапуска процесса. {% endhint %} ### Игнорирование технических работ В поле "Ignore tech work for IPs" возможно указать IP, для которых будет возможность взаимодействовать с блоком обмена на клиентской части, при включенных технических работах. \ По умолчанию, при включенных технических работах на сайте, блок обмена недоступен. # Установка ограничение по header host Переходим в папку с API нашего сервера (путь к папке на вашем сервере может отличатся в зависимости от того куда установили API) ``` cd /var/www/exchanger-api/ ``` Установка ограничения по hostname: ``` npm run conf-set admin:origin admin.domain.net force ``` # Настройка дизайна На странице "Настройки сайта" - раздел "Дизайн" возможно установить логотип и иконку для сайта, а также логотип для письма.
## Логотип сайта {% hint style="info" %} Логотип сайта должен быть не менее чем: 400 x 55 px и иметь формат: SVG,PNG,JPG,JPEG {% endhint %} {% hint style="info" %} По умолчанию скрипт ожидает логотип в формате PNG,JPG,JPEG. В случае, если ваш логотип в формате SVG, то перед загрузкой логотипа - обратитесь к поддержке BoxExchanger для изменения конфигурации проекта. {% endhint %} Для того чтобы загрузить логотип для сайта, необходимо нажать "[**Загрузить изображение**](#user-content-fn-1)[^1]" в блоке "Загрузить логотип сайта" -> выбрать необходимое изображение -> если необходимо, то вы можете изменить масштаб и размер логотипа во встроенном редакторе после загрузки (для логотипов в формате PNG,JPG,JPEG) -> нажать "[**Save**](#user-content-fn-2)[^2]" в правом нижнем углу редактора (для логотипов в формате PNG,JPG,JPEG). После того как логотип будет успешно загружен - отобразится всплывающее окно с надписью "[**Success**](#user-content-fn-3)[^3]". {% hint style="info" %} При загрузке логотипа в формате SVG, встроенный редактор недоступен и логотип загружается без необходимости нажатия "Save". {% endhint %} В стандартном дизайне, логотип будет отображаться в левом верхнем углу - [**скриншот**](#user-content-fn-4)[^4]. При нажатии на логотип, пользователя будет перенаправлять на главную страницу. ## Иконка сайта {% hint style="info" %} Иконка сайта (favicon) должна быть не менее чем: 512 x 512 px и иметь формат: PNG,JPG,JPEG {% endhint %} Для того чтобы загрузить иконку сайта, необходимо нажать "[**Загрузить изображение**](#user-content-fn-5)[^5]" в блоке "Загрузить иконку сайта" -> выбрать необходимое изображение -> если необходимо, то вы можете изменить масштаб и размер логотипа во встроенном редакторе после загрузки -> нажать "[**Save**](#user-content-fn-2)[^2]" в правом нижнем углу редактора. После того как логотип будет успешно загружен - отобразится всплывающее окно с надписью "[**Success**](#user-content-fn-3)[^3]". Иконка сайта (favicon) будет отображаться во вкладке браузера - [**скриншот**](#user-content-fn-6)[^6]. ## Логотип для письма {% hint style="info" %} Логотип для письма должен быть не менее чем: 300 x 60 px и иметь формат: PNG,JPG,JPEG {% endhint %} Для того чтобы загрузить иконку сайта, необходимо нажать "[**Загрузить изображение**](#user-content-fn-7)[^7]" в блоке "Upload logo for email" -> выбрать необходимое изображение -> если необходимо, то вы можете изменить масштаб и размер логотипа во встроенном редакторе после загрузки -> нажать "[**Save**](#user-content-fn-2)[^2]" в правом нижнем углу редактора. После того как логотип будет успешно загружен - отобразится всплывающее окно с надписью "[**Success**](#user-content-fn-3)[^3]". Логотип для письма будет отображаться в шаблоне письма с левом верхнем углу - [**скриншот**](#user-content-fn-8)[^8]. ## Верстка сайта Верстку сайта возможно изменять через код client-web. Подробнее о разработке: [Разработка client-web](/dlya-razrabotchikov/razrabotka-client-web) [^1]: ![](/files/Pey5QhfighwVB3xYJvxU) [^2]: ![](/files/F8YaFH0WI8hroxze2NbX) [^3]: ![](/files/R9HeNUnbQguDvTECV1Wt) [^4]: ![](/files/S0sbDcwUF8uxgpgVGvM1) [^5]: ![](/files/02tTtwtpoPSmA42py22a) [^6]: ![](/files/MECkIFJeV5TjUcPDs9f3) [^7]: ![](/files/n6LrmrWMGmRGknvkmExY) [^8]: ![](/files/kl6dRibi0jLDgoiAM633) # Технические работы {% hint style="info" %} Технические работы отключают ваш обменник для работы в сети клиенты не могут в данное время создавать обмены. {% endhint %} ### Активация тех.работ Для того чтоб отключить сайт на нем необходимо установить технические работы во время тех.работ также отключается экспорт курсов XML/JSON/TXT: 1. Войти в вашу панель администратора. 2. В правом верхнем углу нажать кнопку настройки. 3. В выпадающем меню найти пункт Тех.работы. 4. Перевести положение выключателя в положение включен чтоб получилось как на картинке ниже. ![](/files/kUHLVkTn8PXTH2U6KBQX) **во время тех работ ваши клиенты увидят следующую страницу:** ![](/files/BgOoLpn5cP2YE2gMQ2yA) ### Отключения режима тех.работ Для того чтоб активировать работу вашего сайта вам необходимо : 1. Войти в вашу панель администратора. 2. В правом верхнем углу нажать кнопку настройки. 3. В выпадающем меню найти пункт Тех.работы. 4. Перевести положение выключателя в положение выключено чтоб получилось как на картинке ниже. ![](/files/vNRgw5qjUpr1tbgi0DVy) # Уведомление на сайте # Создание Для того что бы создать уведомление необходимо перейти в раздел **Уведомление на сайте > Создать уведомление** ![](/files/qEFos3GbEnHAcxtA1wnI) В области создания **уведомления необходимо добавить:** * Текст правила * Уровень (приоритет) * Язык * Время с и до. **Часовой пояс - UTC.** ![](/files/VQHcJlqmCnkOWRFn2S0r) ### Правила заполнения полей **Поле текст** не должно превышать 10000 символов # Редактирование Список уведомлений находиться в разделе **Уведомление на сайте > Список уведомлений** ![](/files/L2E9LwYWUN4dZ8QwNeAI) {% hint style="info" %} Редактирование поля **текст уведомления** не возможно {% endhint %} Что бы изменить позицию в списке необходимо перетянуть блок на нужную вам ![](/files/TRUi9ZB8EyO1LwHXdDIX) Для удаления уведомления необходимо нажать значок корзины ![](/files/FcskiJwQS7WbauhB0QOd) # Избраные курсы # Создание Для того что бы создать избранный курс необходимо перейти в раздел **Популярные курсы > Добавить** ![](/files/5oeKZewdgz0hXVDbDJ7o) В области **добавить избранный курс необходимо добавить** такие поля**:** * Имя * Имя Сервиса * Имя парсера * С Валюты * На Валюту * Активный ![](/files/egbbsEAZFq470gtO5jmw) ### Правила заполнения полей **Имя и Имя Сервиса** не должно содержать больше **20 символов** **Все поля обязательны к заполнению\*** # Редактирование Для того что бы отредактировать избранный курс необходимо перейти в раздел **Популярные курсы** ![](/files/XazKyja7xUunZqL5omuP) Вы можете редактировать: * Имя * Сервис * Статус активности ![](/files/I23SkYIttPTEw1v6Ic2w) Что бы изменить позицию в списке необходимо перетянуть блок на нужную вам ![](/files/OsEjz5cjGR8kvIhlikRl) Для удаления курса необходимо нажать значок корзины ![](/files/4aasA44qsbAeiCecxpkG) # Подключение онлайн чата {% content-ref url="/pages/qza6Vl4oCWbCha4mft0i" %} [Подключение чата JivoSite](/nachalo-raboty/podklyuchenie-onlain-chata/podklyuchenie-chata-jivosite) {% endcontent-ref %} # Подключение чата LiveChat {% hint style="info" %} Для подключения обратитесь в службу поддержки BoxExchanger {% endhint %} Для подключения необходимо перейти на официальный сайт [LiveChat](https://accounts.livechat.com/signup). 1. Зарегистрировать аккаунт 2. Получить код чата В котором скопировать ваш License ID (он же Chat ID в нашей системе)\ ![](/files/ojH1wfCETHoMraaBLCZf) 3. Перейдите в вашей админ панеле в раздел Настройки сайта -> Online chat. 4. В поле **System** выберите LiveChat 5. В поле **Chat** ID установите License id полученный на **втором шаге** данной инструкции.\ ![](/files/tKN4IXDgBqHBYY8pnB1h) 6. Нажмите кнопку **Save**
# Подключение чата JivoSite Для подключения JivoSite необходимо перейти на официальный сайт с [**инструкцией для начала работы** ](https://www.jivo.ru/help/installation/nachalo-raboty-s-jivosite.html) После прохождения шагов переходим к последнему, в этом скрипте имеется id который необходимо добавить в поле **Chat id**
![](/files/nqlUqrgMzsRwna6ov9D4) ![](/files/Xp6mFfVB1pklxQl6oMDL) Что бы отключить чат необходимо выбрать из списка **Disable** ![](/files/Dtb7QenStQrgoE9lrzk8) # Подключение чата HelpCrunch Инструкция по подключению чата HelpCrunch 1. Зарегистрируйтесь на сайте HelpCrunch по [ссылке](https://helpcrunch.com/?utm_medium=affiliate\&utm_campaign=affiliates_v1\&fp_ref=alex43) -> "[**Start free trial**](#user-content-fn-1)[^1]". 2. [Войдите](https://helpcrunch.com/signin.html) в ЛК -> следуйте [инструкции](https://docs.helpcrunch.com/uk/vstanovit-helpcrunch/ustanovit-helpcrunch-na-sait), чтобы получить HTML код. 3. Отправьте HTML код поддержке BoxExchanger для установки. {% hint style="info" %} База знаний HelpCrunch: {% endhint %} [^1]: ![](/files/xmWoZw3vlSgaVrMSZpsH) # Добавление контактов Для того что бы добавить элемент в список контактов перейдите в раздел **Контакты** и заполните форму с права **Добавить Контакт**
![](/files/Fgt9PCsxY7WmUowfMFan) Рассмотрим пример заполнения почтового адреса ![](/files/fM8RpgOnUHi8QVOWaaiW) В списке контактов есть возможность редактировать поле контакт и ссылку . Изменение происходит автоматически после того как вы ввели данные ![](/files/Gi6krs4jQdguCmf23g98) Если вы хотите сменить лого в контакте вам необходимо удалить его и создать заново. Так же вы можете сменить позицию в списке контактов.Для смены позиции в списке контактов переместите за элемент из точек в направлении списка вверх или вниз. Выбранный вами контакт будет отображен на той позиции которую вы выберите. ![](/files/SHWyTdStfBlkelmzDbNY) # Настройка почты На странице "Настройки сайта" - в разделе "Configs" - в блоке "**MAIL SETTINGS (SMTP)**" возможно указать параметры для аккаунта почты с которой будут отправляться системные письма через протокол SMTP.
* Значения для полей SMTP host, SMTP port и SMTP secure protocol обычно являются публичными для популярных почтовых провайдеров, к примеру, GMail, ZeptoMail, Proton. Данные значения возможно найти на официальных сайтах почтовых провайдеров по запросу SMTP. * В поле "Account email" необходимо указывать адрес почты, который используется для входа в аккаунт почты в системе почтового провайдера. * В поле "Sender" необходимо указывать адрес, с которого будет происходить отправка письма. В случае, если у вашего адреса почты отсутствует Alias (псевдоним), то необходимо указать адрес почты из поля "Account email".\ \ Также в данном поле вы можете указать имя и фамилию, которая будут использоваться при отправке письма. Для этого используйте следующий формат ввода данных: `First_Name Last_Name `. \ Пример: `Support Exchanger ` В данном примере, в качестве отправителя будет указано `Support Exchanger`, а адрес отправителя будет `support@exchanger.com` * В поле "Account password" необходимо указывать пароль, который будет использоваться для авторизации, при отправке писем через протокол SMTP. В зависимости от почтового провайдера это может быть как пароль от аккаунта так и отдельный пароль приложения, который будет использоваться исключительно для SMTP. \ В целях безопасности после перезагрузки страницы значение в поле "Account password" будет скрыто. * В поле "Support department email" возможно указать email на который будет отправляться копия обращения пользователя. В случае, если оставить поле пустым, то обращения пользователей будут отправляться на почту, указанную в поле "Account email". \ Особенности отправки обращений пользователей, при указанной почте в поле "Support department email" описаны ниже в блоке "Пример Support department email"
Пример Support department email Разберем на примере: \ Account email (user): `no-reply@exchanger.com` \ Support department email: `reply@exchanger.com` Клиент на странице contacts оставляет запрос, указывая: Email: Request text: Test request В итоге: \ а) С почты на почту клиента будет отправлен шаблон о том, что запрос клиента принят в тех. отдел. (см. [**скриншот**](#user-content-fn-1)[^1]) \ б) С почты на вашу почту из поля Support department email будет отправлен запрос клиента. (см. [**скриншот**](#user-content-fn-2)[^2]) Далее, с почты вы отвечаете на письмо с запросом клиента и клиент получает ответ с почты . (см. [**скриншот**](#user-content-fn-3)[^3]) Ньюансы: 1. В случае, если клиент ответит на шаблон письмо от , то вы все равно получите его ответ, но уже в отдельной цепочке писем. (см. [**скриншот**](#user-content-fn-4)[^4]). Вам необходимо будет по id запроса из заголовка найти письмо с запросом клиента и ответить на него чтобы сохранялась цепочка. 2. После ответа с почты на письмо с запросом клиента, клиент также получит ответ, но в отдельной цепочке писем.
Подробнее о настройке почты: {% content-ref url="/pages/Uf55bQ6qLFFdDxyUfZA0" %} [Подключение GMail почты](/nachalo-raboty/nastroika-pochty/podklyuchenie-gmail-pochty) {% endcontent-ref %} {% content-ref url="/pages/YQuL7LdBW0534HIW0aVK" %} [Подключение Zoho почты](/nachalo-raboty/nastroika-pochty/podklyuchenie-zoho-pochty) {% endcontent-ref %} {% content-ref url="/pages/HPQlGQWugXY7SJuKJdPu" %} [Подключение dynadot почты](/nachalo-raboty/nastroika-pochty/podklyuchenie-dynadot-pochty) {% endcontent-ref %} [^1]: ![](/files/quPAePgdF48GZhXjxBme) [^2]: ![](/files/B5ryMB28Hy6XXdKbiQtR) [^3]: ![](/files/gzjP8bEQCBG9lpLKLiKU) [^4]: ![](/files/SvaFq6T5XsGVyBhrNron) # Отправка копии отправленных писем ## Установка email на который отправлять емейл ``` npm run setting-set setting:send_copy copy@send.to force ``` # Подключение GMail почты Рассмотрим настройку почты на примере gmail. 1. Необходимо авторизоваться через учетную запись Google 2. Активировать Двухэтапную аутентификацию\ [Управление аккаунтом Google](https://myaccount.google.com/?hl=ru\&authuser=0\&utm_source=OGB\&utm_medium=act) -> [Безопасность](https://myaccount.google.com/security) \ -> раздел Вход в аккаунт Google -> Двухэтапная аутентификация 3. Далее после установки 2fa на странице ["Двухэтапная аутентификация" в самом низу перейдите на страницу "Пароли приложений"](#user-content-fn-1)[^1] 4. [Создайте пароль для приложения выберите устройство Другое](#user-content-fn-2)[^2] и [введите имя на свое усмотрение к примеру smtp-exchanger](#user-content-fn-3)[^3] 5. [Скопируйте полученный пароль приложения и установите его в админке (пароль не имеет пробелов)](#user-content-fn-4)[^4] 6. Установить данные в админ панели. ### Устанавливаем доступы в админ панель Устанавливаем доступы полученные на предыдущем этапе к примеру: `SMTP host:`**`smtp.gmail.com`**\ `SMTP port:`` `**`465`**\ `SMTP secure protocol:`` `**`true`**\ `Account email:`**`support@your.domain`**\ `Email sender sender:`**`support@your.domain`**\ `Account password:`` `**`YOUR_APP_PASSWORD`** если вы получаете ошибку timeout вы можете установить \ `SMTP port:`` `**`587`**\ `SMTP secure protocol:`` `**`false`** {% hint style="info" %} **`Account email`**` ``- Email адрес вашего акаунта по которому вы входите в аккаунт`\ **`Email sender sender`**` ``- Email адрес с которого отправлять письмо (если у вас есть alias вы можете указать его либо установите тот же email что и Account email)` **`Account password`**` ``- Пароль приложения созданный на шаге #5.` {% endhint %} ![](/files/8XPDxgRDblCo7JfAhaPx)
[^1]: ![](/files/vN161lyiPq0fYJoxRpc9) [^2]: ![](/files/1pqUhSMTTJaqvdWhqgiY) [^3]: ![](/files/BGzPwSxX5mi2IIvjnWy3) [^4]: ![](/files/2Dj6FeGwao4KlA2um9k1) # Подключение Zoho почты ### Создаем аккаунт Zoho Mail 1. Переходим на страницу [Zoho Mail -> Pricing](https://www.zoho.com/mail/zohomail-pricing.html) и выбираем тариф **MAIL LITE**\ ![](/files/nZpCdl9Y9g2DorcrqhL7) 2. Регистрируем аккаунт и нажимаем кнопку добавит домен \ ![](/files/bKUiEJrqCAsb5nYHF6t5) ![](/files/yE4yOQnE3ru9PgjmFJ74) 3. Настройте DNS для верификации домена как указано в инструкции 4. Создайте супер админа и добавьте email для поддержки\ ![](/files/NLCNtVxrvf4J76UBt2Tx) 5. Настройте DNS записи для email \ ![](/files/nJU4jIVT2js0omufGGrA) ### Получаем SMTP доступы 1. Переходим в раздел **Mail Settings -> Tools & Configurations -> Configurations** 2. И смотрим в блок **Outgoing / SMTP**\ ![](/files/OOTK4hG1sbBHFX77GYkp) 3. Логин и пароль который вы использовали при регистрации почты для отправки ### Устанавливаем доступы в админ панель {% hint style="info" %} **Важно:** Перед тем как вводить ваши данные попробуйте под ними войти в ZOHO тк если вы не убирали галочку "*Force user to change password on next log in"* то при входе в данного пользователя нужно установить новый пароль который и указать в настройках. *Система не может работать с временным паролем.* {% endhint %} 1. Устанавливаем доступы полученные на предыдущем этапе к примеру:
`SMTP host:`` `**`smtppro.zoho.eu`**\ `SMTP port:`` `**`465`**\ `SMTP secure protocol:`` `**`true`**\ `Account email:`**`support@your.domain`**\ `Email sender sender:`**`support@your.domain`**\ `Account password:`` `**`YOUR_PASSWORD`**\ **`(если ошибка)`**\ `SMTP port:`` `**`587`** \ `SMTP secure protocol:`` `**`false`**\ ![](/files/2xYTaFc8ZNGCt7vIP7hu) # Подключение dynadot почты {% hint style="danger" %} **ВНИМАНИЕ:** Данный сервис имеет не рабочий сервер SMTP на данный момент данный сервис **НЕ РАБОТАЕТ !** {% endhint %} {% hint style="warning" %} Для начала работы у вас уже должна быть куплена и настроена услуга **Email hosting** в данном сервисе! {% endhint %} ### Получаем SMTP доступы от почтовика 1. Для начала вам нужно перейти в вашу панель управление на сайте **dynadot** и перейти в раздел **My Hosting** 2. Напротив нашего домена будет кнопка **login/edit** необходимо нажать на нее как показано на картинке ниже:\ ![](/files/JSl8iOVTtdWS19A3nMRm) 3. После вы попадаете в панель Email Hosting где вам нужно перейти в раздел **Admin**\ ![](/files/dcRpFoH0ejYOh2nsjdqg) 4. В данном разделе вам необходимо создать вашу доменную почту с которой будем отправлять Email клиентам обычно это support, noreply, admin\ ![](/files/XR248T8OZIYd0JBWbYVc) 5. Далее возвращаемся в раздел **Mailbox ->** [**Mailboxes**](https://webhost.dynadot.com/mailbox/select.html) и переходим в ваш Email \ ![](/files/Cu68WSZ3y8RsUEOPYrwb) 6. Переходим в раздел **Settings**\ 7. Находим в низу раздел **Remote Access** и в данном разделе есть ваши настройки **Smtp** которые нам необходимо установить в нашу админ панель \ ![](/files/u0XwsPVoidWXRB96guCq) ### **Переходим к установке доступов** 1. Переходим в раздел **настройка сайта** в вашей админ панели:\ ![](/files/AXxC0h44fQDBl77curxP) 2. В левой части вы найдете блок **MAIL SETTINGS (SMTP)** в который нам необходимо вставить данные полученные на шаге.**7** прошлого раздела\ \ ![](/files/3xjTnrvcEVRMjKzUWN7X) 3. Нажать кнопку **SAVE** если все настроено верно вы получите модальное окно с галочкой
# Вопросы и ответы # Создать Для того что бы создать правило необходимо перейти в раздел **Вопросы и ответы > Добавить ответ** ![](/files/rsdqVhCwvR9wTgnpIeKv) В области **создания необходимо добавить:** * Заголовок вопроса * Ответ на вопрос * Язык * Категорию {% hint style="info" %} **Заголовок** должен не превышать **250** символов **Поле ответа** не должно превышать **50000** символов **Поле создать новую группу** не должно превышать **255** символов {% endhint %} #### **Создание новой группы** Для создание новой группы необходимо нажать **CОЗДАТЬ НОВУЮ ГРУППУ** ![](/files/lxXtkMFtcZ7zUaBggYUi) В поле **Введите название группы** необходимо ввести название категории и нажать **Добавить** ![](/files/bucWzopzUmTwNWHlNmb7) # Настройка AntiBot системы На странице "Настройки сайта" - в разделе "Configs" - в блоке "BOT PROTECTION" возможно добавить IP адреса в белый список внутренней Antiflood системы, а также настроить Captcha и ее отображение на сайте.
### DDOS WhiteList IPs В поле "DDOS WhiteList IPs" возможно указать список IP, которые будут добавлены в белый список Antiflood системы. Указывать IP необходимо без пробела и через запятую. \ Пример: `1.1.1.1,2.2.2.2,2001:0db8:85a3:0000:0000:8a2e:0370:7334`. Поддерживаются IPv4 и IPv6. #### Особенности работы По умолчанию, на клиентской части после определенного количества неудачных попыток регистрации/авторизации/создания заявки/отправки запроса через форму обратной связи, сработает Antiflood система и к пользователю, который делал неспешные запросы, будет применен cooldown. Пример cooldown при неуспешных попытках авторизации на [**скриншоте**](#user-content-fn-1)[^1]. В случае если IP, с которого отправляются запросы регистрации/авторизации/создания заявки/отправки запроса через форму обратной связи, будет добавлен в "DDOS WhiteList IPs", то при неуспешных запросах - Antiflood система не будет применять cooldown к пользователю с IP из белого списка. ### Настройки Captcha В поле "*PROTECTOR"* возможно выбрать систему, которая будет использоваться для Captcha. В полях Site Key и Secret Key указываются ключи для сервиса, который вы настраиваете. Подробнее о настройке reCaptcha: [Установка reCAPTCHA](/nachalo-raboty/nastroika-antibot-sistemy/ustanovka-recaptcha) В случае, если для поля "*PROTECTOR"* указан один из сервисов, к примеру, reCaptcha, то блок с Captcha будет по умолчанию отображается в форме авторизации и регистрации - пример на [**скриншоте**](#user-content-fn-2)[^2]. Для отправки запроса авторизации либо регистрации, пользователю необходимо будет пройти Captcha. \ Если необходимо включить прохождение Captcha при создании заявки -> укажите значение "Да" для поля "*PROTECT CREATE ORDER"* и нажмите "Save". Пример отображения Captcha при создании заявки - на [**скриншоте**](#user-content-fn-3)[^3]. [^1]: ![](/files/fnKPJsmewvRxjNbGovEq) [^2]: ![](/files/s7UhFUKP8uS76CVVF6nG) [^3]: ![](/files/BetsPmZUZbDVyWQvRDX8) # Установка reCAPTCHA 1.Перейдите на сайт [**Google reCAPTCHA**](https://www.google.com/recaptcha) и кликните по кнопке **Admin console**. 2.Авторизуйтесь в своем аккаунте Google. 3.Заполните форму регистрации сайта и сохраните введенные данные кнопкой **Отправить** ![](/files/XWpwZNp1JqNg4OC5QI32)
![](/files/7CQgNtLTePfJmq4hk001) 4.Скопируйте сформированные ключи. ![](/files/K5KaFv0OGjFAWcUuHZO5) 5.В поле **site key** вставьте ключ сайта а в **secret key** секретный ключ и сохраните ![](/files/CkSqNAv22aMIK45eUDnt) # Правила # Создание Для того что бы создать правило необходимо перейти в раздел **Правила > Создать** ![](/files/ZwOx1ZSG02XM5PhscUyh) В области создания **правила необходимо добавить:** * Заголовок * Текст правила * Язык ![](/files/9ahwVOh5y0kqVgCuoEot) {% hint style="info" %} **Заголовок** должен не превышать **350** символов **Поле текст** не должно превышать **250000** символов {% endhint %} # AML/KYC Политика {% hint style="info" %} Для того чтобы у вас автоматически подтянулись ссылки для AML/KYC политики [в гиперссылку активного согласия с AML/KYC политикой](#user-content-fn-1)[^1] на моменте создания заявки - в настройках правила AML/KYC политики в [поле "link" должен быть ключ "aml-kyc-policy" ](#user-content-fn-2)[^2]\(только такой, без изменений). {% endhint %} [^1]: ![](/files/BYmf9ow4zhn8CJjZAxZG) [^2]: ![](/files/v9pz7mJ1gDezmEtkPLxM) # Партнеры # Создание партнера Для того что бы создать партнера необходимо перейти в раздел **Блок партнеров**
![](/files/vw3l7uPuvfNbsqYtKSBG) В области **добавить партнера необходимо добавить:** * Изображение * Имя * Ссылка * Ссылка на отзывы ![](/files/jP9Judj8hp4PeGZCKKvm) {% hint style="info" %} Приоритет определяется позицией партнера в списке и в блоке **Наши партнеры** {% endhint %} ### Правила заполнения полей **Изображение** должно быть в допустимом формате и расширении: **png, jpeg, 250x80\*** **Имя партнера** не должно содержать больше **20 символов** **Ссылка партнера** и отзывов должна начинаться с **https\://**( это необходимо для корректного перехода на страницу) и не превышать **255 символов** # Редактирование Для того что бы совершить редактирования одного из партнера необходимо нажать на значок настроек ![](/files/Hbd9geUBsa7mS10HIBrr) Вы можете редактировать: * Имя * Ссылку партнера * Ссылку на отзыву ![](/files/493GJCpaVZ4SY1gswTY1) Есть возможность настраивать статус отображения на главной и на всех страницах ![](/files/jsy0EqYQec7SMhtvLjKU) Что бы изменить позицию в списке необходимо перетянуть блок на нужную вам ![](/files/6wta8e1ImGzxtNT2igM8) Для удаления партнера необходимо нажать значок корзины ![](/files/Fr84rD0pDCtdyxYNH3jE) # Новости # Создание Для того что бы создать партнера необходимо перейти в раздел **Новости > Добавить новость** ![](/files/zSEGhxZpqKCjPfky3gjp) В области **создание новости необходимо добавить:** * Изображение * Заголовок * Текст новости * Язык * Автора ![](/files/IGFaaa1mUGGulJ4y2zD3) ### Правила заполнения полей **Изображение** должно быть в допустимом формате и расширении: **png, jpeg, 320x188\*** **Заголовок** не должен содержать больше **255 символов** **Текст новости** не должен содержать больше **255000** **символов** **Имя автора** не должно содержать больше **20 символов** # Отзывы # Создать Для того что бы создать отзыв необходимо перейти в раздел **Отзывы** ![](/files/ifxfuUwz4H7Kr8EeCRCU) В области **добавить отзыв необходимо добавить:** * E-mail * Имя * Текст отзыва * Язык ![](/files/WtV2VAUUuuBxnpZUkFjc) ### Правила заполнения полей **Email** не должен содержать больше **100** **символов** **Текст отзыва** не должен содержать больше **255** **символов** **Имя** не должно содержать больше **100 символов** # Список отзывов Для работой с отзывами перейдите в раздел **Отзывы** ![](/files/Km67jGth3rQUyqlikDmX) Вы можете отфильтровать список отзывов по таким категориям: * Все * Подтвержденный * Ожидающие подтверждения * Заблокированные ![](/files/uXRAH9Oo39FJ6kibTmDY) Вы можете так же отсортировать отзывы по выбранной вами категории ![](/files/vEMWvPXAERZcMrV3aoTM) Для того что бы разблокировать отзыв необходимо нажать кнопку **Подтвердить** ![](/files/WZA9HGACIs0rTpArXLS1) Для того что бы заблокировать отзыв необходимо нажать **Заблокировать** ![](/files/LwAqjcIJwR6iYQq1XMqS) Для удаления **отзыва** необходимо нажать значок корзины ![](/files/kYdhHvo4hQITBRzWqhW2) # Статичные страницы # Создание Для того что бы создать партнера необходимо перейти в раздел **Настройка страницы > Создать** ![](/files/U953ebjd7XxH0dAQjuI3) В области **создание страницы необходимо добавить:** * **Заголовок** * **Ссылку** * **Имя ссылки** * **Описание** * **Расположение на сайте** * **Язык** * **Виджет** ![](/files/w1Vv0vcYX6K4D34Yw0Qd) ### Правила заполнения полей **Заголовок** не должен содержать больше **255 символов** **Имя ссылки** не должно содержать больше **200 символов** **Ссылка** не должна содержать больше **255 символов и содержать только латиницу и такие символы : -.@** # Настройки авторизации пользователя На странице "**Настройки сайта**" - в разделе "**Configs**" - в блоке "**AUTH SETTINGS**" возможно установить время cooldown пользователя после неудачных попыток ввода пароля при авторизации в аккаунт, а также токен для работы с Telegram ботом для обменов.
* В поле "Block after invalid pass" необходимо указать количество неудачных попыток ввода пароля после которых, к пользователю будет применено временное ограничение на отправку запроса для авторизации (Antiflood система). * В поле "Block minutes" необходимо указать время (в минутах) на которое пользователю будет ограничена возможность отправлять запросы на авторизацию. * В поле "INTERNAL TOKEN FOR API REGISTER (TG-BOT)" возможно указать токен для работы с Telegram ботом для обменов. На данный момент подробнее возможно узнать в чате с поддержкой BoxExchanger. {% hint style="info" %} Настройки для данного блока применяться в течение 15 минут после нажатия на кнопку "Save". {% endhint %} ### Подтверждение и авторизация в аккаунт после регистрации На странице "Настройки сайта" - в разделе "**Configs**" - в блоке "**Обмен**" возможно настроить процесс подтверждения и авторизации аккаунта после регистрации.
#### Подтверждение регистрации по почте Для того чтобы процесс регистрации и авторизации пользователя в аккаунт выглядел как "**Заполнение формы регистрации -> подтверждение аккаунта по ссылке из письма на почте -> ручной ввод логина и пароля для авторизации в аккаунт/автологин после подтверждения аккаунта**", для поля "**Register without confirm account & auto-login**" установите значение "**Нет**" -> нажмите "[**Save**](#user-content-fn-1)[^1]".\ В появившемся поле "**Login after confirm register by email***"* выберите один из подходящих параметров по таблице ниже -> нажмите "[**Save**](#user-content-fn-2)[^2]". | Да | Нет | | :-----------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------: | | После подтверждения регистрации аккаунта по ссылке из письма, система автоматически авторизует пользователя в подтвержденный аккаунт. | После успешного подтверждения аккаунта, пользователю необходимо будет ввести логин и пароль для авторизации в аккаунт. | #### Автоматическое подтверждение аккаунта и автологин после регистрации Для того чтобы процесс регистрации и авторизации пользователя в аккаунт выглядел как "**Заполнение формы регистрации -> автоматическое подтверждение аккаунта -> автологин в аккаунт**", для поля "**Register without confirm account & auto-login**" установите значение "**Да**" -> нажмите "[**Save**](#user-content-fn-3)[^3]". [^1]: ![](/files/rcVfS6gV1iibcUtwdaGY) [^2]: ![](/files/RdAdWM6r0v7lCnwSb4xv) [^3]: ![](/files/1qYQzkkLVF1qlUwHcBTE) # Настройка идентификаторов
На странице "Настройки сайта" - в разделе "Configs" - в блоке "IDS SETTINGS" возможно установить порядковый номера с которого будет начинаться счет для: * Id Orders.uid – номера заявки * Id PartnersOrders.uid – номера партнерского вывода * Id Reviews.uid – номера отзыва * Id User.uid – номера пользователя * Id Verification.uid – номера верификации Для настройки данного блока, укажите подходящее начальное значение порядкового номера в нужное поле -> нажмите "Save" под заполненным ранее полем. # Настройка истории действий На странице "Настройки сайта" - в разделе "Configs" - в блоке "**CRON**" возможно указать периодичность очистки истории действий пользователя и администратора. К примеру, если в выпадающем списке выбрано значение "36 месяцев", то скрипт автоматически каждые 36 месяцев будет производить очистку истории действий пользователя/администратора.
### Очистка истории действий пользователя По умолчанию установлено рекомендованное значение "36 месяцев". Для того чтобы изменить значение, необходимо в выпадающем списке выбрать подходящее значение и нажать "[**Save**](#user-content-fn-1)[^1]". ### Очистка истории действий администратора По умолчанию установлено рекомендованное значение "3 месяца". Для того чтобы изменить значение, необходимо в выпадающем списке выбрать подходящее значение и нажать "[**Save**](#user-content-fn-2)[^2]". [^1]: ![](/files/fSauxKLikck9LsAmiQjo) [^2]: ![](/files/GxR58ugDmPjAOoXk1ST0) # Валюты ## Общие данные Заполнить общие данные согласно правил ниже: {% content-ref url="/pages/DgJllV1ffSBKYGWMDcag" %} [Логотип валюты](/obmen/valyuty/logotip-valyuty) {% endcontent-ref %} {% content-ref url="/pages/urip49ArslpPeR58CUeW" %} [Название валюты](/obmen/valyuty/nazvanie-valyuty) {% endcontent-ref %} {% content-ref url="/pages/9UrPkPN0tdegdMO3ZuW7" %} [Тип валюты](/obmen/valyuty/tip-valyuty) {% endcontent-ref %} {% content-ref url="/pages/zgqxcxm2X9fXqtesraiG" %} [XML валюты](/obmen/valyuty/xml-valyuty) {% endcontent-ref %} ## Курс и резервы Заполнить раздел курсов согласно правил ниже: {% content-ref url="/pages/vBzchELACoVNu96XZj3z" %} [Резервы](/obmen/valyuty/rezervy) {% endcontent-ref %} {% content-ref url="/pages/uSZmNYSJL5G9RCsz4fW0" %} [Курс к USD](/obmen/valyuty/kurs-k-usd) {% endcontent-ref %} ## Платежные настройки и данные полей Настроить прием оплаты и метод выплаты а также настроить запрос полей {% content-ref url="/pages/wpdCU9ZhU0n5Wx2dgBS4" %} [Настройка поля валюты](/obmen/valyuty/nastroika-polya-valyuty) {% endcontent-ref %} {% content-ref url="/pages/xFGj5OHsW0lA4FOi0AEQ" %} [Прием платежей](/obmen/valyuty/priem-platezhei) {% endcontent-ref %} {% content-ref url="/pages/JHONbWdcQm9PJtXiFgJW" %} [Настройка выплаты](/obmen/valyuty/nastroika-vyplaty) {% endcontent-ref %} ## Настройка верификации {% content-ref url="/pages/iejLjjxLYWe9QOYsRQue" %} [Верификации](/obmen/verifikacii) {% endcontent-ref %} # Список валют {% hint style="info" %} В поле **Курс USD** есть возможность изменять сумму если в настройках выбран режим вручную в разделе Курсы Валют к USD. В поле **Резерв Валюты** вы можете корректировать сумму резервов. Поле **Статус** отвечает за активность валюты если её отключить валюта не будет активна на сайте и клиент не сможет совершить по ней обмен. {% endhint %} ![](/files/jvTaGFxe6czD71QVI9Ru) **Действия с валютой** {% hint style="warning" %} При удалении валюта удаляется безвозвратно и её необходимо будет создавать заново. {% endhint %} **На странице так же присутствует сортировка** ![](/files/EhpbQNEjg7doXhjrH41P) **Вы можете отсортировать список валют несколькими способами** ![](/files/APWroZUxUxTk5FS0ajvw) **Вы можете скопировать валюту для создания новой валюты или копии с изменениями** ![](/files/HdSfRJwrc7hlgWDfOlWL) # Логотип валюты ## Логотип валюты {% hint style="success" %} Для вашего удобства мы уже подготовили логотипы всех основных валют и вы можете скачать в нужном формате на странице [Материалы для настройки](https://www.boxexchanger.net/ru/resources) {% endhint %} **Требования к изображению валюты** * Минимальный размер: 240px x 240px * Максимальный размер файла: 1 Мб * Цветовой спектр: sRGB * Формат: SVG,PNG,JPG,JPEG {% hint style="info" %} #### \*SVG *Мы рекомендуем использовать SVG формат, так как он имеет относительно небольшой вес файла, и высокое качество картинки.* {% endhint %} # Название валюты * Название обязанно содержать в себе только цифры и буквы * Не превышать указанный максимум символов. (100 знаков) * Соответствовать названию логотипа а так же в полной мере раскрывать суть валюты. * Не должно содержать тип валюты *(USD, EUR, BTC, ETC и т.п )*.Для этого существует отдельное поле **тип валюты.** # Тип валюты Тип валюты - короткое обозначение валюты например USD, EUR * Должно быть коротким до 5 символов только латинские буквы * Рекомендуем использовать код из таблицы [Коды национальных валют](#kody-nacionalnykh-valyut) ### Коды национальных валют | Код валюты | Описание | | ---------- | ---------------------- | | ADA | *Cardano* | | AED | *Дирхам ОАЭ* | | ALG | *Algorand* | | AMD | *Армянский драм* | | ATM | *Cosmos* | | AVX | *Avalanche* | | BAT | *BAT* | | BCH | *Bitcoin cash* | | BGN | *Болгарский лев* | | BNB | *Binance Coin* | | BSV | *Bitcoin SV* | | BTC | *Bitcoin* | | BTG | *Bitcoin Gold* | | BTT | *BitTorrent* | | CAD | *Канадский доллар* | | CNY | *Юань* | | CZK | *Чешская крона* | | DOT | *Polkadot* | | DSH | *Dash* | | EOS | *EOS* | | ETC | *Ethereum Classic* | | ETH | *Ethereum* | | EUR | *Евро* | | GBP | *Фунт стерлингов* | | GEL | *Грузинский лари* | | HUF | *Форинт* | | ICX | *ICON* | | IDR | *Индонезийская рупия* | | INR | *Индийская рупия* | | IOT | *IOTA* | | JPY | *Японская иена* | | KGS | *Киргизский сом* | | KMD | *Komodo* | | KZT | *Казахстанский тенге* | | LNK | *Chainlink* | | LSK | *Lisk* | | LTC | *Litecoin* | | MAT | *Polygon* | | MDL | *Молдавский лей* | | MKR | *Maker* | | MYR | *Малайзийский ринггит* | | NEO | *NEO* | | NGN | *Нигерийская найра* | | NOK | *Норвежская крона* | | OMG | *OMG Network* | | ONT | *Ontology* | | PLN | *Польский злотый* | | QTM | *QTUM* | | REP | *Augur* | | RVN | *Ravencoin* | | SEK | *Шведская крона* | | SHI | *Shiba Inu* | | SOL | *Solana* | | THB | *Тайский бат* | | TRX | *TRON* | | TRY | *Турецкая лира* | | UAH | *Гривна* | | UNI | *Uniswap* | | USD | *Доллар США* | | UZS | *Узбекский сум* | | VET | *VeChain* | | VND | *Вьетнамский донг* | | WAV | *WAVES* | | WMX | *WMX (0.001 BTC)* | | XDG | *Dogecoin* | | XEM | *NEM* | | XLM | *Stellar* | | XMR | *Monero* | | XRP | *Ripple* | | XTZ | *Tezos* | | XVG | *Verge* | | YFI | *Yearn.finance* | | ZEC | *Zcash* | | ZRX | *0x* |
# Точность суммы {% hint style="info" %} **Пример округления:** Точностью валюты 2 сумма \ 1.234 = 1.23\ 6.789 = 6.78 {% endhint %} # XML валюты XML используется в качестве идентификатора валюты. XML крайне важен для корректной работы всего обменника он используется для: * Определения валюты мерчантом для правильного создания транзакции на пополнение * Модулей выплат для определения какую валюту необходимо выплатить * Мониторингом obmify и другими для получения курсов и отражения в своих рейтингах обменников. Вы можете выбрать XML из списка: \ ![](/files/KsdsPDrXVthVp6qXblZV) или ввести свой если нужной вам валюты не нашли для этого в списке в самом низу выберите пункт **Enter own XML.** Далее вместо списка у вас появиться поле в которое можно ввести собственный XML: ![](/files/zuT2L6nHjZhsF6HNG3UN)
**XML должен соответствовать требованиям:** * Уникальный не пересекаться с другими валютами * Может содержать только латинские буквы и цифры и \_ * Соответствовать общепринятым стандартам {% embed url="" %} {% embed url="" %} {% embed url="" %} > Пример: Для валюты *Tether(USDT) ERC20 должен быть установлен xml* **USDTERC20** {% hint style="info" %} **Собственная валюта:** Если создаваемая вами валюта уникальная и для нее не существует стандартного обозначения, укажите свой XML который, будет уникален и не будет пересекаться c уже принятым стандартом так как это может повлечь за собой ошибочный экспорт курсов на мониторинг {% endhint %} * При создании своего XML постарайтесь заполнить его максимально понятным и коротким например аббревиатура имени компании + тип валюты {% hint style="info" %} **Наличные указание города:** Для экспорта курса с указанием города XML валюты должен быть разделен с помощью **\_*****C\_*** пример **CASHUSD\_C\_KIEV**
Коды городов можно найти на странице: \ {% endhint %} # Курс к USD Данный курс очень важен для корректной работы: * начисления партнерских вознаграждений * подсчета прибили обменника в USD * статистика прибыли * расчета стоимости обмена для расчетов оборота ## Инструкция по настройке Настроить курс валюты к доллару вы можете двумя способами **автоматически** и **вручную** ### Автоматически: {% hint style="info" %} При добавление автоматически убедитесь что выбранный вами парсер активирован. {% endhint %} ![](/files/AHAhVp0g4qlWNgNJzcnc) ### Вручную: Вам необходимо установить сколько за 1 единицу вашей валюты можно получить USD (прямой курс вашей валюты к USD) {% hint style="info" %} Формула конвертации **обратного курса в прямой курс:** \ ***Е***** = 1 *****/Е?**.*\ \ ***Пример обратного курса:***\ Например о*бменный курс XXX к USD, скажем 7.6 XXX за 1 USD нам необходимо получить прямой курс то-есть сколько за 1 XXX получим USD для этого воспользуемся формулой выше **1 / 7.6** получаем **0*****.00131578** в данном случаи для валюты XXX нужно установить курс который мы получили.\ \ **Пример прямого курса:** \ Рассмотрим другой пример курс EUR к USD тут нам известен прямой курс: 1 EUR = 1.14 USD а значит нам нечего считать уже не необходимо тк нам известно сколько стоит 1EUR и в данном случаи для валюты EUR мы устанавливаем курс **1.14** {% endhint %} ![](/files/CyMQg94eLtLfQEujEA5V) # Резервы {% hint style="warning" %} **Доступный резерв обменника** – это количество денег определенной валюты, имеющееся в распоряжении обменного пункта для совершения обменов денег. {% endhint %} {% hint style="warning" %} При совершении операции обмена, обменник не может выдать вам сумму большую, чем доступный резерв {% endhint %} Работа обменника электронных валют зависит от конкретного резерва по каждой из обмениваемых валют. То есть, если резерв обменника по USD равен 1000, а клиент хочет купить 1500 USD, не удастся провести операцию по обмену. Вы можете указать доступный резерв при **создании валюты** или [**отредактировать**](/obmen/valyuty/spisok-valyut) уже существующую. ![](/files/XGLnrhSr2dUt22VmuxhA) # Настройка поля валюты Вы можете добавить свои или активировать уже существующие поля на вывод и/или ввод. #### Добавление поля ![](/files/e4zEEyT38mgHA7RnjXfr) **Рекомендации по добавлению поля для валюты** * Название должно отражать суть будущего поля * Текст подсказки являеться примером заполняемого поля # Прием платежей Вы можете настроить прием платежа тремя способами : **по реквизитам**, через **мерчант** или создать свой **уникальный**. Так же есть возможность активировать и деактивировать следующие кнопки и ссылки: * Показывать ссылку в ПС в оплате * Показывать требования оставлять комментарий * Показывать кнопку "Я оплатил" Данные кнопки будут отображены в момент совершения обмена валют на разных его этапах. Требования оставлять комментарий необходимо для того что бы отображать данные об ордере (номер заявки или назначения платежа и т.п.) Кнопка я оплатил cменит статус заявки на **inProgress** в **админ панеле** ![](/files/2lfwRE0IfDbBBrbnNLS2) #### **Создать уникальный или по** реквизитам **прием платежа** Вам следует заполнить следующие поля: * Ссылка платежной системы * Ваш счёт платежной системы * Комментарий платежа( не обязательный)
**Ссылка платежной системы** - это ссылка которая необходима для перехода клиента на сайт платежной системы с которой будет производиться обмен **Счёт платежной системы** - это счёт на который клиент переведет средства при совершение обмена В **комментарии платежа** вы можете выбрать константы из списка указанного ниже или назначить их самостоятельно. ![](/files/wOseo9PgSqg41JonuB5O) **Пример комментария к платежу** Комментарий может содержать как просто константу из списка так и текст с константой и без неё. ![](/files/uZl92TlqEBqIuvHPBxNP) **Комментарий будет отображен на втором шаге оплаты.** ![](/files/ESka289L8NY1o5BYkrZW) # Настройка выплаты Вы можете производить выплаты **вручную** или в **автоматическом режиме** ## Выплата вручную ![](/files/ewjs4NVuLc4WoyGApHwi) При настройки ручной выплаты вам необходимо заполнить поля для заполнения реквизитов клиентом (например номер кошелька) на которые вы будете производить выплаты вручную. Подробнее по настройке полей вы можете узнать в разделе: {% content-ref url="/pages/wpdCU9ZhU0n5Wx2dgBS4" %} [Настройка поля валюты](/obmen/valyuty/nastroika-polya-valyuty) {% endcontent-ref %} В данном режиме вы сами переводите оплату в соответсвии с заявкой клиенту с той системы с которой вам удобно. ## Автоматические выплаты {% hint style="danger" %} **Внимание:** Мы не рекомендуем включать **авто выплаты** на начальном этапе работы. Перед активацией автоматических выплат убедитесь что вы настроили обменник корректно все курсы резервы страховки настроены верно и полностью разобрались в работе софта. {% endhint %} В данном случаи выплата осуществляется в полуавтоматическом или полностью автоматическом режиме зависит от настроек направления. ![](/files/pSVUTEi6APoRHUSOMWRs) {% hint style="info" %} При ручной выплате убедитесь что обмен уже не выплачен модулем и статус заявки не находится в статусе на выплате с состоянием модуля выплаты wait/inProgress {% endhint %} #### Активация выплаты: Для активации выплаты выберите режим выплаты автоматически и ниже выберите нужный вам модуль выплаты ![](/files/SxEHy76b3caGc79LO07m) предварительно настроив его в разделе **Мерчанты и АПИ** пункт PAYOUT SYSTEM # AML проверка Описание работы AML проверок на прием и выплату ## Описание AML проверка позволяет с помощью AML модулей проверять причастность к отмыванию средств (*Anti Money Laundering):*\ *-* **Для валюты приема** *-* депозит валюты по хешу транзакции\ \- **Для валюты выплаты** - адрес для вывода средств. ## Конфигурация {% hint style="info" %} AML проверка валюты на прием/выплату работает исключительно в связке в автоматическим модулем приема/выплаты. Убедитесь, что в настройках валюты у вас установлен мерчант/модуль выплаты в качестве приема/выплаты. К примеру, такими модулями могут быть whitebit, TRON Node, Ethereum Node, Bitcoin Node. \ В случае, если вы используете модуль приема/выплаты, которого нет в списке выше - обратитесь в чат с саппортом для добавления поддержки вашего модуля. {% endhint %} {% hint style="success" %} Прежде чем устанавливать AML модуль для приема и выплаты, убедитесь, что данный модуль настроен в админ панели. Подробнее вы можете найти в разделе мануала "**AML плагины**". {% endhint %} Для того чтобы установить AML модуль для проверки валюты, перейдите на страницу настроек валюты - шаг "**Настройки оплаты**" -> \ a) Для проверки валюты на прием: в разделе "**AML ПРОВЕРКА**" установите параметр "**Автоматически**" -> [**выберите**](#user-content-fn-1)[^1] из списка подходящий AML модуль -> сохраните настройки направления.\ б) Для проверки валюты на вывод: в разделе "**AML ПРОВЕРКА (WITHDRAWAL WALLET)**" установите параметр "**Автоматически**" -> [**выберите**](#user-content-fn-2)[^2] из списка подходящий AML модуль -> сохраните настройки направления. ### AML проверка на прием #### Алгоритм проверки 1. Предположим, что для валюты TRON у вас установлен [Мерчант whitebit](/obmen/merchant-i-api/birzha-whitebit/merchant-whitebit) в качестве модуля приема и [CrystalBlockchain](/aml-plaginy/crystalblockchain) в качестве модуля для AML проверки на прием. 2. Клиент создает заявку по направлению "**TRON -> Visa/MasterCard USD**" -> отправляет TRON на адрес, сгенерированный мерчантом whitebit -> whitebit через webhook сообщает скрипту о том, что депозит TRON по данной заявке успешно зачислен на баланс -> скрипт получает из webhook'a хеш депозита и делает API запрос в CrystalBlockchain, передавая хеш депозита для AML проверки -> в зависимости от результата AML проверки (Risk Score) от CrystalBlockchain, скрипт выставляет соответствующий статус заявки (см. подробнее в таблице ниже). | Допустимый Risk Score | Высокий Risk Score | | :----------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------: | | Скрипт устанавливает статус заявки [Статусы заявки](/zayavki/zayavki/statusy-zayavki#na-vyplatu) | Скрипт устанавливает статус заявки [Статусы заявки](/zayavki/zayavki/statusy-zayavki#uderzhana) | ### AML проверка на вывод #### Статус AML проверки на вывод В случае, если для валюты установлен автоматический AML модуль для проверки адреса на выплату, то в деталях заявки по направлению, в котором такая валюта является валютой выплаты, в блоке с [изменением статуса заявки](/zayavki/zayavki#izmenenie-statusa) будет отображаться [**AML Payout status**](#user-content-fn-3)[^3]. Подробнее о статусах данного параметра в таблице ниже. | Wait for check | Clear | Errored | | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | | Данный статус обозначает, что AML модуль ожидает пока заявка будет переведена в статус [Статусы заявки](/zayavki/zayavki/statusy-zayavki#na-vyplatu) и запущена выплата (В случае если в направлении отключен "Автообмен) чтобы запустился автоматический AML модуль. |

Данный статус обозначает, что AML проверка адреса для выплаты завершена и по результатам проверки Risk Score является допустимым. При данном статусе:
- Под полем "AML Payout status" будет отображаться результат AML проверки
- Будет запущен автоматический модуль выплаты и начнется выплата валюты.

|

Данный статус обозначает, что AML проверка адреса для выплаты завершена и по результатам проверки Risk Score является высоким. При таком статусе:
- Под полем "AML Payout status" будет отображаться результат AML проверки
- Модуль выплаты не запускается.

| {% hint style="info" %} В случае, если статус AML проверки "**Errored**", то вы можете запросить у клиента другой адрес для вывода либо:\ а) Нажать на кнопку "[**Address clear**](#user-content-fn-4)[^4]". После нажатия на данную кнопку, "**AML Payout status**" будет изменен на "**Clear**" и запустится автоматический модуль выплаты. \ б) Нажать на кнопку "[**Check again**](#user-content-fn-5)[^5]" для того чтобы повторно запустить автоматический AML модуль и провести проверку адреса для вывода еще раз. {% endhint %} #### Алгоритм проверки 1. Предположим, что для валюты TRON у вас установлен модуль [Выплаты whitebit](/obmen/merchant-i-api/birzha-whitebit/vyplaty-whitebit) и [CrystalBlockchain](/aml-plaginy/crystalblockchain) в качестве модуля для AML проверки на выплату. 2. Клиент создает заявку по направлению "**Visa/MasterCard USD -> TRON**" -> после успешной оплаты, статус заявки изменяется на [Статусы заявки](/zayavki/zayavki/statusy-zayavki#na-vyplatu)-> скрипт делает API запрос к CrystalBlockchain, передавая адрес для вывода -> в зависимости от результата проверки устанавливается соответствующий статус для "**AML Payout status**" (Подробнее о статусах в разделе [#status-aml-proverki-na-vyvod](#status-aml-proverki-na-vyvod "mention")). {% hint style="info" %} Обратите внимание, для AML проверки на вывод, передаются исключительно те адреса, которые указаны в поле из автоматического модуля выплаты. \ Для отображения такого поля, достаточно установить для валюты автоматический модуль выплаты, к примеру, whitebit -> скрипт автоматически добавит "Адрес для вывода" как поле валюты и оно будет отображаться на клиентской части - пример на [**скриншоте**](#user-content-fn-6)[^6].\ В коде, такие поля имеют название "[**account\_crypto**](#user-content-fn-7)[^7]". {% endhint %} [^1]: ![](/files/FgewJwEZFCTgkCZVGM3K) [^2]: ![](/files/f39JhdFKPxWZImNzazds) [^3]: ![](/files/FKbPhmD5jjIhl4vK2JLG) [^4]: ![](/files/w4PyjfvuUo4Bs3DQpuVN) [^5]: ![](/files/3PDRWhRPj6wZtkYLn1q2) [^6]: ![](/files/45O7XJrG0iGRoJgfVZQV) [^7]: ![](/files/VBwFvvzdphxHkp3TJVF8) # Верификация ### 1. Верификация реквизитов (прием) Вы может активировать и деактивировать верификацию реквизитов ![](/files/Az7BeJLzr8rQXsLzMLjL) {% hint style="warning" %} **В валютах включаем верификацию реквизитов!** Например фото карты на фоне сайта итп. В данном разделе не надо запрашивать фото паспорта, водительские права для верификации личности. Верификация личности производится в разделе [**Направления**](/obmen/napravlenie). {% endhint %} **Активировать верификацию** Инструкция должна содержать шаги по которым пользователь сможет осуществить верификацию.\ Все верификации вы можете увидеть в отдельном разделе [**Верификации**](/obmen/verifikacii) ### Верификация реквизитов Верифицируя пользователя для конкретной валюты верификация будет действовать на все направления где используется эта валюта . ![](/files/yOGXTThmfSdv8sjbmyk8) {% hint style="info" %} **Локализация** \ Используйте подсказку для что бы узнать как локализировать текст инструкции/верификации {% endhint %} ![](/files/CXGgA7n0U1GvdaWlQL5d) ### 2. Верификация реквизитов (выплата) * Для включения верификации реквизитов на выплату зайдите в **настройки валюты** - шаг "**Другие настройки**" - нажмите "[**Включить**](#user-content-fn-1)[^1]" напротив "**ВЕРИФИКАЦИЯ: (PAYOUT)**" - в редакторе текста введите текст для верификации. [^1]: ![](/files/XzqAS9sHe12t5F0Vwepl) # Сортировка направлений {% hint style="info" %} #### Для чего нужна сортировка валюты? В первую очередь сортировка нужны для показа более приоритетной валюты. Пользователи в первую очередь будут видеть самую популярную валюту на обмен и не будут тратить время на поиски, а значит время на обмен будет меньше, клиенты смогут быстрее находить нужное направление что сможет уменьшить процент отказа. {% endhint %} ## Как я могу отсортировать валюту? 1. Для того, что бы отсортировать валюты нужно зайти в админ панель и перейти в раздел: [Валюты -> Сортировка валют.](#user-content-fn-1)[^1] 2. Если у нас есть какие-либо валюты мы можем взаимодействовать с их расположением, для этого нам нужно [схватить валюту (за иконку справа)](#user-content-fn-2)[^2] левой клавишей мыши. Теперь мы можем ее перетаскивать вверх или вниз. 3. Изменения будут автоматически применяться для клиентской части сайта. Поставив валюту Bitcoin в самый верх, расположение валюты обновиться и на сайте мы получим такой же результат как в админ панели\ ![](/files/RUdDJtCFr3gvOjztENd6)![](/files/D4Lxn76cI6vSqPl1qdmU) ## Почему в сортировке валюты имеется 2 блока с валютами? Как вы наверное заметили, В настройках сортировки имеется 2 блока с одинаковыми валютам , сделано это было для удобства. Первый блок (слева) идет для валюты "Отдаете" , а во втором блоке (справа) идут валюты на "Получаете". Это было задуманно, что бы упростить сортировку, и под каждое направление не делать целый список возможных валют. {% hint style="danger" %} **Важно:** Данные изменения применяются только для клиентской части, [в настройках валюты в админ панели](#user-content-fn-3)[^3] данные настройки **не применяются** в этом списке валюты автоматически фильтруются по алфавиту. {% endhint %} [^1]: ![](/files/CWnhtvuepIkDW9oKyLlU) [^2]: ![](/files/MxyHiWlxYX1Blh6FqKzY) [^3]: ![](/files/xy45slakFugM13NgBAjU) # Направление Инструкция по настройке направления При создании направления рекомендуется заполнять минимальную и максимальную сумму у одной валюте для избежания конфликта. ![](/files/Y5kLeh1qEHM7Qwed7KFY) **Авто обмен** должен быть включен при полной уверенности что при правильной настройке направления и стабильности курс валют а также включен мерчант у первой валюте а у второй payout модуль. {% hint style="warning" %} Все обмены по данному направлению буду проведены без участвия модератора {% endhint %} **Экспорт курса** означает что направление будет доступно на сторонних сервисах и мониторингах. #### Исключение для пользовательской скидки При активации опции "[**Disable user discount**](#user-content-fn-1)[^1]" для выбранного направления не применяется скидка `userDiscount`, указанная в профиле пользователя. ### График работы Для того чтобы установить график работы направления, выберите подходящие расписание из выпадающего списка как показано на [**скриншоте**](#user-content-fn-2)[^2]. {% hint style="info" %} Для настройки расписания следуйте инструкции: [Расписания](/dopolnitelnye-sistemy/raspisaniya) {% endhint %} ### **Настройка курса** В сервисе можно гибко настраивать курсы из [Парсер курсов](/obmen/parser-kursov) и создавать из них цепочки. ![](/files/XhK8ShGZC0gqhIeLyM1J) {% hint style="warning" %} Обратите внимание что первая и последняя валюта должны совпадать с валютами в направлении {% endhint %} #### Плавающий курс **Плавающий курс** позволяет автоматически обновлять курс заявки до момента её фиксации для выплаты. Данный функционал обеспечивает актуальность курса, снижает риски из-за колебаний и учитывает лимиты изменений. Инструкцию по настройке плавающего курса вы можете найти по ссылке [Плавающий курс](/obmen/napravlenie/plavayushii-kurs) #### Страховка курса **Страховка курса** используется если обмен завис на этапе биржи и вы можете потерять деньги за этот период временни. Настроить страховку курса вы можете на шаге "Тип курса" - раздел "[**Страховка курса**](#user-content-fn-3)[^3]". \ Если страховой случай произошел вы можете принять решения отключить направление, назначить максимальное значение по курсу или установить курс по другой бирже. \ **Инструкцию по настройке страховочного курса вы можете найти по ссылке** [Страховка курса](/obmen/napravlenie/strakhovka-kursa) #### **Приоритетные модули** Приоритетные модули позволяют настраивать приоритетные способы приёма платежей, выплаты и AML-проверки для конкретного направления обмена. Это даёт контроль и гибкость при обработке заявок. **Инструкцию по настройке плавающего курса вы можете найти по ссылке**: [Приоритетные модули](/obmen/napravlenie/prioritetnye-moduli) **Время действия** **Время действия** - период временни за который активна заявка клиента. Исчисляется в минутах ![](/files/Tz2FeQM230hhzoJ0ju7T) ### Поля направлений Представляют собой список из имени поля и переключателя состояния.Так же вы можете удалите выбранное поле . ![](/files/qo47twj5aL4uJ72W4EjW) {% hint style="warning" %} При создании направления следует создавать поля только касающиеся информации о клиенте.( имя, фамилию, адрес). Поля реквизитов необходимо включать в настройке валюты. {% endhint %} ![](/files/eRq80u3vfFGjkzLtxNRC) ### **Комиссии сервиса** Настройка комисси представлена в виде **фиксированной суммы и процентной**.Комиссия взымается с итоговой суммы.\ **Сумма и процент потерь** необходим для того что бы вы могли отслеживать сумму оплаченных комиссий сетей и сервисов. ![](/files/RQHK70buUY2Iycn3gmem) ### Лимиты для экспортного файла
В настройках направлений и групп направления - на шаге "**Комиссии**" раздел "**Export file options**": * **Min amount (IN)** — минимальная сумма обмена для валюты **IN**, передаваемая на мониторинги. Значение должно быть больше, чем текущая минимальная сумма обмена, установленная в направлении. * **Max amount (IN)**— максимальная сумма обмена для валюты **IN**, передаваемая на мониторинги. Значение должно быть меньше, чем текущая максимальная сумма обмена, установленная в направлении. ### **Скидка за оптовые заявки** при её добавление доступны два поля - сумма выше которой открывается скидка, процент самой скидки {% hint style="info" %} Вы можете создавать ступенчатую систему скидок для ваших клиентов. {% endhint %} ![](/files/7Gr6oLMySzYKYeLfYBl4) ### Верификация #### Ручная верификация * [В настройках направления перейдите к шагу "*Верификация*" - нажмите "*Включить*" напротив "*ВЕРИФИКАЦИЯ: (IDENT DOCUMENTS PASSPORT ETC)*"](#user-content-fn-4)[^4]. * [В поле "*Count verification photos*" введите кол-во требуемых от пользователя изображений для верификации - в поле редактора текста введите текст с инструкцией для верификации пользователя](#user-content-fn-5)[^5] и обязательно сохраните все изменения. (см. примеры ниже)
Примеры текста для верификации личности на разных языках \##ru##\ Для прохождения верификации личности предоставьте: \ 1\. **Фотографию одного из документов удостоверяющих личность**\ \- Паспорт (первая страница)\ \- ID-карта (передняя сторона)\ \- Документ удостоверяющий личность (передняя сторона)\ 2\. **Фотографию (селфи) с документом, удостоверяющим вашу личность.**\ В кадре должно быть видно ваше лицо и документ в соответствующем формате.\ \##\ \ \##ua##\ Для проходження верифікації особи надайте:\ 1\. **Фотографію одного з документів, що засвідчують особу**\ \- Паспорт (перша сторінка)\ \- ID-карта (лицьова сторона)\ \- Документ, що засвідчує особу (лицьова сторона)\ 2\. **Фотографію (селфі) з документом, що засвідчує вашу особу**. \ У кадрі має бути видно ваше обличчя та документ у відповідному форматі.\ \##\ \ \##en##\ To pass identity verification, please, provide:\ 1\. **Photo of one of the identity documents**\ \- Passport (first page)\ \- ID card (front side)\ \- driver's license (front side) \ 2\. **Photo (selfie) of a person with an identity document.** \ The frame must show the face of the person and the document in the appropriate format.\ \##
* [После проделанных действий, на клиентской части на этапе оплаты заявки появится кнопка "*Пройти верификацию*" напротив поля "*Проверка личности*". При нажатии на эту кнопку открывается модальное окно с инструкцией и возможностью загрузить изображения для верификации. ](#user-content-fn-6)[^6] #### Автоматическая верификация * В настройках направления - шаг "Верификация" -> нажмите "[**Включить**](#user-content-fn-7)[^7]" напротив " **Required verified user account (KYC)**" -> в поле "**When order amount is more then**" [**введите**](#user-content-fn-8)[^8] сумму (валюта указана справа в данном поле. При необходимости валюту можно изменить) от которой будет происходить верификация. * При включенной автоматической верификации, в случае если не авторизированный пользователь попытается создать заявку по такому направлению, то система запросит его войти в аккаунт. Далее, если авторизированный, но не верифицированный пользователь попытается создать заявку по такому направлению, то у него появится всплывающее окно с верификацией KYC модуля, который вы выбрали.
Инструкция по работе и настройке KYC модулей: [KYC модули](/dopolnitelnye-sistemy/kyc-moduli) ### Инструкции на этапах заявки Представляют пошаговую систему в которой вы можете описывать инструкции. Возможность добавлять инструкцию на шагах которые вам необходимы .Для этого необходимо переключить статус отображения шага. {% hint style="info" %} Для **локализации текста** используйте символ решётки и код языка, оберните текст.Пример находиться по подсказке. {% endhint %} ![](/files/IZbX7wb0j62X5kX95pSk) ### SEO-friendly URL (ЧПУ) На шаге "Верификации" вы можете создать ЧПУ для направления. В последействии, ЧПУ возможно использовать для SEO продвижения. Подробнее по настройке ЧПУ вы можете найти по ссылке: [SEO-friendly URL (ЧПУ)](/obmen/napravlenie/seo-friendly-url-chpu) ### Документы Функционал "Документы" позволяет запросить у клиента, к примеру, инвойс об оплате на любом из этапов заявки. Подробнее о настройке документов вы можете найти в инструкции: [Документы](/obmen/napravlenie/dokumenty) ### Дополнительные услуги Функционал позволяет добавить перечень платных (за дополнительную комиссию) услуг при обмене. Подробнее о настройке платных услуг вы можете найти в инструкции: [Дополнительные услуги](/obmen/napravlenie/dopolnitelnye-uslugi) ### Копирование направления
Для копирования существующего направления, на странице "**Настройка направлений**" - в блоке с направлением, нажмите на значок "**Копирования**". После нажатия на значок, у вас будет возможности отредактировать скопированное направление. Также копирование направления доступно при нажатии кнопки "[**Copy route**](#user-content-fn-9)[^9]" в правом верхнем углу -> выбор необходимого направления [**из списка**](#user-content-fn-10)[^10] -> кнопка "[**Copy route**](#user-content-fn-11)[^11]". [^1]: ![](/files/2Hcc7o85eKWaEOdHeJuO) [^2]: ![](/files/7UVOa09vqnualr3PokZR) [^3]: ![](/files/kLVhnZUw9HpyATwhlARx) [^4]: ![](/files/Ymh9vMUkvD7JUIdJQH1L) [^5]: ![](/files/wJbKstfQmvJU3eYXnMY5) [^6]: ![](/files/hvYrsEnCeSYRVBnikSPr) [^7]: ![](/files/mz85kAkwVyVLvq6yJU2b) [^8]: ![](/files/1OLw95m2fLF2xAA3Egpk) [^9]: ![](/files/1Wp759yN9p2mozPhbuM5) [^10]: ![](/files/cOLRspQsjuJvAG8nvsyU) [^11]: ![](/files/QHldJAPSq7W9zWhmjXxk) # Приоритетные модули Инструкция по установке приоритетного мерчанта/модуля выплаты/AML модуля для конкретного направления ## Описание Приоритетные модули позволяют настраивать приоритетные способы приёма платежей, выплаты и AML-проверки для конкретного направления обмена. Это даёт контроль и гибкость при обработке заявок. ## Настройка Перейдите в настройки направления - шаг "[**Тип курс**](#user-content-fn-1)[^1]**а**" - внизу страницы найдите опции "**PRIORITY ПРИЕМА ПЛАТЕЖЕЙ**", "**PRIORITY ВЫПЛАТЫ**", "**PRIORITY AML ПРОВЕРКА**", "**PRIORITY AML ПРОВЕРКА (WITHDRAWAL WALLET)**". Следуйте инструкции ниже, в зависимости от необходимого приоритетного модуля. {% hint style="info" %} По умолчанию для данных опций будет выставлено значение "**Default**". Это обозначает, что способ приема платежа, выплаты либо AML проверки будет использоваться из настроек валют. {% endhint %} ### Priority приема платежей * [**Выберите**](#user-content-fn-2)[^2] приоритетный способ приема платежа для текущего направления-> сохраните изменения для каждого шага чтобы настройки вступили в силу. * Теперь для текущего направления будет использоваться приоритетный способ приема платежа, а способ приема платежа из настроек валюты будет игнорироваться.
Разберем способ применения на конкретном примере * Направление "USDT TRC20 - Наличные USD Барселона". * В настройках валюты USDT TRC20 выбран [способ приема платежа "Мерчант" - "Tron TRC20 Token"](#user-content-fn-3)[^3] * В настройках направления "USDT TRC20 - Наличные USD Барселона" [выбираем "PRIORITY ПРИЕМА ПЛАТЕЖЕЙ" - "По реквизитам" - указываем тестовый адрес "TR7NHqjeKJxGTCi1q8ZY4sL9otJzgjMj6t"](#user-content-fn-4)[^4] - сохраняем настройки. * Создаем заявки по направления - [переходим к шагу оплаты и видим, что отображаются реквизиты, которые мы указывали в настройках направления.](#user-content-fn-5)[^5]
### Priority выплаты Функционал позволяет выбирать модуль выплаты в зависимости от суммы. #### **Как настроить**: 1. Перейдите в настройки нужного направления → шаг "**Тип курса**". 2. В разделе "**Priority Выплаты**" выберите вариант "**Автоматически**". 3. Нажмите "[**Add module**](#user-content-fn-6)[^6]". 4. Укажите: * **Min payout amount** – минимальную сумму, * **Max payout amount** – максимальную сумму, * **Payout module** – модуль для выплат в этом диапазоне. 5. Добавьте столько лимитов, сколько необходимо. 6. После внесения изменений сохраните направление. #### **Если нужен только один модуль**: * Укажите в полях Min payout amount и Max payout amount значение 0. * Выберите нужный модуль. * Тогда при любой сумме выплаты будет использоваться именно он. #### **Особенности работы** 1. Если сумма выплаты не попадает ни в один лимит: * Берётся модуль, указанный для лимита 0 – 0. * Если и его нет, то используется модуль из настроек валюты выплаты. 2. **При изменении суммы выплаты** (например: * через редактирование ордера в админке или API exchanger/order/edit/, * при пересчёте из-за плавающего курса, * при корректировке модулем Approve under paid)\ **система использует актуальные лимиты и модули**. {% hint style="info" %} **Список модулей не фиксируется при создании заявки**. При выплате используется актуальный список лимитов и модулей на момент самой выплаты. {% endhint %} 3. Если в разных модулях выплаты есть одинаковые поля (по ключу), они объединяются в одно. Уникальные поля будут отображаться при создании заявки. ### AML модули * [**Выберите**](#user-content-fn-7)[^7] приоритетный AML модуль приема/выплаты для текущего направления-> сохраните изменения для каждого шага чтобы настройки вступили в силу. * Теперь для текущего направления будет использоваться приоритетный AML модуль приема/выплаты, а AML модуль приема/выплаты из настроек валюты будет игнорироваться. [^1]: ![](/files/fcrlgz7gZ9673EnAYQ15) [^2]: ![](/files/bEYpCQYVgp5qxAo7FjUa) [^3]: ![](/files/kf1AilrOZARNmWUwut7a) [^4]: ![](/files/veXdSLphGPBBgyuj0VDo) [^5]: ![](/files/PMEOtMiIltJjdChgHYJl) [^6]: ![](/files/D9RW5Tq5M1Jax4EhJvxJ) [^7]: ![](/files/iUaJsXA1p8zvbheR7ygE) # Плавающий курс Инструкция по настройке плавающего курса ### Описание **Плавающий курс** позволяет автоматически обновлять курс заявки до момента её фиксации для выплаты. Данный функционал обеспечивает актуальность курса, снижает риски из-за колебаний и учитывает лимиты изменений. ### Настройка направления с плавающим курсом * Для того чтобы включить и настроить функционал "**Плавающий курс**" перейдите в настройки направления -> шаг "**Тип Курса**" -> раздел "**Тип расчета ставки**" -> выберите "**Плавающий**" (у вас откроются [поля с настройками](#user-content-fn-1)[^1]) {% hint style="warning" %} **Плавающий курс будет активен и курс будет обновляться до тех пор, пока заявка будет находиться в статусе** [Статусы заявки](/zayavki/zayavki/statusy-zayavki#novaya)**,** [Статусы заявки](/zayavki/zayavki/statusy-zayavki#ne-oplachena) или [Статусы заявки](/zayavki/zayavki/statusy-zayavki#ozhidaet-obrabotki)*.* **Курс будет зафиксирован после оплаты со стороны клиента** (то есть после измения статуса [Статусы заявки](/zayavki/zayavki/statusy-zayavki#ne-oplachena) на [Статусы заявки](/zayavki/zayavki/statusy-zayavki#na-vyplatu)). {% endhint %} {% hint style="info" %} Заявки которые были созданы **до включение плавающего курса будут** по прежнему **с фиксированным курсом обмена** (если вы хотите это изменить вы можете для не оплаченных обменов изменить это вручную воспользовавшись инструкцией [**"Как установить плавающий курс для конкретного обмена**](#kak-ustanovit-plavayushii-kurs-dlya-konkretnogo-obmena)") {% endhint %} ### Поля настроек пересчета курса {% hint style="info" %} **Термины и объяснения:** * **Первоночальный курс** - курс при создании заявки. * **Фактический курс** - актуальный курс заявки, который отображается клиенту. * **Получаемый курс** - курс, который подтягивается из парсера и учитывает значение "**Процент комиссии**". {% endhint %} #### **- Порог для пересчета вниз (в процентах)** Значение в данном поле определяет минимальное процентное изменение (шаг) получаемого курса по отношению к фактическому курсу, при котором фактический курс заявки будет пересчитан вниз. {% hint style="info" %} **Алгоритм действий системы по пересчету курса вниз (если получаемый курс падает)**: Система сравнивает текущее процентное изменение курса (в процентах) со значением "Порог для пересчита вниз": а) Если текущий процент падения курса больше чем значение "Порог для пересчита вниз"-> скрипт пересчитывает и обновляет фактический курс. б) В противном случае обновления и пересчета фактического курса произведено не будет. **Обратите внимание, что общий лимит для пересчета вниз отсутствует.** {% endhint %}
Пример BTC/USDT 1. Указываем в поле "**Порог для пересчета вниз (в процентах)"** значение 0,01%. 2. Текущий курс 1 BTC = 10000 USDT. 3. Цена снижается - получаемый курс: 1 BTC = 9998 USDT -> скрипт сравнивает изменение курса (в процентах) между фактическим курсом и получаемым курсом -> *0,02%>0,01% ->* скрипт пересчитывает фактический курс. 4. Клиент видит обновленную сумму получения в соответствии с обновленным курсом, а именно 1 BTC = 9998 USDT. 5. Цена снижается с падением на 0,005% - фактический курс 1 BTC = 9997,5001 USDT -> скрипт сравнивает изменение курса между фактическим курсом и получаемым курсом -> *0,005%<0,01% ->* фактический курс остается без изменений. 6. Клиенту отображается прежняя сумма заявки и курс, а именно 1 BTC = 9998 USDT.
#### - Порог для пересчета вверх (в процентах) Значение в данном поле определяет минимальное процентное изменение (шаг) получаемого курса по отношению к фактическому курсу, при котором фактический курс заявки будет пересчитан вверх. #### - Общий лимит отклонения вверх (в процентах) Значение в данном поле определяет на сколько процентов от первоначального курса может вырасти фактический курс заявки. По сути, данное значение служит ограничением для пересчета "**Порог для пересчета вверх**". {% hint style="info" %} **Алгоритм работы системы по пересчету курса вверх (если получаемый курс растет):** **Шаг 1**: Система сравнивает текущее процентное изменение курса со значением, которое указано в поле "**Порог для пересчета вверх**": а) Если значение текущего изменение курса в % меньше значения из поля "**Порог для пересчета вверх**", то система перегодит к **шагу 2**. б) Если значение текущего изменение курса в % больше или равно значению из поля "**Порог для пересчета вверх**", то система пересчета фактического курса не произведет. **Шаг 2**: Система сравнивает текущее изменение курса в % со значением в поле "Порог для пересчета вверх": а) Если текущее изменение курса в % больше значения в поле "Порог для пересчета вверх", то система делает пересчет курса. б) В противном случае, пересчета курса не будет. {% endhint %}
Вариант 1 * Порог пересчета вверх (в процентах): 10 * Общий лимит отклонения вверх (в процентах): 30 * Курс с учетом комиссии 1:100 Курс, к примеру, начал расти, и новый курс из парсера с учетом комиссии стал 1:131. Скрипт видит, что изменение в % от изначального курса: 31%. Далее проверка, не превышает ли этот процент значение "Общий лимит отклонения вверх", видит что 31>30 -> поэтому пересчета не будет и курс останется 1:100.
Вариант 2 * Порог пересчета вверх (в процентах): 10 * Общий лимит отклонения вверх (в процентах): 30 * Курс с учетом комиссии 1:100 Курс, немного упал и новый курс из парсера с учетом комиссии стал 1:129. Скрипт видит, что изменение в % от изначального курса: 29%. Далее, проверка не превышает ли этот процент значение "Общий лимит отклонения вверх", скрипт видит, что 29%< 30% -> переходит к сравнению со значением "Порог пересчета вверх". Видит, что 29%>10% -> делаем пересчет курса и курс заявки становится 1:129.
### Как установить плавающий курс для конкретного обмена Для этого перейдите в список новых обменов и выберите нужный вам обмен в котором\ можно установить плавающий курс конкретной заявке нажав кнопку [**Float**](#user-content-fn-2)[^2] в данной заявке {% hint style="info" %} **Внимание!** Изменить тип расчета курса обмена можно **только для нового или не оплаченного обмена**. {% endhint %} ### История изменения курсов в заявке Нажав на иконку в [**виде графика**](#user-content-fn-3)[^3]**,** вы можете посмотреть историю пересчета данного обмена с процентной корректировкой по данному обмену
[^1]: ![](/files/zAXpz4ehqAsYKIMEJ2GI) [^2]: ![](/files/4TycQHfIKdDTllJlM9DV) [^3]: ![](/files/gN0l1QuKIHMPtH2jgttG) # Страховка курса Инструкция по настройке страховки курса ### Применение страховки курса {% hint style="success" %} **Страховочный курс, при корректной настройке, может быть полезен**:\ \- **при временной приостановки сервиса, который передает курсы в парсер**. К примеру, в случае, если биржа или любой другой сервис уходит на технические работы и курсы могут не обновляться. \ \- **при использовании парсера конкуренции**. К примеру, для того чтобы указать какой максимальный курс вы готовы отдать клиенту и какое действие будет произведено с направлением, если итоговый курс будет больше чем ваш максимально указанный курс, который вы готовы отдать клиенту (то есть сработает страховка курса) {% endhint %} ### Алгоритм работы функционала
Определение переменных **inAmount** - Сумма обмена отдаем **outAmount** - Сумма обмена получаем **outFeeAmount** - значение "Сумма комиссии" **FeePercent** - значение "Процент комиссии" **discount** - значение "DISCOUNT FOR AMOUNT" в настройках направления - шаг "Комиссии" **discountRate** - значение "DISCOUNT FOR AMOUNT" разделить на 100, то есть в % **feeRate** - значение "Процент комиссии" разделить на 100, то есть в %. **in:out** (курс из основного парсера либо курс указанный вручную в настройка направления) **rate** - курс обмена с учетом процента комиссии, но без учета суммы комиссий **RateFrom:RateTo** ( курс, указанный в страховке. К примеру, 1:39 (он может быть ручным либо из парсера) **defaultPercent** - тоже самое, что и значение "Процент комиссиии" только для страховочного курса. Задействуется только когда срабатывает страховка курса. **maxLimitPercent** - %, определяющий верхний лимит актуального курса по отношению к курсу, который указан в страховке курса.
#### Формула расчета курса обмена ``` feeRate = FeePercent / 100 in = in + (in * feeRate) discountRate = discount / 100 in = in - (in * discountRate) rate (курс обмена с учетом процента комиссии) = out / in ``` #### Формула расчета страховочного курса {% code fullWidth="false" %} ``` Текущий курс страховки = RateTo / RateFrom - defaultPercent Курс страхования = Текущий курс страховки + maxLimitPercent. ``` {% endcode %} #### **Варианты работы страховки курса** {% hint style="info" %} **Если Курс обмена с учетом процента комиссии** ≥ **Курса страхования -> срабатывает страховка курса и в зависимости от действия (action)**: а) Для “**Установить значение по умолчанию**” будет использоваться значение “Текущий курс страховки” в качестве актуального курса б) Для “**Максимальный курс**” будет использоваться значение “Курс страхования” в качестве актуального курса в) Для “**Отключить направление**” будет отключаться направление. \ То есть страховка курса срабатывает когда **окончательный курс обмена (курс из парсера основного - (минус) процент комиссии) становится** ≥ **чем курс страхования (текущий курс страховки минус процент комиссии (defaultPercent)) на значение maxLimitPercent %.** \ По сути, в поле "Max limit difference percent" мы указываем насколько мы допускаем отклонение rate от курса страхования. {% endhint %} При [**срабатывании страховочного курса**](#user-content-fn-1)[^1] в админ панеле, направление окрашивается в красный цвет и отображается страховочный курс.
Пример 1 - Страховка не срабатывает * Для направления указан курс обмена "Автоматически": из парсера whitebit (BTC-USDT, USDT-USD), курс из парсера (in:out) 1:34256.00. * Процент комиссии (FeePercent): 7 * Значение "DISCOUNT FOR AMOUNT (discount): 0 * В страховке курса указан тип "Автоматически": парсер kraken (BTC-USD), курс из страховочного парсера (RateFrom:RateTo) 1:34090. * Значение "Default percent" (defaultPercent): 7 * Значение "Max limit difference percent" (maxLimitPercent): 1.1 * Action выбран "Установить значение по умолчанию" feeRate = FeePercent / 100 = 7/100 = 0.07 \ in = in + (in \* feeRate) = 1 + (1*0.07)=1.07* \ *discountRate = discount / 100 = 0* \ *in = in - (in \* discountRate) = 1.07 - (1.07*0) = 1.07 \ RATE (окончательный курс обмена)= out / in = 34256.00/1.07= 32014.9533 ЕСЛИ RATE ≥ Курс страхования -> срабатывает страховка курса \ \ Текущий курс страховки = RateTo/RateFrom-defaultPercent = 34090 / 1 - 7% = 31703.7\ Курс страхования = Текущий курс страховки + maxLimitPercent = 31703.7 + 1.1% = 1 : 32052.4407 Rate (32014.9533) < Курса страхования (32052.4407) -> **страховка курса не срабатывает и клиент будет видеть курс с учетом процента комиссии, а именно 32014.9533**
Пример 2 - Страховка срабатывает / Action: Установить значение по умолчанию * Для направления указан курс обмена "Автоматически": из парсера whitebit (BTC-USDT, USDT-USD), курс из парсера (in:out) 1:36256.00. * Процент комиссии (FeePercent): 7 * Значение "DISCOUNT FOR AMOUNT (discount): 0 * В страховке курса указан тип "Автоматически": парсер kraken (BTC-USD), курс из страховочного парсера (RateFrom:RateTo) 1:34090. * Значение "Default percent" (defaultPercent): 7 * Значение "Max limit difference percent" (maxLimitPercent): 1.1 * Action выбран "Установить значение по умолчанию" feeRate = FeePercent / 100 = 7/100 = 0.07 \ in = in + (in \* feeRate) = 1 + (1*0.07)=1.07* \ *discountRate = discount / 100 = 0* \ *in = in - (in \* discountRate) = 1.07 - (1.07*0) = 1.07\ RATE (окончательный курс обмена)= out / in = 36256.00/1.07= 33884.1121 ЕСЛИ RATE ≥ Курс страхования -> срабатывает страховка курса \ \ Текущий курс страховки = RateTo/RateFrom-defaultPercent = 34090 / 1 - 7% = 31703.7 // этот курс будет установлен если выбрано "Установить курс по умолчанию". То есть курс будет 1:31703.7\ Курс страхования = Текущий курс страховки + maxLimitPercent = 31703.7 + 1.1% = 1 : 32052.4407 Rate (33884.1121) > Курса страхования (32052.4407) -> **страховка курса срабатывает и клиент будет видеть текущий курс страховки, а именно 31703.7**
Пример 3 - Страховка срабатывает / Action: Максимальный курс * Для направления указан курс обмена "Автоматически": из парсера whitebit (BTC-USDT, USDT-USD), курс из парсера (in:out) 1:34256.00. * Процент комиссии (FeePercent): 7 * Значение "DISCOUNT FOR AMOUNT (discount): 0 * В страховке курса указан тип "Автоматически": парсер kraken (BTC-USD), курс из страховочного парсера (RateFrom:RateTo) 1:34090. * Значение "Default percent" (defaultPercent): 7 * Значение "Max limit difference percent" (maxLimitPercent): 0.35 * Action выбран "Максимальный курс" feeRate = FeePercent / 100 = 7/100 = 0.07 \ in = in + (in \* feeRate) = 1 + (1*0.07)=1.07* \ *discountRate = discount / 100 = 0* \ *in = in - (in \* discountRate) = 1.07 - (1.07*0) = 1.07 \ RATE (окончательный курс обмена)= out / in = 34256.00/1.07= 32014.9533 ЕСЛИ RATE ≥ Курс страхования -> срабатывает страховка курса \ \ Текущий курс страховки = RateTo/RateFrom-defaultPercent = 34090 / 1 - 7% = 31703.7\ Курс страхования = Текущий курс страховки + maxLimitPercent = 31703.7 + 0.35% = 1 : 31814.6629 \ \ Rate (32014.9533) > Курса страхования (31814.6629) -> **страховка курса срабатывает и клиент будет видеть Курс страхования, а именно** 31814.6629
Пример 4 - Страховка срабатывает / Action: Отключить направление * Для направления указан курс обмена "Вручную": (in:out) 1:41.37 * Процент комиссии (FeePercent): 4 * Значение "DISCOUNT FOR AMOUNT (discount): 0 * В страховке курса указан тип "Вручную": (RateFrom:RateTo) 1:42.08 * Значение "Default percent" (defaultPercent): 8 * Значение "Max limit difference percent" (maxLimitPercent): 1.1 * Action выбран "Отключить направление" feeRate - FeePercent / 100 = 4 / 100 = 0.04 in = in + (in \* feeRate) = 1 + (1 \* 0.04) = 1.04 \ discountRate = discount / 100 = 0 / 100 = 0\ *in = in - (in \* discountRate) = 1.04 - (1.04\*0) = 1.04* \ RATE = out / in = 41.37 / 1.04 = 39.778 ЕСЛИ RATE ≥ Курс страхования -> срабатывает страховка курса Текущий курс страховки = manualRateTo/manualRateFrom-defaultPercent = 42.08 / 1 - 8% = 38.7136 \ Курс страхования = Текущий курс страховки + maxLimitPercent = 38.7136 + 1.1% = 39.139 RATE (39.778) > Курса страхования (39.139) -> **сработает страховка курса и направление будет отключено**.
[^1]: ![](/files/ALLji5gWCwgrF0Cmz44R) # SEO-friendly URL (ЧПУ) Инструкция по настройке SEO-friendly URL (ЧПУ) ### 1. SEO Friendly url значения по умолчанию В настройках направления - шаг "Верификация" - для поля "[**SEO FRIENDLY URL**](#user-content-fn-1)[^1]" переведите ползунок в активное положение и укажите ключ ссылку на данное направление. В результате по ссылке, которая имеет структуру: `https://yoursiteurl/ru/exchange/значение из поля "SEO friedly url"/` будет доступна [**страница с обменом**](#user-content-fn-2)[^2] по направлению. ### 2. Уникальные значения для текста на странице {% hint style="info" %} Если же вы хотите отредактировать текст на данной странице, то вам нужно будет активировать поля "SEO TITLE "TAG: H1"", "SEO SUB-TITLE "TAG: H2"", "SEO DESCRIPTION "META:DESCRIPTION"", "SEO KEYWORDS "META:KEYWORDS"", "SEO INSTRUCTION "ADDITIONAL TEXT"" и указывать в них желаемый тест. {% endhint %} Разберем на примере, какое поле за что отвечает. Пример заполнения полей на скриншоте 1 и результат SEO-frindly URL на клиентской части на скриншоте 2.

Скриншот 1

Скриншот 2

[^1]: ![](/files/vAftAEzMphGYC6sGkSwe) [^2]: ![](/files/DnvMNRDpDhD0iDDQCK9E) # Документы Инструкция по настройке загрузки документов Функционал "**Документы**" позволяет запросить у клиента, к примеру, инвойс об оплате на любом из этапов заявки. {% hint style="info" %} Поддерживаемые форматы изображений для загрузки на странице заяки, в блоке "**Документы**": .png, .jpeg, .jpg {% endhint %} ## Добавление Для того чтобы добавить блок с загрузкой документов в заявку, перейдите в настройки направления -> шаг "**Верификации**" -> в разделе "**Документы**", нажмите "[**Добавить**](#user-content-fn-1)[^1]". Следуйте инструкции: 1. В поле "**Заголовок**" укажите подходящий заголовок, который будет отображаться на странице заявки в блоке загрузки документа. 2. Для поля "**Статус**", из выпадающего списка, выберите статус заявки, для которой будет отображаться блок с загрузкой документов. Подробнее о статусах заявки вы можете узнать в инструкции: [Статусы заявки](/zayavki/zayavki/statusy-zayavki) 3. В разделе "**Описание**" укажите инструкцию для клиента. {% hint style="info" %} Текст в разделе "**Описание**" возможно локализировать с помощью языковых тегов. Пример локализации на [**скриншоте**](#user-content-fn-2)[^2]. {% endhint %} 1. В поле "**Количество фото**" укажите обязательное количество изображения для загрузки. 2. Сохраните настройки направления. Пример настройки на [**скриншоте**](#user-content-fn-3)[^3]. {% hint style="info" %} Для каждого статуса заявки возможно добавить не более одного запроса документов {% endhint %} ## Загрузка документов На странице заявки для выбранного статуса, будет отображаться [**блок с загрузкой**](#user-content-fn-4)[^4] документов. Для загрузки документов необходимо: 1. На странице заявки нажать на "[**Upload**](#user-content-fn-5)[^5]" в блоке документов. 2. В появившемся окне ознакомиться с инструкцией, которая была указана при настройке документа в разделе "**Описание**". 3. Нажать на блок загрузки изображений -> загрузить необходимое количество изображений. 4. После успешной загрузки, будет отображено уведомление "[**Accepted**](#user-content-fn-6)[^6]". {% hint style="info" %} Для того чтобы документы были приняты, клиенту необходимо загрузить ровно то количество изображений, которое было указано при настройке документов в поле "Количество фото". {% endhint %} ## Взаимодействие с загруженными документами Загруженные документы отображаются в деталях заявки. Для того чтобы ознакомиться с загруженными документами необходимо: 1. На странице "**Список обменов**" -> перейти в детали заявки. 2. В разделе "[**Documents**](#user-content-fn-7)[^7]" нажать на иконку файла. 3. В открывшимся окне ознакомиться с документами. У вас есть возможность: а) [**Нажать**](#user-content-fn-8)[^8] на изображение документа чтобы его увеличить. \ б) Получить информацию о дате и времени загрузки документа. \ в) Получить информацию о статусе заявки, для которого были загружены документы. [^1]: ![](/files/G3866E7Ct9Vg3r8H19O3) [^2]: ![](/files/AUswumptNIDGPEWIO1UT) [^3]: ![](/files/gqn3WLl62aZbtUoA3Qpm) [^4]: ![](/files/PRzxNQjlw6pgNKTHs3Jk) [^5]: ![](/files/rRKpBiB5gcGw0a08cnG3) [^6]: ![](/files/XKDN8CUz49lLueNvHpRL) [^7]: ![](/files/YDYWINwRFbAdASxX1NIJ) [^8]: ![](/files/hJWgDHjvKnRj7Dt6dmhg) # Дополнительные услуги Инструкция по работе функционала дополнительных услуг для направления ## Описание Функционал позволяет добавить перечень платных (за дополнительную комиссию) услуг при обмене. \ В случае, если для направления добавлены дополнительные платные услуги, то на этапе создания заявки, клиент сможет отметить их галочкой при этом заплатив дополнительную комиссию.
{% hint style="info" %} Выбранные для заявки услуги будут отображаться в деталях заявки в админ панели. Подробнее в разделе [**дополнительные услуги**](/zayavki/zayavki#dopolnitelnye-uslugi)**.** {% endhint %} ### Расчет стоимости услуги 1. Стоимость комиссии за услугу рассчитывается в валюте OUT по "Курсу к USD", который указан в настройках валюты, по формуле `стоимость услуги/курс к USD`.\ \ **Пример**:\ \- Направление: Tether TRC20 -> Visa/MasterCard UAH \ \- Валюта Visa/MasterCard UAH: **точность суммы: 2, курс к USD = 0.0238** \ \- Стоимость услуги в USD: 7\ \- Стоимость услуги в валюте OUT: `7/0.0238 = 294.11 UAH`. {% hint style="info" %} Обратите внимание, что округление стоимости услуги происходит в меньшую сторону и количество знаков после `.` соответствует точности суммы в настройках валюты OUT (в нашем примере это 2, то есть 2 знака после запятой). {% endhint %} 2. Если клиент выбрал платную услуги, то ее стоимость будет учитываться как комиссия в сумме, которую получит клиент. \ \ **Пример**:\ \- Направление: Tether TRC20 -> Visa/MasterCard UAH \ \- Курс: 1 USDT:42 UAH\ \- Стоимость услуги в валюте OUT: 294.11 UAH\ \- За 100 Tether TRC20 клиент получит 3905.89 Visa/MasterCard UAH (так как при расчете суммы получения была учтена комиссия за услугу) 3. Стоимость услуги будет учитываться при расчете [**чистой прибыли**](/zayavki/zayavki#chistaya-pribyl) по обмену. ## Настройка 1. В разделе "**Направления**" - откройте страницу "**Services**" -> нажмите "[**Add new service**](#user-content-fn-1)[^1]". 2. В модальном окне "**Create Additional Service**", в поле "**Title**" укажите название услуги, которое будет отображаться клиенту -> в поле "**Description**" укажите описание услуги (будет видно только в админ панели) -> в поле "**Admin Note**" укажите внутренний комментарий (будет виден только в админ панели) -> в поле "**Amount**" укажите стоимость услуги в USD -> нажмите "[**Save**](#user-content-fn-2)[^2]". 3. Зайдите в настройки направления, для которого вы хотите добавить платные услуги -> перейдите к шагу "**Верификация**" - в разделе "[**Additional services**](#user-content-fn-3)[^3]" поставьте галочку напротив необходимой услуги -> сохраните направление. 4. Теперь на странице создания заявки, клиент сможет выбрать дополнительную платную услугу. Пример на [**скриншоте**](#user-content-fn-4)[^4]. {% hint style="info" %} Обратите внимание, если после настройки функционала, у вас не появилась возможность выбора услуги на этапе создания заявки, то вероятнее всего у вашего обменника уникальный дизайн и необходимо обратиться в группу с персональной поддержкой BoxExchanger, для того чтобы получить последние обновления для exchanger-client-web и установить их в вашу ветку. {% endhint %} [^1]: ![](/files/Z4eys6bFP53xW7QKLX4V) [^2]: ![](/files/jdsDje7AmoSF1EIUOZ9Q) [^3]: ![](/files/wSioJDe82nYujBm5sgg2) [^4]: ![](/files/2uwxQYOpz3r1HUTaE4bH) # Настройка группы направлений ### 1. Создание * В админ-панели, слева выберите раздел "**Направления**" - "**Группы направлений"** и нажмите "**Создать группу**".
* Введите название группы и добавьте нужные направления.\ ![](https://4161505393-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKpJa5EXucNjDQV4ak2D8%2Fuploads%2FUOUVrgfBX36PImLIm8PO%2Fimage.png?alt=media\&token=c1a1a42b-1232-41be-8155-bf502a04c024) {% hint style="info" %} * 1.При добавлении направления в группу - данное направление перестает отображаться в выпадающем списке. Также при удалении направления из группы - оно снова отображается в выпадающем списке направлений. * 2.С помощью кнопок "\" вы можете перемещаться на следующую/предыдущую страницу списка направлений. {% endhint %} - Далее нажмите "Создать".\ ![](https://4161505393-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKpJa5EXucNjDQV4ak2D8%2Fuploads%2FjvDpGnA8KnUdvgB0gv43%2Fimage.png?alt=media\&token=7a091acd-4875-4f96-97d4-9b6a6d6f2348) Созданная группа отобразится в списке групп направлений.
## 2. Управление ### 2.1 Редактировать группу * В случае, если вы хотите отредактировать название группы либо удалить/добавить направление в группу - нажмите "**Редактировать группу**" - внесите изменения - нажмите "**Сохранить**".
### 2.2 Изменить **По умолчанию заполнены данные из первого направления. Все измененные параметры будут применены ко всем направлениям в группе.** * Рекомендуем для начала ознакомиться с мануалом по настройке направления так как интерфейс и функционал по настройке группы направлений практически идентичен. {% content-ref url="/pages/gShQZZ1fD1LZK05S4Ct4" %} [Направление](/obmen/napravlenie) {% endcontent-ref %} * Единственное и главное отличие - изменения будут применяться ко всем направлениям в группе. Для внесения изменений - нажмите "**Изменить**".
**2.2.1 Разберем на примере изменения значения "Процента комиссии".** {% hint style="warning" %} **В текущей группе по умолчанию выставлен 1% комиссии, так как в первом направление, а именно "AptosAPT - BitcoinBTC" было выставлено значение 1% в поле "Процент комиссии". По такому же принципу подтягиваются значения и для остальных полей.** ​![](https://4161505393-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKpJa5EXucNjDQV4ak2D8%2Fuploads%2FryPciflL5nNkCHjuo6jb%2Fimage.png?alt=media\&token=0aad9671-821e-4a89-b0e5-2740a877bbe6) {% endhint %} * Изменяем значение поля "**Процент комиссии**" - сохраняем изменения, нажимая на кнопку "**Сохранить и продолжить**".
* После сохранения изменений, в случае, если изменения были применены, вы увидите уведомление о количестве обновленных направлений.
**Если изменений в направления внесено не было, то вы увидете уведомление об успешном сохранении без дополнительной информации.**​
* **По такому же принципу вы можете изменять поля на каждом шаге настроек.** ### 2.3 Удаление Для удаления группы - нажмите на значок "Trash Bin".
# Мерчант и АПИ # Шаблон # \[Название сервиса] Навигационная страница по настройке \[Название сервиса]
Мерчант [Название сервиса]Ознакомьтесь с инструкцией по настройке мерчанта [Название сервиса]
Выплаты [Название сервиса]Ознакомьтесь с инструкцией по настройке модуля выплаты [Название сервиса]
Взаимодействие модулей [Название сервиса]Узнайте подробнее о работе связки мерчанта и модуля выплаты [Название сервиса]
Парсер [Название сервиса]Ознакомьтесь с инструкцией по настройке парсера [Название сервиса]
Дополнительные модулиОзнакомьтесь с инструкцией по настройке дополнительных модулей [Название сервиса]
# Взаимодействие модулей \[Название сервиса] Подробное описание взаимодействия мерчанта и модуля выплаты \[Название сервиса] для автоматической работы {% hint style="info" %} {% endhint %} ## Настройка авто конвертации 1. Необходимо настроить [Мерчант Okipays](/obmen/merchant-i-api/okipays/merchant-okipays)и модуль [Выплаты Okipays](/obmen/merchant-i-api/okipays/vyplaty-okipays). {% hint style="warning" %} Обратите внимание, что **валюта в которую будет производиться авто конвертация (***"***Auto Convert*****" в настройках мерчанта*****) и валюта из которой будет происходить выплата (*****"*****Auto Convert*****" в настройках модуля выплат*****) должны совпадать для автоматизации процесса.** {% endhint %} 2. На странице настроек мерчанта Okipays указываем для "**Auto Convert**" параметр "**USDT**" - нажимаем "**Save**". 3. На странице настроек модуля выплат Okipays указываем для "**Auto Convert**" параметр "**USDT**" - нажимаем "**Save**". ## Принцип работы К примеру, клиент хочет обменять **0.1 BTC на 40 LTC.** 1. Валюту BTC мы будем принимать через мерчант Okipays (то есть Okipays сгенерирует уникальный адрес для депозита под конкретную заявку). 2. После того как сумма в BTC (указанная в заявке или больше, то есть **≥0.1 BTC**) поступит на указанный - BTC будет конвертирован в USDT. 3. Мерчант Okipays поменяет статус заявки на [Статусы заявки](/zayavki/zayavki/statusy-zayavki#na-vyplatu) и в комментарии к данному действию обозначит, что депозит BTC успешно получен. 4. Далее необходимо выплатить LTC клиенту. В зависимости от настроек "[Авто обмена](#user-content-fn-1)[^1]" (в настройках направления) может произойти следующее: \ а) Если "Авто обмен" выключен, то для запуска модуля выплаты (чтобы начать выплату LTC на указанный клиентов адрес), оператору необходимо будет нажать кнопку "[ALLOW AUTO PAYOUT](#user-content-fn-2)[^2]" в админ панеле в деталях заявки. \ б) Если "Авто обмен" включен, то выплата начнется автоматически. 5. Как только модуль выплаты запущен - начинается процесс выплаты, в вашем аккаунте Okipays USDT конвертируется в LTC. 6. Выставляется запрос на вывод 40 LTC на адрес, указанный клиентом в заявке. 7. После успешной выплаты, модуль выплаты меняет статус заявки на [Статусы заявки](/zayavki/zayavki/statusy-zayavki#zavershena). [^1]: ![](/files/Uf2KujaEoEowWK2d2i0A) [^2]: ![](/files/3OWmN0jcgnZIVXrNhwgN) # Мерчант \[Название сервиса] Инструкция по настройке мерчанта \[Название сервиса] {% stepper %} {% step %} ## Установка мерчанта Используя параметры ниже, установите мерчант через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin).
Параметры для Install Plugin **Plugin type**: **`Merchant module`** **Plugin URL**: **`@`** **Directory path**: **`path`** **Auth: (Deploy token)**: оставляем пустым **Package tag**: **`latest`**
{% endstep %} {% step %} ## Настройка мерчанта {% hint style="info" %} {% endhint %} 1. {% endstep %} {% step %} ### Дополнительные настройки * * **Debug log** - передача дополнительных логов команде BoxExchanger. В случае трудностей при работе модуля, установите значение "**Yes**" -> "**Save**" и обратитесь к поддержке BoxExchanger. {% endstep %} {% endstepper %} # Выплаты \[Название сервиса] Инструкция по настройке модуля выплаты \[Название сервиса] {% stepper %} {% step %} ## Установка модуля Используя параметры ниже, установите модуль выплаты через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin).
Параметры для Install Plugin **Plugin type**: **`Payout module`** **Plugin URL**: **`@`** **Directory path**: **`name`** **Auth: (Deploy token)**: оставляем пустым **Package tag**: **`latest`**
{% endstep %} {% step %} ## Настройка модуля {% hint style="info" %} {% endhint %} 1. {% endstep %} {% step %} ### Дополнительные настройки * * **Debug log** - передача дополнительных логов команде BoxExchanger. В случае трудностей при работе модуля, установите значение "**Yes**" -> "**Save**" и обратитесь к поддержке BoxExchanger. {% endstep %} {% endstepper %} # Парсер \[Название сервиса] Инструкция по настройке парсера \[Название сервиса] {% stepper %} {% step %} ## Установка парсера Используя параметры ниже, установите парсер через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin).
Параметры для Install Plugin **Plugin type**: **`Parser-rate module`** **Plugin URL**: **`@`** **Directory path**: **`name`** **Auth: (Deploy token)**: оставляем пустым **Package tag**: **`latest`**
{% endstep %} {% step %} ## Настройка парсера * Для запуска парсера, следуйте инструкции [Парсер курсов](/obmen/parser-kursov#konfiguraciya-parsera). * **Интервал (ms)** оставляйте без изменений. Изменение данного параметра не влияет на частоту обновлений курсов. {% endstep %} {% endstepper %} # \[Название сервиса] модули Навигационная страница \[Название сервиса] модулей
[Название сервиса] auto update feeОзнакомьтесь с инструкцией по настройке модуля [Название сервиса] auto update fee
[Название сервиса] control availableОзнакомьтесь с инструкцией по настройке модуля [Название сервиса] control available
[Название сервиса] auto min amount for TO currencyОзнакомьтесь с инструкцией по настройке модуля [Название сервиса] auto min amount for TO currency
# \[Название сервиса] auto update fee Инструкция по настройке модуля \[Название сервиса] auto update fee {% stepper %} {% step %} ## Описание модуля Модуль "\[Название сервиса] auto update fee" позволяет автоматически выставлять параметры "Сумма комиссии" и "Сумма потери" в направлениях, в которых для валюты вывода используется модуль выплаты \[Название сервиса]. Значения для параметров выставляются в соответствии с комиссиями при выводе валюты на Okipays. {% endstep %} {% step %} ## Установка модуля Используя параметры ниже, установите модуль через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin).
Параметры для Install Plugin **Plugin type**: **`External module`** **Plugin URL**: **`@`** **Directory path**: **`name`** **Auth: (Deploy token)**: оставляем пустым **Package tag**: **`latest`**
{% endstep %} {% step %} ## Конфигурация {% hint style="info" %} {% endhint %} 1. [**Зарегистрируйтесь**](#user-content-fn-1)[^1] в Okipays по [**ссылке**](https://okipays.com/sign-up) -> войдите в ЛК. 2. В ЛК Okipays, перейдите на страницу "**Settings**" - раздел "**Merchant**" -> нажмите "[**Add merchant**](#user-content-fn-2)[^2]". 3. На страницу добавления мерчанта -> в поле "**Name**" укажите название мерчанта -> в поле "**Home URL**" укажите ссылку на ваш сайт в формате **`https://www.exchanger.com`** -> поставьте галочку напротив поля "**Generate API credentials**" -> в поле "**Result URL**" укажите любо ссылку на ваш сайт либо "IPN URL" из админ панели скрипта - страницы настроек мерчанта (если также будете использовать модуль приема Okipays. Инструкция: [Мерчант Okipays](/obmen/merchant-i-api/okipays/merchant-okipays)) -> скопируйте значения "**Token**" и "**Secret**" в надежное место. 4. После создания мерчанта из шага 3, на странице настроек мерчанта скопируйте значения "**Token**" и "**Secret**" в надежное место. 5. В админ панели скрипта зайдите на страницу "**Доп модули**" -> в разделе "**MODULE SYSTEM**" [**нажмите**](#user-content-fn-3)[^3] на значок настроек в блоке с модулем "**Okipays auto-update out fee**". 6. На странице настроек модуля, в поле "**API Key**" укажите значение "**Token**" из шага 4 -> нажмите "**Save**" -> в поле "**Secret Key**" укажите значение "**Secret**" из шага 4 -> нажмите "**Save**". 7. **API URL** - ссылка для API запросов Okipays. В случае, если у Okipays изменится ссылка для API запросов, то в поле "**API URL**" вы можете указать новую ссылку -> нажать "**Save**". 8. Для того чтобы включить модуль, на странице настроек "**Okipays auto-update out fee**" укажите значение "**1**" в поле "**Enable module**" -> нажмите "**Save**". {% hint style="info" %} По умолчанию, включенный модуль выставляет в направлении только значение для параметра "**Сумма потери**". \ В случае, если необходимо выставлять также и "**Сумму комиссии**", то необходимо включить поле "**Enable Update "Fee amount"**". {% endhint %} 7. В поле "**Enable Update "Fee amount"**" укажите один из вариантов по таблице ниже -> Нажмите "**Save**". | 0 | 1 | | :-----------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------: | | Значение "**0**", если не требуется чтобы модуль автоматически выставлял значение "**Сумма комиссии**". | Значение "**1**", если требуется чтобы модуль автоматически выставлял значение "**Сумма комиссии**". | 8. Для поля "**Routes detect by**" выберите один из вариантов по таблице ниже -> Нажмите "**Save**". | List of Payout key(s) | List of XML(s) | | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | | При данном параметре модуль будет устанавливать значения "**Сумма потери**" и "**Сумма комиссии**" (если включено поле "**Enable Update "Fee amount"**") исключительно в направлениях, в которых для валюты вывода используется модуль выплаты Okipays (который будет указан в следующем поле "**Check routes**"). | При данном параметре модуль будет устанавливать значения "**Сумма потери**" и "**Сумма комиссии**" (если включено поле "**Enable Update "Fee amount"**") в направлениях, в которых валюта (XML для которой будет указан в следующем поле "**Check routes**") выступает в качестве валюты вывода. | 9. В поле "**Check routes**" укажите: 1. Directory path модуля(-ей) выплаты Okipays, если на шаге 5 вы выбрали "**List of Payout key(s)**". Directory path модуля возможно найти на странице настроек модуля выплаты в адресной строке. Пример на [**скриншоте**](#user-content-fn-4)[^4]. \ **Пример**: **`okipays,okipays-2`** -> Нажмите "**Save**". 2. XML валют, если на шаге 5 вы выбрали "**List of XML(s)**". XML необходимо указывать в формате: **`XML1,XML2,XML3`** (заглавными буквами, через запятую, без пробелов)\ **Пример**: **`USDTTRC20,BTC,ETH,TRX,USDTERC20`** -> Нажмите "**Save**". 10. В поле "**Ignore routes by ID**" вы можете указать routeid направлений, которые модуль будет игнорировать при выставлении значений "Сумма потери" и "Сумма комиссии". \ **Пример**: **`662b69be181771c84d8176a8,662b69be181771c84d8176a9`** -> Нажмите "**Save**". {% hint style="info" %} **`routeid`** направления возможно найти на странице настроек направления в адресной строке. Пример на [**скриншоте**](#user-content-fn-5)[^5]. {% endhint %} 11. Через 60 секунд после сохранения параметров выше, модуль выставит значения "**Сумма потери**" и "**Сумма комиссии**" (если включено поле "**Enable Update "Fee amount"**") в направлениях, которые подходят под критерии. \ Каждые 60 секунд модуль обновляет значения "**Сумма потери**" и "**Сумма комиссии**", в случае если комиссия за вывод валюты на Okipays изменилась. К примеру, такой сценарий актуален для токенов в сети Ethereum (ERC20), так как на Okipays для подобных токенов динамическая комиссия на вывод. {% endstep %} {% endstepper %} [^1]: ![](/files/karGHrwMIQcm14fMneQp) [^2]: ![](/files/g9W8sWXRHvW6D10nkwCF) [^3]: [^4]: ![](/files/uUMU3GUd1mOqXgvtdzxa) [^5]: ![](/files/OfOOazh78zk6eu23WLNj) # Okipays control available Инструкция по настройке модуля Okipays control available {% stepper %} {% step %} ## Описание модуля Модуль "**Okipays control available**" позволяет мониторить статус депозита/вывода валют на Okipays и в зависимости от их статуса отключать/включать направления, в которых Okipays используется в качестве модуль приема/выплаты. \ \ **Пример 1**: В случае если на Okipays будет временно закрыт депозит BTC, то модуль автоматически отключит все направления BTC->Сurrency, то есть в которых BTC является валютой приема. \ Далее, если депозит BTC станет снова доступен на Okipays, то модуль автоматически включит направления BTC->Сurrency. \ \ **Пример 2**: В случае если на Okipays будет временно закрыт вывод BTC, то модуль автоматически отключит все направления Currency->BTC, то есть в которых BTC является валютой вывода. \ Далее, если вывод BTC станет снова доступен на Okipays, то модуль автоматически включит направления Currency->BTC. {% endstep %} {% step %} ## Установка модуля Используя параметры ниже, установите модуль через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin).
Параметры для Install Plugin **Plugin type**: **`External module`** **Plugin URL**: **`@boxexchanger-plugins/module-okipays-control-route`** **Directory path**: **`okipays-control-route`** **Auth: (Deploy token)**: оставляем пустым **Package tag**: **`latest`**
{% endstep %} {% step %} ## Конфигурация {% hint style="info" %} В случае, если вы уже зарегистрировались в Okipays и добавили мерчант в ЛК Okipays, то перейдите на страницу настроек мерчанта в ЛК Okipays и начните с шага 4. {% endhint %} 1. [**Зарегистрируйтесь**](#user-content-fn-1)[^1] в Okipays по [**ссылке**](https://okipays.com/sign-up) -> войдите в ЛК. 2. В ЛК Okipays, перейдите на страницу "**Settings**" - раздел "**Merchant**" -> нажмите "[**Add merchant**](#user-content-fn-2)[^2]". 3. На страницу добавления мерчанта -> в поле "**Name**" укажите название мерчанта -> в поле "**Home URL**" укажите ссылку на ваш сайт в формате **`https://www.exchanger.com`** -> поставьте галочку напротив поля "**Generate API credentials**" -> в поле "**Result URL**" укажите любо ссылку на ваш сайт либо "IPN URL" из админ панели скрипта - страницы настроек мерчанта (если также будете использовать модуль приема Okipays. Инструкция: [Мерчант Okipays](/obmen/merchant-i-api/okipays/merchant-okipays)) -> скопируйте значения "**Token**" и "**Secret**" в надежное место. 4. После создания мерчанта из шага 3, на странице настроек мерчанта скопируйте значения "**Token**" и "**Secret**" в надежное место. 5. В админ панели скрипта зайдите на страницу "**Доп модули**" -> в разделе "**MODULE SYSTEM**" [**нажмите**](#user-content-fn-3)[^3] на значок настроек в блоке с модулем "**Okipays control available**". 6. На странице настроек модуля, в поле "**API Key**" укажите значение "**Token**" из шага 4 -> нажмите "**Save**" -> в поле "**Secret Key**" укажите значение "**Secret**" из шага 4 -> нажмите "**Save**". 7. **API URL** - ссылка для API запросов Okipays. В случае, если у Okipays изменится ссылка для API запросов, то в поле "**API URL**" вы можете указать новую ссылку -> нажать "**Save**". 8. Для того чтобы включить модуль, на странице настроек "**Okipays control available**" укажите значение "**1**" в поле "**Enable module**" -> нажмите "**Save**". 9. Для проверки статуса депозита валют на прием, в поле "**Merchant IDs**" укажите Directory path модуля(-ей) приема Okipays. Directory path мерчанта возможно найти на странице настроек модуля приема в адресной строке. Пример на [**скриншоте**](#user-content-fn-4)[^4]. \ **Пример**: **`okipays,okipays-2`** -> Нажмите "**Save**". {% hint style="info" %} Модуль будет проверять статус депозита валют на Okipays и в зависимости от статуса включать/отключать направления, в которых для валюты приема установлен мерчант Okipays (Directory path которого вы указали в поле "**Merchant IDs**"). {% endhint %} 8. Для проверки статуса вывода валют на выплату, в поле "**Payout IDs**" укажите Directory path модуля(-ей) выплаты Okipays. Directory path выплаты возможно найти на странице настроек модуля выплаты в адресной строке. Пример на [**скриншоте**](#user-content-fn-5)[^5]. \ **Пример**: **`okipays,okipays-2`** -> Нажмите "**Save**". {% hint style="info" %} Модуль будет проверять статус вывода валют на Okipays и в зависимости от статуса включать/отключать направления, в которых для валюты вывода установлена выплата через Okipays (Directory path которого вы указали в поле "**Payout IDs**"). {% endhint %} 9. **Debug log** - передача дополнительных логов команде BoxExchanger. В случае трудностей при работе модуля, установите значение "**Yes**" -> "**Save**" и обратитесь к поддержке BoxExchanger. 10. Через 2 минуты после сохранения параметров выше, модуль начнет отключать направления, которые подходят под критерии. \ Каждые 2 минуты модуль обновляет информацию о статусе депозита/вывода валют и может отключать/включать направления, которые подходят под критерии. {% endstep %} {% endstepper %} [^1]: ![](/files/karGHrwMIQcm14fMneQp) [^2]: ![](/files/g9W8sWXRHvW6D10nkwCF) [^3]: ![](/files/HjaL0i0pVLdgM1DSytwE) [^4]: ![](/files/WYbkxfsc0LkQPPKpPFnn) [^5]: ![](/files/XVwkkFjlMJFFH0FX4Yot) # Okipays auto min amount for TO currency Инструкция по настройке модуля Okipays auto min amount for TO currency {% stepper %} {% step %} ## Описание модуля Модуль "**Okipays auto min amount for TO currency**" устанавливает минимальные лимиты для валюты выплаты по указанному проценту комиссии так, чтобы полученная прибыль от обмена по направлению, покрывала затраты на вывод валюты из Okipays. \ Данный модуль полезен для случаев, когда обменный пункт не хочет перекладывать комиссию за вывод с биржи (к примеру, для того чтобы на мониторингах располагаться выше в ТОПе) на клиента и покрывать данную комиссию за счет прибыли по направлению, которая будет обеспечена за счет больших лимитов по направлению. **Формула для расчета** **`Минимальная сумма обмена = сумма статической комиссии вывода на Okipays / ((процент комисии - процент потери)/100)*inaccuracy`** **Пример:** Направление USDT TRC20 - POL. * Процент комиссии: 1.1% * Процент потери: 0.1% * Комиссия за вывод POL на Okipays: 0.1 POL Если мы зададим значение inaccuracy - 1.0 (значение для безубытка), то в итоге мы получим: **`Минимальная сумма обмена (POL) = 0.1 / ((1.1 - 0.1)/100)*1=10`** Минимальные лимиты для направления USDT TRC20 - POL будут установлены 10 POL, так как именно при данной сумме обмена, чистая прибыль сможет покрыть потери 0.1 POL при выводе с Okipays Стандартно для модуля значения inaccuracy указано 1.05, при таких значениях для этого примера минимальные лимиты будут 10.5 MATIC, что даст небольшую прибыль. {% endstep %} {% step %} ## Установка модуля Используя параметры ниже, установите модуль через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin).
Параметры для Install Plugin **Plugin type**: **`External module`** **Plugin URL**: **`@boxexchanger-plugins/module-okipays-control-route`** **Directory path**: **`okipays-control-route`** **Auth: (Deploy token)**: оставляем пустым **Package tag**: **`latest`**
{% endstep %} {% step %} ## Конфигурация {% hint style="info" %} В случае, если вы уже зарегистрировались в Okipays и добавили мерчант в ЛК Okipays, то перейдите на страницу настроек мерчанта в ЛК Okipays и начните с шага 4. {% endhint %} 1. [**Зарегистрируйтесь**](#user-content-fn-1)[^1] в Okipays по [**ссылке**](https://okipays.com/sign-up) -> войдите в ЛК. 2. В ЛК Okipays, перейдите на страницу "**Settings**" - раздел "**Merchant**" -> нажмите "[**Add merchant**](#user-content-fn-2)[^2]". 3. На страницу добавления мерчанта -> в поле "**Name**" укажите название мерчанта -> в поле "**Home URL**" укажите ссылку на ваш сайт в формате **`https://www.exchanger.com`** -> поставьте галочку напротив поля "**Generate API credentials**" -> в поле "**Result URL**" укажите любо ссылку на ваш сайт либо "IPN URL" из админ панели скрипта - страницы настроек мерчанта (если также будете использовать модуль приема Okipays. Инструкция: [Мерчант Okipays](/obmen/merchant-i-api/okipays/merchant-okipays)) -> скопируйте значения "**Token**" и "**Secret**" в надежное место. 4. После создания мерчанта из шага 3, на странице настроек мерчанта скопируйте значения "**Token**" и "**Secret**" в надежное место. 5. В админ панели скрипта зайдите на страницу "**Доп модули**" -> в разделе "**MODULE SYSTEM**" [**нажмите**](#user-content-fn-3)[^3] на значок настроек в блоке с модулем "**Okipays auto min amount for TO currency**". 6. На странице настроек модуля, в поле "**API Key**" укажите значение "**Token**" из шага 4 -> нажмите "**Save**" -> в поле "**Secret Key**" укажите значение "**Secret**" из шага 4 -> нажмите "**Save**". 7. **API URL** - ссылка для API запросов Okipays. В случае, если у Okipays изменится ссылка для API запросов, то в поле "**API URL**" вы можете указать новую ссылку -> нажать "**Save**". 8. Для того чтобы включить модуль, на странице настроек "**Okipays auto min amount for TO currency**" укажите значение "**1**" в поле "**Enable module**" -> нажмите "**Save**". 9. В поле "**inaccuracy**" укажите коэффициент для получения прибыли. {% hint style="info" %} К примеру, при значении **`1`** модуль будет выставлять минимальный лимит для валюты, при котором обмен будет выполнен с нулевой прибылью. \ Однако, при значении **`1.05`** модуль выставит минимальный лимит для валюты выплаты, при котором омбен будет выполнен с прибылью для обменного пункта. {% endhint %} 8. В поле "**Check routes**" укажите: 1. Directory path модуля(-ей) выплаты Okipays, если на шаге 5 вы выбрали "**List of Payout key(s)**". Directory path модуля возможно найти на странице настроек модуля выплаты в адресной строке. Пример на [**скриншоте**](#user-content-fn-4)[^4]. \ **Пример**: **`okipays,okipays-2`** -> Нажмите "**Save**". 2. XML валют, если на шаге 5 вы выбрали "**List of XML(s)**". XML необходимо указывать в формате: **`XML1,XML2,XML3`** (заглавными буквами, через запятую, без пробелов)\ **Пример**: **`USDTTRC20,BTC,ETH,TRX,USDTERC20`** -> Нажмите "**Save**". 9. В поле "**Ignore routes by ID**" вы можете указать routeid направлений, которые модуль будет игнорировать при выставлении значений "Сумма потери" и "Сумма комиссии". \ **Пример**: **`662b69be181771c84d8176a8,662b69be181771c84d8176a9`** -> Нажмите "**Save**".

routeid направления возможно найти на странице настроек направления в адресной строке. Пример на скриншоте.

10. **Debug log** - передача дополнительных логов команде BoxExchanger. В случае трудностей при работе модуля, установите значение "**Yes**" -> "**Save**" и обратитесь к поддержке BoxExchanger. 11. Через 60 секунд после сохранения параметров выше, модуль выставит минимальные лимиты для валют выплаты в направлениях, которые подходят под критерии.\ Каждые 60 секунд модуль обновляет минимальные лимиты для валют выплаты, в случае если комиссия за вывод валюты на Okipays изменилась. {% endstep %} {% endstepper %} [^1]: ![](/files/karGHrwMIQcm14fMneQp) [^2]: ![](/files/g9W8sWXRHvW6D10nkwCF) [^3]: ![](/files/LXj9FNZlUHIs871DsvfK) [^4]: ![](/files/XVwkkFjlMJFFH0FX4Yot) [^5]: ![](/files/OfOOazh78zk6eu23WLNj) # 001k bot Навигационная страница по настройке 001k bot
Мерчант 001k botОзнакомьтесь с инструкцией по установке мерчанта 001k bot/pages/RdfiNbRBleB4dxEuZrVa
Выплаты 001k botОзнакомьтесь с инструкцией по установке модуля выплаты 001k bot/pages/11DtH8qdpMkxgBHTKjpo
# Мерчант 001k bot Инструкция по настройке мерчанта 001k bot ## Установка мерчанта Используя параметры ниже, установите мерчант через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin).
Параметры для Install Plugin **Plugin type**: **`Merchant module`** **Plugin URL**: **`@boxexchanger-plugins/merchant-001k`** **Directory path**: **`001k`** **Auth: (Deploy token)**: оставляем пустым **Package tag**: **`latest`**
## Активация API {% hint style="info" %} В случае, если у вас уже активирован API - переходите к разделу [#nastroika-api](#nastroika-api "mention") {% endhint %} 1. Откройте Telegram 001k bot по [ссылке](https://t.me/OO1kBOT?start=ieEYGJR78ex) -> нажмите "**START**" 2. Нажмите кнопку "**Инфо**" -> скопируйте UID -> нажмите "[**Поддержка**"](#user-content-fn-1)[^1]. 3. В личных сообщениях с представителем поддержки 001k Bot Support, отправьте запрос на активацию API. **Подробнее о запросе в выпадающем списке ниже.**
Необходимая информация в запросе 1. UID, который вы скопировали на шаге 2. 2. Название и ссылка на ваш обменный сервис. 3. Интересующие пары для обмена. 4. Тип операции (депозит/вывод/swap)
4. После успешной активации API, в 001k bot должна появиться кнопка "[**Дополнительный функционал**](#user-content-fn-2)[^2]". 5. Для настройки API ключей необходимо подключить 2FA. Для этого нажмите на кнопку "**Настройки**" -> 2FA -> Добавить 2FA -> Введите название для нового 2FA -> нажмите "**Все верно**" чтобы подтвердить название -> отсканируйте QR-код/введите секретный ключ в приложения аутентификатора, к примеру, Google Authenticator -> отправьте боту сообщение с шестизначным кодом -> после успешного добавления, будет отправлено сообщение "**2FA был добавлен!**" ## Настройка API 1. После успешной активации API, в 001k bot нажмите на кнопку "**Дополнительный функционал**" -> "**API доступ**" -> "**Создать новый API ключ**" -> Введите название API ключа -> нажмите "**Все верно**" чтобы подтвердить название -> нажмите на "Депозит" чтобы активировать разрешение для API -> нажмите "**Далее**". 2. Зайдите в админ панель скрипта -> страница "**Мерчант и API**" -> в разделе "**MERCHANT SYSTEM**", нажмите на значок настроек в блоке с мерчантом 001k Bot. \ На странице настроек мерчанта 001k Bot, скопируйте IP из раздела **IP SERVER**. 3. Вернитесь в Telegram 001k bot -> отправьте IP, скопированный на шаге 2 -> нажмите "**Все верно**" чтобы подтвердить IP. 4. Нажмите "**Да**" для активации API сразу после создания. 5. Проверьте настройку API ключа -> нажмите "**Все верно**" чтобы подтвердить создание API ключа -> введите 2FA. 6. Скопируйте значения "**Ключ доступа**" и "**Секрет**" в надежное место -> удалите сообщение с ключами из чата 001k bot. 7. Вернитесь в админ панель скрипта на страницу настроек мерчанта 001k bot -> в поле "**API Key**" вставьте "**Ключ доступа**", который вы скопировали на шаге 6 -> нажмите "**Save**". 8. В поле "**API Secret**" вставьте "**Секрет**", который вы скопировали на шаге 6 -> нажмите "**Save**". 9. Мерчант 001k bot настроен. Вы можете указать его в качестве модуля приема для валюты и протестировать. ## Дополнительные настройки * **Show QR** - отображение адреса для депозита в виде QR-кода. \ Для того чтобы отобразить QR-код, выберите значение "**Yes**" -> "**Save**". \ Для того чтобы отключить отображение QR-кода, выберите значение "**No**" -> "**Save**". * **Debug log** - передача дополнительных логов разработчику. По умолчанию - "**No**". \ В случае необходимости передачи дополнительных логов, выберите значение "**Yes**" -> "**Save**". [^1]: ![](/files/CrGunZnEY4BJlxOkZGGM) [^2]: ![](/files/91Gr1Mf61DG6IUlReqsU) # Выплаты 001k bot Инструкция по настройке выплаты 001k bot ## Установка модуля Используя параметры ниже, установите модуль выплаты через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin).
Параметры для Install Plugin **Plugin type**: **`Payout module`** **Plugin URL**: **`@boxexchanger-plugins/payout-001k`** **Directory path**: **`001k`** **Auth: (Deploy token)**: оставляем пустым **Package tag**: **`latest`**
## Активация API {% hint style="info" %} В случае, если у вас уже активирован API - переходите к разделу [#nastroika-api](#nastroika-api "mention") {% endhint %} 1. Откройте Telegram 001k bot по [ссылке](https://t.me/OO1kBOT?start=ieEYGJR78ex) -> нажмите "**START**" 2. Нажмите кнопку "**Инфо**" -> скопируйте UID -> нажмите "[**Поддержка**"](#user-content-fn-1)[^1]. 3. В личных сообщениях с представителем поддержки 001k Bot Support, отправьте запрос на активацию API. **Подробнее о запросе в выпадающем списке ниже.**
Необходимая информация в запросе 1. UID, который вы скопировали на шаге 2. 2. Название и ссылка на ваш обменный сервис. 3. Интересующие пары для обмена. 4. Тип операции (депозит/вывод/swap)
4. После успешной активации API, в 001k bot должна появиться кнопка "[**Дополнительный функционал**](#user-content-fn-2)[^2]". 5. Для настройки API ключей необходимо подключить 2FA. Для этого нажмите на кнопку "**Настройки**" -> 2FA -> Добавить 2FA -> Введите название для нового 2FA -> нажмите "**Все верно**" чтобы подтвердить название -> отсканируйте QR-код/введите секретный ключ в приложения аутентификатора, к примеру, Google Authenticator -> отправьте боту сообщение с шестизначным кодом -> после успешного добавления, будет отправлено сообщение "**2FA был добавлен!**". ## Настройка API 1. После успешной активации API, в 001k bot нажмите на кнопку "**Дополнительный функционал**" -> "**API доступ**" -> "**Создать новый API ключ**" -> Введите название API ключа -> нажмите "**Все верно**" чтобы подтвердить название -> нажмите на "**Баланс**" и "**Вывод**" чтобы активировать разрешение для API -> нажмите "**Далее**". 2. Зайдите в админ панель скрипта -> страница "**Мерчант и API**" -> в разделе "**PAYOUT SYSTEM**", нажмите на значок настроек в блоке с модулем выплаты 001k Bot. \ На странице настроек модуля выплаты 001k Bot, скопируйте IP из раздела **IP SERVER**. 3. Вернитесь в Telegram 001k bot -> отправьте IP, скопированный на шаге 2 -> нажмите "**Все верно**" чтобы подтвердить IP. 4. Нажмите "**Да**" для активации API сразу после создания. 5. Проверьте настройку API ключа -> нажмите "**Все верно**" чтобы подтвердить создание API ключа -> введите 2FA. 6. Скопируйте значения "**Ключ доступа**" и "**Секрет**" в надежное место -> удалите сообщение с ключами из чата 001k bot. 7. Вернитесь в админ панель скрипта на страницу настроек модуля выплаты 001k bot -> в поле "**API Key**" вставьте "**Ключ доступа**", который вы скопировали на шаге 6 -> нажмите "**Save**". 8. В поле "**API Secret**" вставьте "**Секрет**", который вы скопировали на шаге 6 -> нажмите "**Save**". 9. Для "**Receive mode**" выберите значение "**Yes**" - нажмите "**Save**". Это необходимо чтобы клиент получил сумму вывода, которая указана в заявке. В случае, если вы укажите "**No**", то клиент получит сумму с учетом комиссии вывода 001k bot. 10. Модуль выплаты 001k bot настроен. Вы можете указать его в качестве модуля выплаты для валюты и протестировать. ## Дополнительные настройки * **Receive mode** - способ вывода средств. \ В случае, если установлено значение "**No**" - комиссия за вывод валюты будет учтена в сумме отправки. **Не рекомендуется**. \ В случае, если установлено значение "Yes" - сумма отправки будет совпадать с суммой в заявке, а комиссия за отправку будет списана из вашего баланса 001k bot. **Рекомендуется**. * **Debug log** - передача дополнительных логов разработчику. По умолчанию - "**No**". \ В случае необходимости передачи дополнительных логов, выберите значение "**Yes**" -> "**Save**". [^1]: ![](/files/CrGunZnEY4BJlxOkZGGM) [^2]: ![](/files/91Gr1Mf61DG6IUlReqsU) # 2328 Навигационная страница по настройке 2328
Мерчант 2328Ознакомьтесь с инструкцией по настройке мерчанта 2328/pages/4D37eGiFuNYXZFIf1EeE
Выплаты 2328Ознакомьтесь с инструкцией по настройке модуля выплаты 2328/pages/fShmcR8MqreEETE9A7GG
Парсер 2328Ознакомьтесь с инструкцией по настройке парсера 2328/pages/GuVTBnZvSf1wD9Ao5gvx
# Мерчант 2328 Инструкция по настройке мерчанта 2328 {% stepper %} {% step %} ## Установка мерчанта Установите мерчант через **Install plugin** по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin).
Параметры для Install Plugin **Plugin type**: **`Merchant module`** **Plugin URL**: **`@boxexchanger-plugins/merchant-2328`** **Directory path**: **`2328`** **Auth: (Deploy token)**: оставляем пустым **Package tag**: **`latest`**
{% endstep %} {% step %} ## Настройка мерчанта {% hint style="info" %} Если у вас уже есть активный проект в 2328, переходите к шагу 6. {% endhint %} 1. [Зарегистрируйтесь](https://my.2328.io/register) в 2328 и [войдите](https://my.2328.io/login) в личный кабинет. 2. Откройте раздел **Бизнес** → **Проекты**. 3. Нажмите [**Новый проект**](#user-content-fn-1)[^1]. 4. Заполните поля **Название проекта**, **URL проекта** и **Telegram-контакт**. 5. Нажмите **Отправить на проверку** и дождитесь подтверждения проекта. {% hint style="info" %} Когда 2328 подтвердит проект, у него появится статус [**Активный**](#user-content-fn-2)[^2]. После этого переходите к следующему шагу. {% endhint %} 6. Откройте ваш проект и перейдите в его настройки . 7. В блоке **Детали проекта** скопируйте [**Project ID** и **Payment API Key**](#user-content-fn-3)[^3]. 8. В панели администратора BoxExchanger откройте страницу **Мерчант и API**. 9. В разделе **MERCHANT SYSTEM** откройте настройки мерчанта **2328**. 10. В поле **Project (UUID)** укажите **Project ID** и нажмите **Save**. 11. В поле **API Key** укажите **Payment API Key** и нажмите **Save**. 12. Мерчант настроен и готов к использованию в валютах/направлениях. {% endstep %} {% step %} ### Дополнительные настройки * **Show QR-code** — показывает QR-код с адресом для оплаты. Чтобы включить опцию, выберите **Yes** и нажмите **Save**. * **Debug log** — передает дополнительные логи команде BoxExchanger. Включайте **Yes** только при диагностике и затем нажимайте **Save**. {% endstep %} {% endstepper %} [^1]: ![](/files/WeTRMarnpm3gZ6xipbxV) [^2]: [^3]: # Выплаты 2328 Инструкция по настройке модуля выплаты 2328 {% stepper %} {% step %} ## Установка модуля Используя параметры ниже, установите модуль выплаты через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin).
Параметры для Install Plugin **Plugin type**: **`Payout module`** **Plugin URL**: **`@boxexchanger-plugins/payout-2328`** **Directory path**: **`2328`** **Auth: (Deploy token)**: оставляем пустым **Package tag**: **`latest`**
{% endstep %} {% step %} ## Настройка модуля {% hint style="info" %} Если у вас уже есть активный проект в 2328 и сохранены **Project ID** и **Payout API Key**, переходите к шагу 9. {% endhint %} 1. [Зарегистрируйтесь](https://my.2328.io/register) в 2328 и [войдите](https://my.2328.io/login) в личный кабинет. 2. Откройте раздел **Бизнес** → **Проекты**. 3. Нажмите [**Новый проект**](#user-content-fn-1)[^1]. 4. Заполните поля **Название проекта**, **URL проекта** и **Telegram-контакт**. 5. Нажмите **Отправить на проверку** и дождитесь подтверждения проекта. {% hint style="info" %} Когда 2328 подтвердит проект, у него появится статус **Активный**. После этого переходите к следующему шагу. {% endhint %} 6. Откройте ваш проект. 7. В блоке **Детали проекта** нажмите [**Сгенерировать**](#user-content-fn-2)[^2] для поля **Payout API Key**. 8. Сохраните в надежном месте: * [**Payout API Key**](#user-content-fn-3)[^3] * [**Project ID**](#user-content-fn-4)[^4] {% hint style="info" %} Для настройки модуля выплат используйте именно **Payout API Key**. Не путайте его с **Payment API Key** от мерчанта. {% endhint %} 9. В панели администратора BoxExchanger откройте страницу **Мерчант и API**. 10. В разделе **PAYOUT SYSTEM** откройте настройки модуля выплаты **2328**. 11. В поле **Project (UUID)** укажите **Project ID** и нажмите **Save**. 12. В поле **Payout API Key** укажите **Payout API Key** и нажмите **Save**. 13. После сохранения модуль можно использовать в настройках валют и направлений. {% endstep %} {% step %} ### Дополнительные настройки * **Debug log** - передает дополнительные логи команде BoxExchanger. Включайте **Yes** только при диагностике. После изменения нажмите **Save**. {% endstep %} {% endstepper %} [^1]: ![](/files/WeTRMarnpm3gZ6xipbxV) [^2]: [^3]: [^4]: ![](/files/eGNvR2nrRFjbUjyE6zJT) # Биржа whitebit Навигационная страница по настройке whitebit
Взаимодействие модулейУзнайте подробнее о работе связки мерчанта и модуля выплаты whitebit/pages/NtPhaO8cxKltuTys2tMn
Мерчант whitebitОзнакомьтесь с инструкцией по настройке мерчанта whitebit/pages/2PLd9eAufquFrQL52ma5
Выплаты whitebitОзнакомьтесь с инструкцией по настройке модуля выплаты whitebit/pages/ZBo0oU9AxF2clzVtuzgu
Парсер whitebit Ознакомьтесь с инструкцией по настройке парсера whitebit/pages/p3K7488xLjvpmmAqcN8i
Дополнительные модулиОзнакомьтесь с инструкцией по настройке дополнительных модулей whitebit/pages/OP0ocB7ktwy3QHjwJJWr
# Взаимодействие модулей Подробное описание взаимодействия мерчанта и модуля выплаты whitebit для автоматической работы {% hint style="info" %} Вы можете использовать связку модуля приема и модуля выплаты whitebit для полной автоматизации процесса обмена с использованием ликвидности биржи. {% endhint %} ## Настройка авто конвертации Разберем на примере направления BTC-LTC. 1. Для начала необходимо [настроить ](/obmen/valyuty)валюты BTC и LTC. \ \- Также на шаге "**Настройки оплаты**" для валюты BTC выставить прием платежей "**Автоматически**" - из списка выбрать "**WhiteBit Exchanger**". \ \- Для валюты LTC на шаге "**Настройки оплаты**" выставить выплаты "**Автоматически**" - из списка выбрать "**WhiteBit Exchanger**". 2. [Настраиваем](/obmen/napravlenie) направление BTC-LTC.\ \- На шаге "Тип Курса" выбираем курс обмена "**Автоматически**" - из списка выбираем парсер WhiteBIT (предварительно его включив на странице "**Парсеры**" - "**Больше курсов**" в блоке с парсером whitebit - передвигаем ползунок напротив "**ВКЛЮЧИТЬ**" в активное положение) - пара BTC/LTC - "Добавить" - сохраняем изменения.\ \- Также настраиваем остальные параметры для направления (комиссия и тд). Обязательно необходимо проверить корректность настройки курса и комиссий (дополнительно сверив с [комиссиями whitebit](https://whitebit.com/ru/fees)). 3. Далее необходимо настроить [Мерчант whitebit](/obmen/merchant-i-api/birzha-whitebit/merchant-whitebit) и модуль [Выплаты whitebit](/obmen/merchant-i-api/birzha-whitebit/vyplaty-whitebit). {% hint style="warning" %} Обратите внимание, что **валюта в которую будет производиться авто конвертация (***"**Convert to" в настройках мерчанта*****) и валюта из которой будет происходить выплата (*****"Withdraw from" в настройка модуля выплат*****) должны совпадать для автоматизации процесса.** {% endhint %} 4. На странице настроек **мерчанта** whitebit указываем для "**Convert to**" параметр "**USDT**" - нажимаем "**Save**".\ На странице настроек **модуля выплат** whitebit указываем для "**Withdraw from**" параметр "**USDT**" - нажимаем "**Save**". ## Принцип работы К примеру, клиент хочет обменять **0.1 BTC на 40 LTC** по курсу 1:400 (с учетом нашей комиссии) 1. Валюту BTC мы будем принимать через whitebit (то есть whitebit сгенерирует уникальный адрес для депозита под конкретную заявку. Наш скрипт отобразит этот адрес клиенту на шаге оплаты заявки). 2. После того как сумма в BTC (указанная в заявке или больше, то есть **≥0.1 BTC**) поступит на указанный адрес одним платежом - BTC будет конвертирован в USDT (будет выставлен маркет ордер на продажу в паре BTC/USDT). Это произойдет из-за того что мы выставили для "**Convert to**" параметр "**USDT**". 3. Мерчант whitebit поменяет статус заявки на "На выплату" и в комментарии к данному действию обозначит, что депозит BTC успешно получен. 4. Далее необходимо выплатить LTC клиенту. В зависимости от настроек "[Авто обмена](#user-content-fn-1)[^1]" (в настройках направления) может произойти следующее: \ а) Если "Авто обмен" выключен, то для запуска модуля выплаты (чтобы начать выплату LTC на указанный клиентов адрес), оператору необходимо будет нажать кнопку "[ALLOW AUTO PAYOUT](#user-content-fn-2)[^2]" в админ панеле в деталях заявки. \ б) Если "Авто обмен" включен, то выплата начнется автоматически. 5. Как только модуль выплаты запущен - начинается процесс выплаты. На бирже в паре LTC/USDT выставляется маркет ордер на покупку 40+ LTC ("+" обозначает, что также будет учитываться комиссия за вывод LTC). Это происходит из-за того что мы на странице настроек **модуля выплат** whitebit для "**Withdraw from**" выставили параметр "**USDT**". То есть обозначили, что необходимо получать нужную валюту для вывода из пары с USDT (покупать нужную валюту за USDT). 6. Выставляется запрос на вывод 40 LTC на адрес, указанный клиентом в заявке. 7. После успешной выплаты, модуль выплаты меняет статус заявки на "Завершена". Ваша прибыль остается в валюте, которую получал клиент, в данном примере это LTC, на вашем балансе. {% hint style="info" %} Обратите внимание, что в парах Currency/USDT будет использоваться buy stock market order, то есть будет выставляться ордер на покупку точной суммы Currency, которую необходимо вывести клиенту + комиссия за вывод Currency. То есть в таких парах мы считаем, что Currency - это stock, а USDT - money. Например, BTC (stock) / USDT (money). Однако, в парах USDT/Currency будет использоваться обычный sell market order. Это обозначает, что будет выставляться одрер на продажу USDT + 0.3% проскальзывание по стакану (так как мы не можем знать точную среднюю стоимость закупки) + комиссия за вывод Currency. Например, USDT (stock) / EUR (money). {% endhint %} ## Особенности поведения модуля ### Депозит зачислен после окончания времени действия заявки 1. Время заявки вышло - у заявки выставляется статус "Удалена" и заявка попадает во вкладку "Закрытые" 2. whitebit по API передает, что оплата поступила и выставляется статус заявки "Удержана[^3]", а заявка попадает во вкладку "Замороженные". 3. Оператор проверяет, что средства поступили. И дальше решает, что дальше делать с заявкой. Либо произвести возврат либо пересчитать курс и по согласованию с клиентом выплатить другую сумму либо другой вариант. 4. В зависимости от вашего выбора, вы меняете статус заявки и продолжаете работу. Если вы знаете, что зачисление валюты может занять длительное время, например для направлений, где клиент отдает BTC, то рекомендуется увеличивать время действия заявки. ### Депозит токена в другой сети Может быть ситуация, что средства получены на адрес для депозита, однако сеть отличается от той, которая обозначена в заявке. В таком случае у заявки будет выставлен статус "Удержана[^4]" с комментарием "BE CAREFUL! Check deposit network for this order! (ARBITRUM != ERC20)", к примеру. ### Депозит меньшей суммы В случае, если на сгенерированный адрес для депозита поступит сумма меньше чем указана в заявке, то мерчант whitebit выставит для заявки статус "[Ошибка оплаты](#user-content-fn-5)[^5]" с комментарием "**INCORRECT AMOUNT**" [^1]: ![](/files/Uf2KujaEoEowWK2d2i0A) [^2]: ![](/files/3OWmN0jcgnZIVXrNhwgN) [^3]: ![](/files/H58JZB7qYQFIzJEywKF6) [^4]: ![](/files/7ZcqeSvWlRCDtZkuMvid) [^5]: ![](/files/jFW8ITi1YVLJg9aLtoCe) # Мерчант whitebit ## Поддерживаемые валюты * Банковские карты: EUR, USD, KTZ, UAH (*временно недоступно*) * Криптовалюты: BTC, ETH, LTC, USDT... ## Установка мерчанта Используя параметры ниже, установите мерчант через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin).
Параметры для Install Plugin **Plugin type**: **`Merchant module`** **Plugin URL**: **`@boxexchanger-plugins/merchant-whitebit`** **Directory path**: **`whitebit`** **Auth: (Deploy token)**: оставляем пустым **Package tag**: **`latest`**
## Регистрация и подготовка аккаунта whitebit {% hint style="success" %} * [Зарегистрируйтесь](https://whitebit.com/referral/27d3a06d-9f07-4753-a1e0-257c9817b26e) на бирже whitebit - пройдите верификацию личности - включите 2FA. * Обратитесь в поддержку whitebit. В сообщении укажите:\ \- Username вашего аккаунта\ \- Запрос на **активацию генерации адресов для депозита** для работы онлайн обменного сервиса (*ссылка на ваш обменный сервис*) на движке BoxExchanger. {% endhint %} ### Создание API ключа на прием на whitebit {% hint style="warning" %} Убедитесь, что у вас включена 2FA для аккаунта whitebit. В противном случае вы не сможете создать API ключ. {% endhint %} 1. Перейдите в **настройки аккаунта** - раздел "**API**" - **ключи API** - нажмите "**Редактировать**" в блоке "**Ключи API"** (либо [**нажмите тут**](https://whitebit.com/ru/settings/api/api-keys) для быстрого перехода к данной странице) **-** далее **"**[**Сгенерировать ключ API**](#user-content-fn-1)[^1]**" -** введите 2FA. 2. [**Скопируйте** ](#user-content-fn-2)[^2]**в надежное место** **Ключ (публичный)** и **Секретный ключ** (данные понадобятся для [настройки модуля](#osnovnye-nastroiki) в админ панели). 3. Введите имя ключа - активируйте эндпоинты (см. список ниже) - нажмите "[**Подтвердить**](#user-content-fn-3)[^3]" - введите 2FA.
Эндпоинты для мерчанта Раздел "**Пополнить**"\ `/api/v4/main-account/fiat-deposit-url`\ `/api/v4/main-account/create-new-address` Раздел "**Перевод между балансами**"\ `/api/v4/main-account/transfer` Раздел "**Баланс и история кошелька**"\ `/api/v4/main-account/balance`\ `/api/v4/main-account/history` Раздел "**Торговый баланс и история ордеров**"\ `/api/v4/trade-account/balance` Раздел "**Управление ордерами**"\ `/api/v4/order/new`\ `/api/v4/order/market`
4. На странице "[**Ключи API**](https://whitebit.com/ru/settings/api/api-keys)" нажмите "[**IP-доступ**](#user-content-fn-4)[^4]" - далее переведите ползунок в активное положение - введите IP-адрес v4 (также IPv6, если есть. IPv6 может быть не доступен тогда его можно пропустить и вставить только IPv4) back-end сервера - нажмите "[**Добавить**](#user-content-fn-5)[^5]" - введите 2FA. {% hint style="info" %} IP-адрес формате v4 и v6 можно узнать 1. В **админ панеле** на странице настроек мерчанта whitebit. Для этого перейдите на страницу "**Мерчант и API**" - раздел "**MERCHANT SYSTEM**" - настройки ([**значок настроек**](#user-content-fn-6)[^6]) в блоке с мерчантом "**WhiteBit Exchanger**" - внизу страницы "[**PUBLIC IP**](#user-content-fn-7)[^7]" и "**PUBLIC IPV6**". 2. В ЛК [лицензий](https://licence.boxexchanger.net/ru/licenses/) - поле "**Back-end server**". {% endhint %} {% hint style="danger" %} Обратите внимание, что ваш ключ API будет автоматически деактивирован со стороны whitebit в случае отсутствия активности API в течение 14 дней. Его можно будет активировать повторно на странице "**Ключи API**". {% endhint %} ## Конфигурация мерчанта в админ панели ### Основные настройки 1. В админ панели перейдите на страницу настроек мерчанта whitebit. Для этого перейдите на страницу "**Мерчант и API**" - раздел "**MERCHANT SYSTEM**" - настройки ([**значок настроек**](#user-content-fn-6)[^6]) в блоке с мерчантом "**WhiteBit Exchanger**". 2. В поле "**API Secret**" вставьте ранее скопированный **Секретный ключ** - нажмите "[**Save**](#user-content-fn-8)[^8]". *(после перезагрузки страницы **API Secret** будет скрыт и перестанет отображаться в админ панели в целях безопасности).* 3. В поле "**API Key**" вставьте ранее скопированный **Ключ (публичный) -** нажмите "[**Save**](#user-content-fn-9)[^9]". 4. Вы можете включить **отображение QR-кода** с адресом для депозита. \ Для этого в поле "**Payment with QR-code?**" выставьте значение "Yes**"** - нажмите "[**Save**](#user-content-fn-10)[^10]". 5. Вы можете включить авто конвертацию валюты, которая поступила на ваш баланс whitebit от клиента по заявке. Для этого вам необходимо в разделе "**AUTO SELL (AFTER ACCEPT PAYMENT)**" для "**Convert to**" выбрать валюту (USDT/USDC/EUR) в которую будет происходить автоматическая конвертация средств по заявке - нажать "[**Save**](#user-content-fn-11)[^11]". {% hint style="info" %} В случае, если вы хотите использовать связку мерчанта и модуля выплаты whitebit для автоматизации процесса обмена и использования ликвидности биржи, вам необходимо будет включить авто конвертацию в настройках мерчанта whitebit. Обычно включается авто конвертация в USDT. {% endhint %} {% hint style="warning" %} Также обратите внимание, что **валюта в которую будет производиться авто конвертация (***"**Convert to" в настройках мерчанта*****) и валюта из которой будет происходить выплата (*****"Withdraw from" в настройка модуля выплат*****) должны совпадать для автоматизации процесса.** {% endhint %} ### Webhook {% hint style="info" %} Настройка Webhook важна для: * Моментального перевода статуса заявки "На выплату" сразу после получения депозита на whitebit * [**Отображения**](#user-content-fn-12)[^12] на странице заявки количества подтверждений сети для зачисления депозита {% endhint %} #### Настройка webhook 1. Справа сверху наведите на иконку профиля -> нажмите на "[**API**](#user-content-fn-13)[^13]". 2. На странице "**API**" в блоке "**Webhook**" нажмите "[**Редактировать**](#user-content-fn-14)[^14]". 3. На открывшейся странице нажмите "[**Продолжить**](#user-content-fn-15)[^15]" -> ваc перенаправит на страницу "[**Соединение**](#user-content-fn-16)[^16]". 4. Перейдите в админ панель BoxExchanger -> страница "**Мерчант и API**" -> настройки мерчанта whitebit -> на странице настроек в разделе "**WEBHOOK SETTINGS**" [**скопируйте URL**](#user-content-fn-17)[^17]. 5. Вернитесь на страницу "**Соединение**" в ЛК whitebit -> в поле "**Адрес webhook**" вставьте URL из шага 4 -> нажмите "[**Сгенерировать ключ**](#user-content-fn-18)[^18]" -> введите 2FA. 6. [**Скопируйте**](#user-content-fn-19)[^19] в надежное место "**Секретный ключ**" и "**Ключ**" (публичный ключ) -> нажмите "**Подтвердить**". 7. Добавьте публичный ключ в TXT запись домена, указанного при создании ключа. Разберем на примере добавления записи в Cloudflare. \ а) Зайдите в ЛК Cloudflare -> на странице "**Websites**" [**зайдите**](#user-content-fn-20)[^20] на страницу настроек домена, который вы указывали при создании ключа.\ б) Перейдите на страницу "**DNS**" -> "**Records**" -> нажмите "[**Add record**](#user-content-fn-21)[^21]" -> "**Type**" выберите "**TXT**" -> "**Name**" введите "**www**", если у вас домен формата [www.exchanger.com](http://www.exchanger.com) либо "**@**" если в формате exchanger.com либо **субдомен**, если в формате subdomain.exchanger.com -> в поле "**Content**" вставьте публичный ключ webhook из шага 6 -> нажмите "**Save**". 8. Вернитесь на страницу "Webhook" в ЛК whitebit -> [**включите**](#user-content-fn-22)[^22] webhook, переведя ползунок в активное состояние -> доступ "**Коды**" можно отключить. 9. После того как webhook будет активирован, перейдите обратно в настройки домена Cloudflare из шага 7 б) -> [**удалите**](#user-content-fn-23)[^23] добавленную TXT запись (нажмите "Edit" в поле с TXT записью -> Delete -> подтвердите удаление). 10. Перейдите в админ панель BoxExchanger -> страница "**Мерчант и API**" -> настройки мерчанта whitebit -> на странице настроек в разделе "**WEBHOOK SETTINGS**" -> в поле "**Webhook key**" [**вставьте**](#user-content-fn-24)[^24] публичный ключ из шага 6 -> нажмите "**Save**" -> в поле "**Webhook Secret**" вставьте секретный ключ из шага 6 -> нажмите "**Save**". 11. Добавьте IP, с которого whitebit отправляет webhook, в белый список CloudFlare. Инструкция:[IP в белый список CloudFlare](/dlya-razrabotchikov/nastroika-firewall/ip-v-belyi-spisok-cloudflare).\ ***IP вы можете уточнить у поддержки BoxExchanger.*** 12. Протестируйте работу мерчанта whitebit. ### Дополнительные настройки * [**Enable debug mode**](#user-content-fn-25)[^25] - значение "1" включает отправку дополнительных логов для разработчиков. Может быть полезно для анализа логов при возникновении трудностей с модулем. Без крайней необходимости рекомендуем не включать и оставить значение "0". * [**Enable Wallet deposit cron**](#user-content-fn-26)[^26] - значение "1" активирует возможность [генерации статического адреса](https://manual.boxexchanger.net/obmen/merchant-i-api/birzha-whitebit/pages/2YbSCuZ4WF6yYtnFsRP8#3.-staticheskii-adres-dlya-depozita) для депозита в ЛК пользователя. По умолчанию выставлено "0". * [**Add hours to expires time**](#user-content-fn-27)[^27] **(when find tx with 0 confirms)** - настройка увеличения времени заявки после того как система определит транзакцию (будет 0 подтверждений у транзакции). \ 0.25 = 15min. К пример, если вы укажите 0.5, то время заявки будет увеличено на 30 минут после определения транзакции. * [**BTC/LTC type address**](#user-content-fn-28)[^28] - выбор формата адреса (p2sh-segwit/bech32) для депозита для валют BTC и LTC. * [**Provider fiat USD/EUR/UAH/KZT** ](#user-content-fn-29)[^29]- выбор провайдера через который будет осуществляться прием фиатной валюты. На данный момент whitebit по API поддерживает только VISAMASTER. ### Проксирование запросов {% hint style="info" %} Для конфигурации SOCKS5-прокси на вашем сервере, вы можете воспользоваться инструкцией: [Установка SOCKS5-прокси](/dlya-razrabotchikov/ustanovka-socks5-proksi). {% endhint %} {% hint style="info" %} Перед настройкой проксирования запросов в админ панели скрипта BoxExchanger, зайдите в ЛК whitebit и добавьте IP-адрес сервера, на котором сконфигурированы прокси, в белый список API ключа для приема. \ В противном случае, whitebit деактивирует ваш API ключ после первого запроса с IP-адреса, которого нет в белом списке ключа. {% endhint %} Для отправки запросов через SOCKS5 proxy, на странице настроек мерчанта whitebit в поле "**Socks Proxy URI**" укажите ссылку на SOCKS5 proxy в формате `socks5://username:password@host:port`-> нажмите "[**Save**](#user-content-fn-30)[^30]". ## Прием фиатных валют {% hint style="success" %} Для работы с фиатными валютами - обратитесь в поддержку whitebit с запросом активации фиатного шлюза для необходимой валюты. {% endhint %} {% hint style="warning" %} **Внимание!** Для приема **EUR,USD** в настройке данных направлений - шаг "**Отображение полей**" - обязательно включите созданное по-умолчанию поле "E-mail". \ Со стороны whitebit требование запрашивать от клиента ввод Email адреса. {% endhint %} ### Верификация * Требования по верификации вы всегда можете уточнить у представителей whitebit {% hint style="info" %} Для **локализации текста** используйте символ решётки и код языка перед текстом и "##" после текста. \ *Например: ##ua## Текстова інформація ##* Текст, который находится между открывающими и закрывающими тегами будет отображаться только на украинской версии сайта. К примеру если клиент зайдет на сайт на украинском языке то он будет видеть только "*Текстова інформація*" {% endhint %} #### Верификация пользователя {% hint style="info" %} Ручная верификация пользователя настраивается в направлении: [Направление](/obmen/napravlenie#ruchnaya-verifikaciya)\ Инструкцию по созданию и настройке направления вы можете найти тут: [Направление](/obmen/napravlenie) {% endhint %} * [Перейдите в админ панель - вкладка "*Направления*" - "*Настройки направлений*" - нажмите "*Изменить*" в строке с нужным направлением](#user-content-fn-31)[^31]. * [В настройках направления перейдите к шагу "*Верификация*" - нажмите "*Включить*" напротив "*ВЕРИФИКАЦИЯ: (IDENT DOCUMENTS PASSPORT ETC)*"](#user-content-fn-32)[^32]. * [В поле "*Count verification photos*" введите кол-во требуемых от пользователя изображений для верификации - в поле редактора текста введите текст с инструкцией для верификации пользователя](#user-content-fn-33)[^33] и обязательно сохраните все изменения. (см. примеры ниже)
Примеры текста для верификации личности на разных языках \##ru##\ Для прохождения верификации личности предоставьте: \ 1\. **Фотографию одного из документов удостоверяющих личность**\ \- Паспорт (первая страница)\ \- ID-карта (передняя сторона)\ \- Документ удостоверяющий личность (передняя сторона)\ 2\. **Фотографию (селфи) с документом, удостоверяющим вашу личность.**\ В кадре должно быть видно ваше лицо и документ в соответствующем формате.\ \##\ \ \##ua##\ Для проходження верифікації особи надайте:\ 1\. **Фотографію одного з документів, що засвідчують особу**\ \- Паспорт (перша сторінка)\ \- ID-карта (лицьова сторона)\ \- Документ, що засвідчує особу (лицьова сторона)\ 2\. **Фотографію (селфі) з документом, що засвідчує вашу особу**. \ У кадрі має бути видно ваше обличчя та документ у відповідному форматі.\ \##\ \ \##en##\ To pass identity verification, please, provide:\ 1\. **Photo of one of the identity documents**\ \- Passport (first page)\ \- ID card (front side)\ \- driver's license (front side) \ 2\. **Photo (selfie) of a person with an identity document.** \ The frame must show the face of the person and the document in the appropriate format.\ \##
* [После проделанных действий, на клиентской части на этапе оплаты заявки появится кнопка "*Пройти верификацию*" напротив поля "*Проверка личности*". При нажатии на эту кнопку открывается модальное окно с инструкцией и возможностью загрузить изображения для верификации. ](#user-content-fn-34)[^34] #### Верификация валюты {% hint style="info" %} Ручная верификация валюты включается в настройках валюты и **позволяет запросить у клиента только одно изображение**. \ Инструкцию по созданию и настройке валюты вы можете найти тут: [Валюты](/obmen/valyuty) * **Данный тип верификации можно использовать для верификации банковской карты клиента.** * **Верификация "Валюты А" будет запрашиваться во всех направлениях, в которых клиент отдает обменному сервису "Валюту А".** * Для верификации "Валюты Б", которую обменный сервис отправит клиенту, следуйте инструкции тут: [/pages/FUWozEBxRcckndTfFpHJ#2.-verifikaciya-rekvizitov-vyplata](https://manual.boxexchanger.net/obmen/merchant-i-api/birzha-whitebit/pages/FUWozEBxRcckndTfFpHJ#2.-verifikaciya-rekvizitov-vyplata "mention") {% endhint %} * [Перейдите в админ панель - вкладка "*Валюты*" - "*Настройка валют*" - нажмите "*Изменить*" в поле нужной валюты](#user-content-fn-35)[^35]. * [В настройках валюты перейдите к шагу "*Другие настройки*" - нажмите "*Включить*" напротив поля "*ВЕРИФИКАЦИЯ*"](#user-content-fn-36)[^36]. * [В поле редактора текста введите текст с инструкцией для прохождения верификации](#user-content-fn-37)[^37] (см. пример ниже) и обязательно сохраните изменения
Пример текста для верификации банковской карты \##ru## \ Для того, чтобы верифицировать виртуальную карту Вам необходимо сделать следующие шаги: 1. **Необходимо сделать скриншот из Вашего личного кабинета (в банкинге), на котором должно быть видно**:\ \- 4 последние цифры номера карты\ \- срок действия карты 2. **Сделать фото на котором будет написано ФИО, дата и подпись владельца карты, а также видна виртуальная карта с банкинга.** 3. Загрузить фото в поле верификации валюты. \ Для того чтобы верифицировать физическую карту: 1. Возьмите белый лист бумаги. 2. Расположите на листе банковскую карту так, чтобы было видно номер карты и дату. 3. Карта и ее тень должны быть видны полностью. 4. Напишите от руки название сервиса "yourExchangerName". 5. Поставьте дату и подпись. 6. Сфотографируйте и загрузите изображение. 7. Готово!\ \##
* После проделанных действий, на клиентской части на этапе оплаты заявки появится [кнопка "*Пройти верификацию*" напротив поля с названием валюты](#user-content-fn-38)[^38]. [При нажатии на эту кнопку открывается модальное окно с инструкцией и возможностью загрузить изображение для верификации.](#user-content-fn-39)[^39] [^1]: ![](/files/p9H6ZGUudqC5n4N1JYBf) [^2]: ![](/files/OXIJV5KXCrbGMLwv4GsF) [^3]: ![](/files/kZXhXNqKEBFfPSux3ywD) [^4]: ![](/files/XOfAYvPLZYaVpYnL4FRX) [^5]: ![](/files/40ljqLOI3jB1H6RPXYhU) [^6]: ![](/files/K4yo5EHisArAmqalL1t1) [^7]: ![](/files/RGWFuTAuhzHDsCQmZsgc) [^8]: ![](/files/Pg0SXqIYa0zuZFHre05D) [^9]: ![](/files/dvoEojUdMLmH13NP2law) [^10]: ![](/files/5qSRoLJGfI2CPb7TGxOr) [^11]: ![](/files/hIEZK6H7a8EYE3N7wQ9t) [^12]: ![](/files/wDFXYl8OCmuiGgcwPBat) [^13]: ![](/files/bUkNZHn0JbL2Y8jTENXT) [^14]: ![](/files/RAtc9AjxSgNKvu6zNng4) [^15]: ![](/files/1yDPysypFpjuv7MujF54) [^16]: ![](/files/Q6qTMMIkpcCDPD6FysCN) [^17]: ![](/files/yV6bo4JfvRVv7JJxf1Eb) [^18]: ![](/files/yThGvZ4gjOOY2yqxA2tl) [^19]: ![](/files/iH7yNGERMetOFx9Pe4ZO) [^20]: ![](/files/8uQ9sF22NyZMBznTgwoa) [^21]: ![](/files/CsZuMJUasv6NxdF2u04o) [^22]: ![](/files/JNyXEiKwAv444lcS1yUN) [^23]: ![](/files/DHO8gSAA8TsTfWmrjAuw) [^24]: ![](/files/JDxyq54LFoKkeQlzjlFM) [^25]: ![](/files/FArNDfCwxqBHRPYm0Z08) [^26]: ![](/files/9AhoXxbsACtcFe6lMy0g) [^27]: ![](/files/fDO87M2yeT7dJxj6ne1L) [^28]: ![](/files/9pU8qOKd5nS7zwERXSQd) [^29]: ![](/files/HQLVQYqkrj5eS3xPKLeO) [^30]: ![](/files/Cj5jDuMQ8LMkyjHyhMeq) [^31]: ![](/files/BDNiuuGw9jCttszoxflb) [^32]: ![](/files/Ymh9vMUkvD7JUIdJQH1L) [^33]: ![](/files/wJbKstfQmvJU3eYXnMY5) [^34]: ![](/files/hvYrsEnCeSYRVBnikSPr) [^35]: ![](/files/5KNgT1Xk0nJQ9BrSh5pr) [^36]: ![](/files/hfQuLCWpkKxkLAZz6iGh) [^37]: ![](/files/6tGaDeEhqjRBCD5ICxn5) [^38]: ![](/files/ylaladzijIv1nP04gQ3l) [^39]: ![](/files/GTmysITMCPD9BLWWBIJ5) # Выплаты whitebit ## Поддерживаемые валюты * Банковские карты: EUR, USD, KTZ, UAH (*временно недоступно*) * Криптовалюты: BTC, ETH, LTC, USDT... ## Установка модуля Используя параметры ниже, установите модуль выплаты через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin).
Параметры для Install Plugin **Plugin type**: **`Payout module`** **Plugin URL**: **`@boxexchanger-plugins/payout-whitebit`** **Directory path**: **`whitebit`** **Auth: (Deploy token)**: оставляем пустым **Package tag**: **`latest`**
## Регистрация и подготовка аккаунта whitebit {% hint style="success" %} В случае, если вы еще не зарегистрированы на whitebit - [Зарегистрируйтесь](https://whitebit.com/referral/27d3a06d-9f07-4753-a1e0-257c9817b26e) на бирже - пройдите верификацию личности - включите 2FA. {% endhint %} ### Создание API ключа на выплату на whitebit {% hint style="warning" %} Убедитесь, что у вас включена 2FA для аккаунта whitebit. В противном случае вы не сможете создать API ключ. {% endhint %} 1. Перейдите в **настройки аккаунта** - раздел "**API**" - **ключи API** - нажмите "**Редактировать**" в блоке "**Ключи API"** (либо [**нажмите тут**](https://whitebit.com/ru/settings/api/api-keys) для быстрого перехода к данной странице) **-** далее **"**[**Сгенерировать ключ API**](#user-content-fn-1)[^1]**" -** введите 2FA. 2. [**Скопируйте** ](#user-content-fn-2)[^2]**в надежное место** **Ключ (публичный)** и **Секретный ключ** (данные понадобятся для [настройки модуля](#osnovnye-nastroiki) в админ панели). 3. Введите имя ключа - активируйте эндпоинты (см. список ниже) - нажмите "[**Подтвердить**](#user-content-fn-3)[^3]" - введите 2FA.
Эндпоинты для модуля выплаты Раздел "**Вывод**"\ `/api/v4/main-account/withdraw`\ `/api/v4/main-account/withdraw-pay` Раздел "**Перевод между балансами**"\ `/api/v4/main-account/transfer` Раздел "**Баланс и история кошелька**"\ `/api/v4/main-account/balance`\ `/api/v4/main-account/history`\ `/api/v4/main-account/fee` Раздел "**Торговый баланс и история ордеров**"\ `/api/v4/trade-account/balance` Раздел "**Управление ордерами**"\ `/api/v4/order/market`\ `/api/v4/order/stock_market`
4. На странице "[**Ключи API**](https://whitebit.com/ru/settings/api/api-keys)" нажмите "[**IP-доступ**](#user-content-fn-4)[^4]" - далее переведите ползунок в активное положение - введите IP-адрес v4 (также IPv6, если есть. IPv6 может быть не доступен тогда его можно пропустить и вставить только IPv4) back-end сервера - нажмите "[**Добавить**](#user-content-fn-5)[^5]" - введите 2FA. {% hint style="info" %} IP-адрес формате v4 и v6 можно узнать 1. В **админ панеле** на странице настроек модуля выплаты whitebit. Для этого перейдите на страницу "**Мерчант и API**" - раздел "**PAYOUT SYSTEM**" - настройки ([**значок настроек**](#user-content-fn-6)[^6]) в блоке с мерчантом "**WhiteBit Exchanger**" - внизу страницы "[**PUBLIC IP**](#user-content-fn-7)[^7]" и "**PUBLIC IPV6**". 2. В ЛК [лицензий](https://licence.boxexchanger.net/ru/licenses/) - поле "**Back-end server**". {% endhint %} {% hint style="danger" %} Обратите внимание, что ваш ключ API будет автоматически деактивирован со стороны whitebit в случае отсутствия активности API в течение 14 дней. Его можно будет активировать повторно на странице "**Ключи API**". {% endhint %} ## Конфигурация модуля выплаты в админ панели ### Основные настройки 1. В админ панели перейдите на страницу настроек модуля выплаты whitebit. Для этого перейдите на страницу "**Мерчант и API**" - раздел "**PAYOUT SYSTEM**" - настройки ([**значок настроек**](#user-content-fn-6)[^6]) в блоке с мерчантом "**WhiteBit Exchanger**". 2. В поле "**API Secret**" вставьте ранее скопированный **Секретный ключ** - нажмите "[**Save**](#user-content-fn-8)[^8]". *(после перезагрузки страницы **API Secret** будет скрыт и перестанет отображаться в админ панели в целях безопасности).* 3. В поле "**API Key**" вставьте ранее скопированный **Ключ (публичный) -** нажмите "[**Save**](#user-content-fn-9)[^9]". 4. [**Withdraw method**](#user-content-fn-10)[^10] - выбор особенностей вывода средств. \ \- **/api/v4/main-account/withdraw** - комиссия за вывод будет вычтена из конечной суммы, которую получит клиент (**не рекомендуется**)\ \- **/api/v4/main-account/withdraw-pay** - комиссия за вывод будет вычтена из вашего баланса, а клиент получит сумму, которая обозначена в заявке (**рекомендуемый параметр**) 5. Вы можете настроить функционал "[**Withdraw from**](#user-content-fn-11)[^11]". В зависимости от выбранного параметра будет зависеть процесс получения валюты для вывода клиенту по заявке. {% hint style="info" %} **DIRECT** - прямой вывод валюты без обмена. К примеру, если необходимо вывести BTC, то у вас на балансе whitebit должен быть резерв BTC. Для LTC - резерв LTC на балансе и т.д. **USDT/USDC/EUR/BTC/ETH** - использование указанной валюты для получения валюты, которую должен получить клиент по заявке. К примему, клиент должен получить DOGE, для поля "**Withdraw from**" выбрано "**USDT**" - в таком случае у вас на балансе должен быть резерв USDT, за который в паре DOGE/USDT будет куплен нужный объем DOGE. \ Обычно выбирается "**USDT**". {% endhint %} {% hint style="warning" %} Также обратите внимание, что **валюта в которую будет производиться авто конвертация (***"**Convert to" в настройках мерчанта*****) и валюта из которой будет происходить выплата (*****"Withdraw from" в настройка модуля выплат*****) должны совпадать для автоматизации процесса.** {% endhint %} {% hint style="info" %} Обратите внимание, что в парах Currency/USDT будет использоваться buy stock market order, то есть будет выставляться ордер на покупку точной суммы Currency, которую необходимо вывести клиенту + комиссия за вывод Currency. То есть в таких парах мы считаем, что Currency - это stock, а USDT - money. Например, BTC (stock) / USDT (money). Однако, в парах USDT/Currency будет использоваться обычный sell market order. Это обозначает, что будет выставляться одрер на продажу USDT + 0.3% проскальзывание по стакану (так как мы не можем знать точную среднюю стоимость закупки) + комиссия за вывод Currency. Например, USDT (stock) / EUR (money). {% endhint %} ### Дополнительные настройки * [**Fee method**](#user-content-fn-12)[^12] - в случае, если у вас персональные комиссии на whitebit, то указывайте параметр "**Private**". По умолчанию выставлено "Public", то есть стандартные комиссии. * Настройка вывода запроса полей имени и фамилии для фиат валют (**Type request name surname (for FIAT)**)\ \- [**Compact**](#user-content-fn-13)[^13] - компактный режим запроса имени и фамилии. В данном случае, у клиента мы запросим в [одном поле](#user-content-fn-14)[^14] сразу и имя и фамилию. Данный параметр делает форму обмена более компактной и удобной для клиента. Однако, такой режим может затруднить обмен для людей которые имеют двойное имя или фамилию. \ \- [**Full** ](#user-content-fn-15)[^15]- отображение [раздельных полей](#user-content-fn-16)[^16] для ввода имени и фамилии. Если вы планируете работать с клиентами у которых может быть двойное имя и/или вам нужно чтобы клиент вводил 2 отдельных поля "Имя", "Фамилия" - вам подойдет данный вариант. * [**Type request Memo**](#user-content-fn-17)[^17] - способ передачи memo, а также выбор того обязательно ли поле memo для заполнения. \ \- По умолчанию выставлен рекомендуемый параметр, а именно "**required from user**". То есть поле memo обязательное для заполнения. \ \- **optional empty** - в таком случае поле memo необязательное для заполнения. При выводе с whitebit, memo не будет передаваться.\ \- **optional with default "12345"** - в таком случае поле поле memo необязательное для заполнения. При выводе с whitebit, будет передаться memo "12345". * [**Enable debug mode**](#user-content-fn-18)[^18] - значение "1" включает отправку дополнительных логов для разработчиков. Может быть полезно для анализа логов при возникновении трудностей с модулем. Без крайней необходимости рекомендуем не включать и оставить значение "0". ### Проксирование запросов {% hint style="info" %} Для конфигурации SOCKS5-прокси на вашем сервере, вы можете воспользоваться инструкцией: [Установка SOCKS5-прокси](/dlya-razrabotchikov/ustanovka-socks5-proksi). {% endhint %} {% hint style="info" %} Перед настройкой проксирования запросов в админ панели скрипта BoxExchanger, зайдите в ЛК whitebit и добавьте IP-адрес сервера, на котором сконфигурированы прокси, в белый список API ключа для выплаты. \ В противном случае, whitebit деактивирует ваш API ключ после первого запроса с IP-адреса, которого нет в белом списке ключа. {% endhint %} Для отправки запросов через SOCKS5 proxy, на странице настроек модуля выплаты whitebit в поле "**Socks Proxy URI**" укажите ссылку на SOCKS5 proxy в формате `socks5://username:password@host:port`-> нажмите "[**Save**](#user-content-fn-19)[^19]". ## Выплата фиатных валют {% hint style="success" %} Для работы с фиатными валютами - обратитесь в поддержку whitebit с запросом активации фиатного шлюза для необходимой валюты. {% endhint %} {% hint style="warning" %} **Внимание!** Для выплаты **EUR,USD** в настройке данных направлений - шаг "**Отображение полей**" - обязательно включите созданное по-умолчанию поле "E-mail". \ Со стороны whitebit требование запрашивать от клиента ввод Email адреса. {% endhint %} ### Верификация * Требования по верификации вы всегда можете уточнить у представителей whitebit ### Верификация валюты (выплаты) {% hint style="info" %} Для верификации "Валюты Б", которую обменный сервис отправит клиенту, следуйте инструкции тут: [/pages/FUWozEBxRcckndTfFpHJ#2.-verifikaciya-rekvizitov-vyplata](https://manual.boxexchanger.net/obmen/merchant-i-api/birzha-whitebit/pages/FUWozEBxRcckndTfFpHJ#2.-verifikaciya-rekvizitov-vyplata "mention") {% endhint %} [^1]: ![](/files/p9H6ZGUudqC5n4N1JYBf) [^2]: ![](/files/dfRdsLUpB7KoTD6H66iu) [^3]: ![](/files/DGsB5CPkHIzavJFp9gRn) [^4]: ![](/files/XOfAYvPLZYaVpYnL4FRX) [^5]: ![](/files/40ljqLOI3jB1H6RPXYhU) [^6]: ![](/files/C2LQN9uOliKSdmZLiVTB) [^7]: ![](/files/vCtYJuaJmOcEMnqoeDjT) [^8]: ![](/files/pDP5EximKRCrghWseOua) [^9]: ![](/files/1qq5vtK75qGW6zysbS07) [^10]: ![](/files/fnVR3nnDlK789rVvSnpf) [^11]: ![](/files/JEEvfX1udgMj7syulUIb) [^12]: ![](/files/25uofJCVBaPPdouwAvC9) [^13]: ![](/files/vJWRCRo7VUKo3JjxSXJc) [^14]: ![](/files/Eb2zQYyMZssSvkWcEYnw) [^15]: ![](/files/o7pn2bZmSwF869qpI6Mx) [^16]: ![](/files/7esZJu6vjow4OZsU1GDi) [^17]: ![](/files/dKDzHaORO4GIzKt3rcX4) [^18]: ![](/files/FArNDfCwxqBHRPYm0Z08) [^19]: ![](/files/Cj5jDuMQ8LMkyjHyhMeq) # BetPay Навигационная страница по настройке BetPay
Мерчант BetPayОзнакомьтесь с инструкцией по настройке мерчанта BetPay/pages/BcekaUXk56tCj1GX6k2e
Выплаты BetPayОзнакомьтесь с инструкцией по настройке модуля выплаты BetPay/pages/3aiYD71snMWxPYeUQKJn
Парсер BetPayОзнакомьтесь с инструкцией по настройке парсера BetPay/pages/QJbErT24j6voraT6GHCj
# Мерчант BetPay Инструкция по настройке модуля приема BetPay ## Установка мерчанта Используя параметры ниже, установите мерчант через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin).
Параметры для Install Plugin **Plugin type**: **`Merchant module`** **Plugin URL**: **`@boxexchanger-plugins/merchant-betpay-money`** **Directory path**: **`betpay-money`** **Auth: (Deploy token)**: оставляем пустым **Package tag**: **`latest`**
## Конфигурация 1. Для начала [**зарегистрируйтесь**](#user-content-fn-1)[^1] на платформе BetPay по [ссылке ](https://web.bpay.money/Identity/Account/Register)и [**войдите в аккаунт**](#user-content-fn-2)[^2]**.** 2. Перейдите на страницу "**Settings**" и нажмите "[**Generate new secret key**](#user-content-fn-3)[^3]" -> сохраните [**значения**](#user-content-fn-4)[^4] "**MerchantID**" и "**Secret Key**". {% hint style="info" %} Обратите внимание, что значение "**Secret key**" также понадобится для настройки модуля выплаты и парсера BetPay. Сохраните секретный ключ в надежном месте, пока модули BetPay не будут настроены. **В противном случае вам придется пересоздавать "Secret Key" так как после перезагрузки страницы ключ будет скрыт в целях безопасности.** Парсер [BetPay.Money](/obmen/parser-kursov/betpay.money) [Выплаты BetPay.money](/obmen/merchant-i-api/betpay/vyplaty-betpay.money) {% endhint %} 3. В админ панели скрипта BoxExchanger перейдите на страницу "Мерчант и API" - раздел "**MERCHANT SYSTEM**" - [**настройки** ](#user-content-fn-5)[^5]модуля приема "**BetPay Money**". 4. На странице настроек модуля вставьте значение "**MerchantID",** из шага 2, поле "**Merchant id**" - нажмите "[**Save**](#user-content-fn-6)[^6]" -> вставьте значение "**Secret Key**", из шага 2, в поле "**Merchant secret**" - нажмите "[**Save**](#user-content-fn-7)[^7]". 5. [**Скопируйте**](#user-content-fn-8)[^8] WEBHOOK URL. 6. Вернитесь в панель управления BetPay - страница "Settings" - вставьте, скопированный на шаге 5, **WEBHOOK URL** в поле "**PayIn Webhook Url**" - нажмите "[**Save**](#user-content-fn-9)[^9]". 7. В админ панели скрипта BoxExchanger на странице настроек мерчанта BetPay, скопируйте IP из раздела "**BETPAY.MONEY IPS**" -> добавьте IP в белый список Cloudflare. Инструкция: [IP в белый список CloudFlare](/dlya-razrabotchikov/nastroika-firewall/ip-v-belyi-spisok-cloudflare) 8. Мерчант BetPay настроен. [^1]: ![](/files/nqZMmZkrfOtbpTV0u4sC) [^2]: ![](/files/0uCqVgb89paOStYgjvSO) [^3]: ![](/files/65LJwygzBZGDvg1sP41H) [^4]: ![](/files/2vaInQT7esw5Pit8OAzd) [^5]: ![](/files/z3WF4XOIEzD7QCFXdB9Y) [^6]: ![](/files/x5Jh87kdMKqdq9dQcYRY) [^7]: ![](/files/L25XI4yRkdO8P6igzOhT) [^8]: ![](/files/grB0JIN51Qz5IYEGGLks) [^9]: ![](/files/Dd2RHO4EM3RXoCQGmnqN) # Выплаты BetPay.money Инструкция по настройке модуля выплаты BetPay.money ## Установка модуля Используя параметры ниже, установите мерчант через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin).
Параметры для Install Plugin **Plugin type**: **`Payout module`** **Plugin URL**: **`@boxexchanger-plugins/payout-betpay-money`** **Directory path**: **`betpay-money`** **Auth: (Deploy token)**: оставляем пустым **Package tag**: **`latest`**
## Конфигурация 1. Для начала [**зарегистрируйтесь**](#user-content-fn-1)[^1] на платформе BetPay по [ссылке ](https://web.bpay.money/Identity/Account/Register)и [войдите в аккаунт](#user-content-fn-2)[^2]. 2. Перейдите на страницу "**Settings**" и нажмите "[**Generate new secret key**](#user-content-fn-3)[^3]" -> сохраните [**значения**](#user-content-fn-4)[^4] "**MerchantID**" и "**Secret Key**". {% hint style="info" %} Обратите внимание, что значение "**Secret key**" также понадобится для настройки модуля приема и парсера BetPay. Сохраните секретный ключ в надежном месте, пока модули BetPay не будут настроены. **В противном случае вам придется пересоздавать "Secret Key" так как после перезагрузки страницы ключ будет скрыт в целях безопасности.** [Мерчант BetPay](/obmen/merchant-i-api/betpay/merchant-betpay)\ Парсер[BetPay.Money](/obmen/parser-kursov/betpay.money) {% endhint %} 3. В админ панели скрипта BoxExchanger перейдите на страницу "Мерчант и API" - раздел "**PAYOUT SYSTEM**" - [**настройки** ](#user-content-fn-5)[^5]модуля выплат "**BetPay Money**". 4. На странице настроек модуля вставьте значение "**MerchantID",** из шага 2, поле "**Merchant id**" - нажмите "[**Save**](#user-content-fn-6)[^6]" -> вставьте значение "**Secret Key**", из шага 2, в поле "**Merchant secret**" - нажмите "[**Save**](#user-content-fn-7)[^7]". 5. [**Скопируйте**](#user-content-fn-8)[^8] WEBHOOK URL. 6. Вернитесь в панель управления BetPay - страница "Settings" - вставьте, скопированный на шаге 5, **WEBHOOK URL** в поле "**PayOut Webhook Url**" - нажмите "[**Save**](#user-content-fn-9)[^9]". 7. Модуль выплаты BetPay настроен. [^1]: ![](/files/nqZMmZkrfOtbpTV0u4sC) [^2]: ![](/files/0uCqVgb89paOStYgjvSO) [^3]: ![](/files/65LJwygzBZGDvg1sP41H) [^4]: ![](/files/2vaInQT7esw5Pit8OAzd) [^5]: ![](/files/KmLzdIVGjLh1CfDPI16Q) [^6]: ![](/files/x5Jh87kdMKqdq9dQcYRY) [^7]: ![](/files/L25XI4yRkdO8P6igzOhT) [^8]: ![](/files/zqVi6pZa2T1eFT7yDOhV) [^9]: ![](/files/op5IzQAyxyHkpwNISu8n) # CryptoCash Навигационная страница по настройке CryptoCash
Мерчант CryptoCashОзнакомьтесь с инструкцией по настройке мерчанта CryptoCash/pages/HKqjYEJSwX1Sk3mRDOSh
Выплаты CryptoCashОзнакомьтесь с инструкцией по настройке модуля выплаты CryptoCash/pages/16eKI9xDxZkLB2BBuPWb
Выплаты CryptoCash FiatОзнакомьтесь с инструкцией по настройке модуля выплаты CryptoCash Fiat/pages/RegTrp3EG3O5OLe4Apg2
Парсер CryptoCashОзнакомьтесь с инструкцией по настройке парсера CryptoCash/pages/XNa5eU75VvHCmuRB5beV
Дополнительные модулиОзнакомьтесь с инструкцией по настройке дополнительных модулей CryptoCash/pages/3IveX3q8mSq3ta56wS86
# Мерчант CryptoCash Инструкция по настройке мерчанта CryptoCash {% stepper %} {% step %} ## Установка мерчанта Используя параметры ниже, установите мерчант через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin).
Параметры для Install Plugin **Plugin type**: **`Merchant module`** **Plugin URL**: **`@boxexchanger-plugins/merchant-crypto-cash`** **Directory path**: **`crypto-cash`** **Auth: (Deploy token)**: оставляем пустым **Package tag**: **`latest`**
{% endstep %} {% step %} ## Настройка мерчанта {% hint style="info" %} В случае, если вы уже зарегистрировались в CryptoCash и сгенерировали, а также сохранили значения "**Public key**" и "**Private key**" из ЛК CryptoCash, то перейдите к шагу 3. {% endhint %} 1. [**Зарегистрируйтесь**](#user-content-fn-1)[^1] в CryptoCash по [ссылке](https://account.crypto-cash.world/registration) -> [войдите](https://account.crypto-cash.world/login) в ЛК. 2. Зайдите в админ панель скрипта -> страница "**Мерчант и API**" -> в разделе "**MERCHANT SYSTEM**", нажмите на значок настроек в блоке с мерчантом CryptoCash. \ На странице настроек мерчанта CryptoCash, скопируйте значения ["**Public IP**" и "**Callback URL**"](#user-content-fn-2)[^2], они понадобятся на следующем шаге. 3. В ЛК CryptoCash, на странице "**Главная**" - в блоке "**Настройки**" нажмите "[**К настройкам**](#user-content-fn-3)[^3]" -> в модальном окне нажмите "[**Сгенерировать API ключ**](#user-content-fn-4)[^4]" и выберите "[**ED25519**](#user-content-fn-5)[^5]" -> на следующем шаге, в поле "**Имя ключа**" укажите название ключа -> в поле "**URL вебхука**" укажие значение "**Callback URL**" из шага 2 -> активируйте ползунок "**Ограничение по IP**" и укажите значение "**Public IP**" в поле для ввода -> в блоке "**Доступы к endpoints**" выберите:\ \- Пополнение\ \- Баланс\ \- История транзакций\ -> скопируйте значения ["**Секретный ключ**" и "**Публичный ключ**"](#user-content-fn-6)[^6] в надежное место -> нажмите "[**Создать**](#user-content-fn-7)[^7]". {% hint style="info" %} Обратите внимание, что значения "**Секретный ключ**" и "**Публичный ключ**" также понадобятся для настройки [Выплаты CryptoCash](/obmen/merchant-i-api/cryptocash/vyplaty-cryptocash) и [CryptoCash модули](/dopolnitelnye-sistemy/cryptocash-moduli). Сохраните секретный ключ в надежном месте, пока модули CryptoCash не будут настроены. **В противном случае вам придется пересоздавать** "**Секретный ключ**" **так как после перезагрузки страницы ключ будет скрыт в целях безопасности.** {% endhint %} 4. В админ панель скрипта BoxExchanger, на странице настроек мерчанта CryptoCash, в поле "**Public Key**" укажите значение "**Публичный ключ**" из шага 3 -> нажмите "**Save**" -> в поле "**Secret Key**" укажите значение "**Секретный ключ**" из шага 3 -> нажмите "**Save**" -> для поля "**Deposit Processing Mode**" укажите "**Webhook**" -> нажмите "**Save**" -> для поля "**Signature Type**" укажите "**ED25519**" -> нажмите "**Save**". {% endstep %} {% step %} ### Дополнительные настройки * **API URL** - ссылка для API запросов CryptoCash. В случае, если у CryptoCash изменится ссылка для API запросов, то в поле "**API URL**" вы можете указать новую ссылку -> нажать "**Save**". * **Payment with QR-code** - отображение QR-кода с адресом для оплаты. Для отображения QR-кода, выберите значение "**Yes**" -> нажмите "**Save**". * **Over paid limit in %** - допустимый процент переплаты со стороны клиента. К примеру, если вы установите значение "**1**" -> нажмете "**Save**", то при переплате больше 1% для заявки будет установлен статус [Статусы заявки](/zayavki/zayavki/statusy-zayavki#oshibka-oplaty).\ В связке с модулем [Approve underpaid orders](/dopolnitelnye-sistemy/approve-underpaid-orders), будет происходить автоматический пересчет заявки, если переплата со стороны клиента в пределах допустимого процента переплаты. * **Deposit Processing Mode** - способ получения информации о статусе депозита на адрес, сгенерированный CryptoCash. * Automatic check (cron) - получение информации о статусе депозите через API запросы к CryptoCash * Webhook (рекомендуется) - получение информации о статусе депозита по webhook от CryptoCash. При условии, что в API ключе CryptoCash указан Callback URL и в настройках мерчанта выбрана данная опция, на странице заявки будет отображаться актуальное и необходимое количество подтверждений сети текущего депозита. * **Signature Type** - тип подписи для API запросов и webhook. * ED25519 (рекомендуется) - современный тип подписи, его необходимо выбирать в случае, если при создании API ключа в ЛК CryptoCash вы выбрали ED25519. * Legacy - устаревший тип подписи, его необходимо выбирать в случае, если при создании API ключа в ЛК CryptoCash вы выбрали Legacy. * **Debug log** - передача дополнительных логов команде BoxExchanger. В случае трудностей при работе модуля, установите значение "**Yes**" -> "**Save**" и обратитесь к поддержке BoxExchanger. {% endstep %} {% endstepper %} [^1]: ![](/files/Y9xd5i6ifUoInNDnTf4q) [^2]: ![](/files/VFoHiRMpdUaLB1ivaGvv) [^3]: ![](/files/6VwjriUL2aqydmJB7f7D) [^4]: ![](/files/FbcvAc6l8tw4VWDv6ZYR) [^5]: ![](/files/KJ34ALDREAj5WJZIWXtT) [^6]: ![](/files/wQ2puQ7yPLX2CHa4IZtx) [^7]: ![](/files/98N6feJztS8JYzCER62b) # Выплаты CryptoCash Инструкция по настройке модуля выплаты CryptoCash {% stepper %} {% step %} ## Установка модуля Используя параметры ниже, установите модуль выплаты через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin).
Параметры для Install Plugin **Plugin type**: **`Payout module`** **Plugin URL**: **`@boxexchanger-plugins/payout-crypto-cash`** **Directory path**: **`crypto-cash`** **Auth: (Deploy token)**: оставляем пустым **Package tag**: **`latest`**
{% endstep %} {% step %} ## Настройка модуля {% hint style="info" %} В случае, если вы уже зарегистрировались в CryptoCash и сгенерировали, а также сохранили значения "**Public key**" и "**Private key**" из ЛК CryptoCash, то перейдите к шагу 3. {% endhint %} 1. [**Зарегистрируйтесь**](#user-content-fn-1)[^1] в CryptoCash по [ссылке](https://account.crypto-cash.world/registration) -> [войдите](https://account.crypto-cash.world/login) в ЛК. 2. На странице "**Overview**" - в блоке "**Merchant Settings**" нажмите "[**To settings**](#user-content-fn-2)[^2]" -> в модальном окне нажмите "[**Generate API Key**](#user-content-fn-3)[^3]" -> [**скопируйте**](#user-content-fn-4)[^4] значения "**Public key**" и "**Private key**" в надежное место. {% hint style="info" %} Обратите внимание, что значения "**Public key**" и "**Private key**" также понадобятся для настройки мерчанта CryptoCash. Сохраните секретный ключ в надежном месте, пока модули CryptoCash не будут настроены. **В противном случае вам придется пересоздавать "Secret Key" так как после перезагрузки страницы ключ будет скрыт в целях безопасности.** [Мерчант CryptoCash](/obmen/merchant-i-api/cryptocash/merchant-cryptocash) {% endhint %} 3. Перейдите в админ панель скрипта BoxExchanger -> зайдите на страницу "**Мерчант и API"** - раздел "**Payout system**" -> нажмите на [**значок настроек**](#user-content-fn-5)[^5] модуля выплаты CryptoCash. 4. На странице настроек модуля выплаты, в поле "**Public Key**" укажите значение "**Public key**" из шага 2 -> нажмите "**Save**" -> в поле "**Secret Key**" укажите значение "**Private key**" из шага 2 -> нажмите "**Save**". {% endstep %} {% step %} ### Дополнительные настройки * **API URL** - ссылка для API запросов CryptoCash. В случае, если у CryptoCash изменится ссылка для API запросов, то в поле "**API URL**" вы можете указать новую ссылку -> нажать "**Save**". * **Debug log** - передача дополнительных логов команде BoxExchanger. В случае трудностей при работе модуля, установите значение "**Yes**" -> "**Save**" и обратитесь к поддержке BoxExchanger. {% endstep %} {% endstepper %} [^1]: ![](/files/Y9xd5i6ifUoInNDnTf4q) [^2]: ![](/files/HxWFKJpPI6qU5jT4MJ67) [^3]: ![](/files/I7VA7IYjlZKRqlSeFCBq) [^4]: ![](/files/aJGhho37i0InuRL1exf4) [^5]: ![](/files/nLbs2NH9FgtAXuO3FZXk) # Выплаты CryptoCash Fiat Инструкция по настройке модуля выплаты CryptoCash Fiat {% stepper %} {% step %} ## Установка модуля Используя параметры ниже, установите модуль выплаты через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin).
Параметры для Install Plugin **Plugin type**: **`Payout module`** **Plugin URL**: **`@boxexchanger-plugins/payout-crypto-cash-world-fiat`** **Directory path**: **`crypto-cash-world-fiat`** **Auth: (Deploy token)**: оставляем пустым **Package tag**: **`latest`**
{% endstep %} {% step %} ## Настройка модуля 1. [**Зарегистрируйтесь**](#user-content-fn-1)[^1] в CryptoCash по [ссылке](https://account.crypto-cash.world/registration) -> [войдите](https://account.crypto-cash.world/login) в ЛК. 2. Зайдите в админ панель скрипта -> страница "**Мерчант и API**" -> в разделе "**Payout system**", нажмите на значок настроек в блоке с модулем выплаты Crypto-Cash.World Fiat. \ На странице настроек модуля выплаты Crypto-Cash.World Fiat, скопируйте значения ["**Public IP**" и "**Callback URL**"](#user-content-fn-2)[^2], они понадобятся на следующем шаге. 3. В ЛК CryptoCash, на странице "**Главная**" - в блоке "**Настройки**" нажмите "[**К настройкам**](#user-content-fn-3)[^3]" -> в модальном окне нажмите "[**Сгенерировать API ключ**](#user-content-fn-4)[^4]" и выберите "[**ED25519**](#user-content-fn-5)[^5]" -> на следующем шаге, в поле "**Имя ключа**" укажите название ключа -> в поле "**URL вебхука**" укажие значение "**Callback URL**" из шага 2 -> активируйте ползунок "**Ограничение по IP**" и укажите значение "**Public IP**" в поле для ввода -> в блоке "**Доступы к endpoints**" выберите:\ \- **Снятие фиатных денег**\ -> скопируйте значения ["**Секретный ключ**" и "**Публичный ключ**"](#user-content-fn-6)[^6] в надежное место -> нажмите "[**Создать**](#user-content-fn-7)[^7]". 4. Перейдите в админ панель скрипта BoxExchanger, на странице настроек модуля выплаты, в поле "**Public Key**" укажите значение "**Public key**" из шага 3 -> нажмите "**Save**" -> в поле "**Secret Key**" укажите значение "**Private key**" из шага 3 -> нажмите "**Save**". {% endstep %} {% step %} ### Дополнительные настройки * **API URL** - ссылка для API запросов CryptoCash. В случае, если у CryptoCash изменится ссылка для API запросов, то в поле "**API URL**" вы можете указать новую ссылку -> нажать "**Save**". * **Debug log** - передача дополнительных логов команде BoxExchanger. В случае трудностей при работе модуля, установите значение "**Yes**" -> "**Save**" и обратитесь к поддержке BoxExchanger. * **Signature Type** - тип подписи для API запросов и webhook. * ED25519 (рекомендуется) - современный тип подписи, его необходимо выбирать в случае, если при создании API ключа в ЛК CryptoCash вы выбрали ED25519. * Legacy - устаревший тип подписи, его необходимо выбирать в случае, если при создании API ключа в ЛК CryptoCash вы выбрали Legacy. {% endstep %} {% endstepper %} [^1]: ![](/files/Y9xd5i6ifUoInNDnTf4q) [^2]: ![](/files/em2YLx8Q33T19pUKQXZQ) [^3]: ![](/files/6VwjriUL2aqydmJB7f7D) [^4]: ![](/files/FbcvAc6l8tw4VWDv6ZYR) [^5]: ![](/files/KJ34ALDREAj5WJZIWXtT) [^6]: ![](/files/wQ2puQ7yPLX2CHa4IZtx) [^7]: ![](/files/98N6feJztS8JYzCER62b) # ECPay Навигационная страница по настройке ECPay
Выплаты ECPayОзнакомьтесь с инструкцией по настройке модуля выплаты ECPay/pages/5JgM1mCWjgEa5whRgOZS
Парсер ECPayОзнакомьтесь с инструкцией по настройке парсера ECPay/pages/XcjJh6NCXQLVKQdUnvxv
# Выплаты ECPay Инструкция по настройке модуля выплаты ECPay {% stepper %} {% step %} ## Установка модуля Используя параметры ниже, установите модуль выплаты через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin).
Параметры для Install Plugin **Plugin type**: **`Payout module`** **Plugin URL**: **`@boxexchanger-plugins/payout-ecpay`** **Directory path**: **`ecpay`** **Auth: (Deploy token)**: оставляем пустым **Package tag**: **`latest`**
{% endstep %} {% step %} ## Настройка модуля 1. На сайте [ECPay](https://ecpay.systems/) нажмите "**Подключить шлюз**" -> заполните заявку на подключение и отправьте запрос. {% hint style="info" %} Вы также можете обратиться к поддержке BoxExchanger для получения контакта ECPay в Telegram. {% endhint %} 2. Войдите в ЛК [ECPay](https://ecpay.systems/login.php) -> перейдите на [страницу настроек](https://ecpay.systems/settings.php) -> в блоке "**API доступ**" скопируйте [**значения**](#user-content-fn-1)[^1] "**API key**" и "**API secret**" (ключи доступы, если у вашего аккаунта активен API доступ). 3. Перейдите в админ панель скрипта BoxExchanger -> зайдите на страницу "**Мерчант и API"** - раздел "**Payout system**" -> нажмите на значок настроек модуля выплаты **ECPay**. 4. На странцие настроек модуля выплаты, в поле "**API Key (public)**" укажите значение "**API key**" из шага 2 -> нажмите "**Save**" -> в поле "**API Secret**" укажите значение "**API secret**" из шага 2 -> нажмите "**Save**" {% endstep %} {% step %} ### Дополнительные настройки * **API URL** - ссылка для API запросов ECPay. В случае, если у ECPay изменится ссылка для API запросов, то в поле "**API URL**" вы можете указать новую ссылку -> нажать "**Save**". * **Debug log** - передача дополнительных логов команде BoxExchanger. В случае трудностей при работе модуля, установите значение "**Yes**" -> "**Save**" и обратитесь к поддержке BoxExchanger. {% endstep %} {% endstepper %} [^1]: # Heleket Навигационная страница по настройке Heleket
Мерчант HeleketОзнакомьтесь с инструкцией по настройке мерчанта Heleket/pages/i4kkrAgu4gnTtjI3OphN
Выплаты HeleketОзнакомьтесь с инструкцией по настройке модуля выплаты Heleket/pages/tS7i5IZKOw69dnNoVPfz
Парсер HeleketОзнакомьтесь с инструкцией по настройке парсера Heleket/pages/pjMd857xggA6hgaRoGlK
Дополнительные модулиОзнакомьтесь с инструкцией по настройке дополнительных модулей Heleket/pages/bbhyoOXOKceFV9NKJlck
--- [Next Page](/llms-full.txt/1)