BoxExchanger
Ask or search…
K

Мерчант whitebit

Поддерживаемые валюты

  • Банковские карты: EUR, USD, KTZ, UAH (временно недоступно)
  • Криптовалюты: BTC, ETH, LTC, USDT...

Регистрация и подготовка аккаунта whitebit

  • Зарегистрируйтесь на бирже whitebit - пройдите верификацию личности - включите 2FA.
  • Обратитесь в поддержку whitebit. В сообщении укажите: - Username вашего аккаунта - Запрос на активацию генерации адресов для депозита для работы онлайн обменного сервиса (ссылка на ваш обменный сервис) на движке BoxExchanger.

Создание API ключа на прием на whitebit

Убедитесь, что у вас включена 2FA для аккаунта whitebit. В противном случае вы не сможете создать API ключ.
  1. 1.
    Перейдите в настройки аккаунта - раздел "API" - ключи API - нажмите "Редактировать" в блоке "Ключи API" (либо нажмите тут для быстрого перехода к данной странице) - далее "Сгенерировать ключ API" - введите 2FA.
  2. 2.
    Скопируйте в надежное место Ключ (публичный) и Секретный ключ (данные понадобятся для настройки модуля в админ панели).
  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/v1/account/balance
Раздел "Управление ордерами" /api/v4/order/new /api/v4/order/market
  1. 4.
    На странице "Ключи API" нажмите "IP-доступ" - далее переведите ползунок в активное положение - введите IP-адрес v4 (также IPv6, если есть. IPv6 может быть не доступен тогда его можно пропустить и вставить только IPv4) back-end сервера - нажмите "Добавить" - введите 2FA.
IP-адрес формате v4 и v6 можно узнать
  1. 1.
    В админ панеле на странице настроек мерчанта whitebit. Для этого перейдите на страницу "Мерчант и API" - раздел "MERCHANT SYSTEM" - настройки (значок настроек) в блоке с мерчантом "WhiteBit Exchanger" - внизу страницы "PUBLIC IP" и "PUBLIC IPV6".
  2. 2.
    В ЛК лицензий - поле "Back-end server".
Обратите внимание, что ваш ключ API будет автоматически деактивирован со стороны whitebit в случае отсутствия активности API в течение 14 дней. Его можно будет активировать повторно на странице "Ключи API".

Конфигурация мерчанта в админ панели

Основные настройки

  1. 1.
    В админ панели перейдите на страницу настроек мерчанта whitebit. Для этого перейдите на страницу "Мерчант и API" - раздел "MERCHANT SYSTEM" - настройки (значок настроек) в блоке с мерчантом "WhiteBit Exchanger".
  2. 2.
    В поле "API Secret" вставьте ранее скопированный Секретный ключ - нажмите "Save". (после перезагрузки страницы API Secret будет скрыт и перестанет отображаться в админ панели в целях безопасности).
  3. 3.
    В поле "API Key" вставьте ранее скопированный Ключ (публичный) - нажмите "Save".
  4. 4.
    Вы можете включить отображение QR-кода с адресом для депозита. Для этого в поле "Payment with QR-code?" выставьте значение "Yes" - нажмите "Save".
  5. 5.
    Вы можете включить авто конвертацию валюты, которая поступила на ваш баланс whitebit от клиента по заявке. Для этого вам необходимо в разделе "AUTO SELL (AFTER ACCEPT PAYMENT)" для "Convert to" выбрать валюту (USDT/USDC/EUR) в которую будет происходить автоматическая конвертация средств по заявке - нажать "Save".
В случае, если вы хотите использовать связку мерчанта и модуля выплаты whitebit для автоматизации процесса обмена и использования ликвидности биржи, вам необходимо будет включить авто конвертацию в настройках мерчанта whitebit. Обычно включается авто конвертация в USDT.
Также обратите внимание, что валюта в которую будет производиться авто конвертация ("Convert to" в настройках мерчанта) и валюта из которой будет происходить выплата ("Withdraw from" в настройка модуля выплат) должны совпадать для автоматизации процесса.

Webhook

Настройка Webhook важна для:
  • Моментального перевода статуса заявки "На выплату" сразу после получения депозита на whitebit
  • Отображения на странице заявки количества подтверждений сети для зачисления депозита

Настройка webhook

  1. 1.
    Справа сверху наведите на иконку профиля -> нажмите на "API".
  2. 2.
    На странице "API" в блоке "Webhook" нажмите "Редактировать".
  3. 3.
    На открывшейся странице нажмите "Продолжить" -> ваc перенаправит на страницу "Соединение".
  4. 4.
    Перейдите в админ панель BoxExchanger -> страница "Мерчант и API" -> настройки мерчанта whitebit -> на странице настроек в разделе "WEBHOOK SETTINGS" скопируйте URL.
  5. 5.
    Вернитесь на страницу "Соединение" в ЛК whitebit -> в поле "Адрес webhook" вставьте URL из шага 4 -> нажмите "Сгенерировать ключ" -> введите 2FA.
  6. 6.
    Скопируйте в надежное место "Секретный ключ" и "Ключ" (публичный ключ) -> нажмите "Подтвердить".
  7. 7.
    Добавьте публичный ключ в TXT запись домена, указанного при создании ключа. Разберем на примере добавления записи в Cloudflare. а) Зайдите в ЛК Cloudflare -> на странице "Websites" зайдите на страницу настроек домена, который вы указывали при создании ключа. б) Перейдите на страницу "DNS" -> "Records" -> нажмите "Add record" -> "Type" выберите "TXT" -> "Name" введите "www", если у вас домен формата www.exchanger.com либо "@" если в формате exchanger.com либо субдомен, если в формате subdomain.exchanger.com -> в поле "Content" вставьте публичный ключ webhook из шага 6 -> нажмите "Save".
  8. 8.
    Вернитесь на страницу "Webhook" в ЛК whitebit -> включите webhook, переведя ползунок в активное состояние -> доступ "Коды" можно отключить.
  9. 9.
    После того как webhook будет активирован, перейдите обратно в настройки домена Cloudflare из шага 7 б) -> удалите добавленную TXT запись (нажмите "Edit" в поле с TXT записью -> Delete -> подтвердите удаление).
  10. 10.
    Перейдите в админ панель BoxExchanger -> страница "Мерчант и API" -> настройки мерчанта whitebit -> на странице настроек в разделе "WEBHOOK SETTINGS" -> в поле "Webhook key" вставьте публичный ключ из шага 6 -> нажмите "Save" -> в поле "Webhook Secret" вставьте секретный ключ из шага 6 -> нажмите "Save".
  11. 11.
    Добавьте IP, с которого whitebit отправляет webhook, в белый список CloudFlare. Инструкция:IP в белый список CloudFlare. IP вы можете уточнить у поддержки BoxExchanger.
  12. 12.
    Протестируйте работу мерчанта whitebit.

Дополнительные настройки

  • Enable debug mode - значение "1" включает отправку дополнительных логов для разработчиков. Может быть полезно для анализа логов при возникновении трудностей с модулем. Без крайней необходимости рекомендуем не включать и оставить значение "0".
  • Enable Wallet deposit cron - значение "1" активирует возможность генерации статического адреса для депозита в ЛК пользователя. По умолчанию выставлено "0".
  • Add hours to expires time (when find tx with 0 confirms) - настройка увеличения времени заявки после того как система определит транзакцию (будет 0 подтверждений у транзакции). 0.25 = 15min. К пример, если вы укажите 0.5, то время заявки будет увеличено на 30 минут после определения транзакции.
  • BTC/LTC type address - выбор формата адреса (p2sh-segwit/bech32) для депозита для валют BTC и LTC.
  • Provider fiat USD/EUR/UAH/KZT - выбор провайдера через который будет осуществляться прием фиатной валюты. На данный момент whitebit по API поддерживает только VISAMASTER.

Прием фиатных валют

Для работы с фиатными валютами - обратитесь в поддержку whitebit с запросом активации фиатного шлюза для необходимой валюты.
Внимание! Для приема EUR,USD в настройке данных направлений - шаг "Отображение полей" - обязательно включите созданное по-умолчанию поле "E-mail". Со стороны whitebit требование запрашивать от клиента ввод Email адреса.

Верификация

  • Требования по верификации вы всегда можете уточнить у представителей whitebit
Для локализации текста используйте символ решётки и код языка перед текстом и "##" после текста. Например: ##ua## Текстова інформація ##
Текст, который находится между открывающими и закрывающими тегами будет отображаться только на украинской версии сайта. К примеру если клиент зайдет на сайт на украинском языке то он будет видеть только "Текстова інформація"

Верификация пользователя

Ручная верификация пользователя настраивается в направлении. Инструкцию по созданию и настройке направления вы можете найти тут: Направление
  • Перейдите в админ панель - вкладка "Направления" - "Настройки направлений" - нажмите "Изменить" в строке с нужным направлением.
  • В настройках направления перейдите к шагу "Верификация" - нажмите "Включить" напротив "ВЕРИФИКАЦИЯ: (IDENT DOCUMENTS PASSPORT ETC)".
  • В поле "Count verification photos" введите кол-во требуемых от пользователя изображений для верификации - в поле редактора текста введите текст с инструкцией для верификации пользователя и обязательно сохраните все изменения. (см. примеры ниже)
Примеры текста для верификации личности на разных языках
##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. ##
  • После проделанных действий, на клиентской части на этапе оплаты заявки появится кнопка "Пройти верификацию" напротив поля "Проверка личности". При нажатии на эту кнопку открывается модальное окно с инструкцией и возможностью загрузить изображения для верификации.

Верификация валюты

Ручная верификация валюты включается в настройках валюты и позволяет запросить у клиента только одно изображение. Инструкцию по созданию и настройке валюты вы можете найти тут: Валюты
  • Данный тип верификации можно использовать для верификации банковской карты клиента.
  • Верификация "Валюты А" будет запрашиваться во всех направлениях, в которых клиент отдает обменному сервису "Валюту А".
  • Для верификации "Валюты Б", которую обменный сервис отправит клиенту, следуйте инструкции тут: 2.-verifikaciya-rekvizitov-vyplata
  • Перейдите в админ панель - вкладка "Валюты" - "Настройка валют" - нажмите "Изменить" в поле нужной валюты.
  • В настройках валюты перейдите к шагу "Другие настройки" - нажмите "Включить" напротив поля "ВЕРИФИКАЦИЯ".
  • В поле редактора текста введите текст с инструкцией для прохождения верификации (см. пример ниже) и обязательно сохраните изменения
Пример текста для верификации банковской карты
##ru## Для того, чтобы верифицировать виртуальную карту Вам необходимо сделать следующие шаги:
  1. 1.
    Необходимо сделать скриншот из Вашего личного кабинета (в банкинге), на котором должно быть видно: - 4 последние цифры номера карты - срок действия карты
  2. 2.
    Сделать фото на котором будет написано ФИО, дата и подпись владельца карты, а также видна виртуальная карта с банкинга.
  3. 3.
    Загрузить фото в поле верификации валюты.
Для того чтобы верифицировать физическую карту:
  1. 1.
    Возьмите белый лист бумаги.
  2. 2.
    Расположите на листе банковскую карту так, чтобы было видно номер карты и дату.
  3. 3.
    Карта и ее тень должны быть видны полностью.
  4. 4.
    Напишите от руки название сервиса "yourExchangerName".
  5. 5.
    Поставьте дату и подпись.
  6. 6.
    Сфотографируйте и загрузите изображение.
  7. 7.
    Готово! ##
  • После проделанных действий, на клиентской части на этапе оплаты заявки появится кнопка "Пройти верификацию" напротив поля с названием валюты. При нажатии на эту кнопку открывается модальное окно с инструкцией и возможностью загрузить изображение для верификации.
Last modified 1mo ago