# BitOK

## Подключение к сервису

{% hint style="warning" %}
Для подключения к сервису напишите [менеджеру](https://t.me/premiumexchanger_business) — он создаст чат с вами и представителями AML сервиса для обсуждения условий подключения, тарифов и других вопросов
{% endhint %}

После получения доступа к сервису пополните счет для выполнения проверок реквизитов клиентов на вашем обменнике.

Зайдите в личный кабинет, раздел "[**Ключи API**](https://kyt.bitok.org/api-keys)". Выпустите новый ключ по кнопке "**Создать ключ**", в открывшемся окне укажите желаемое название для ключа и IP-адрес вашего сервера (необязательно).

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-1516155948e02cf0cfd1b4f0e7c732eb89be0712%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Нажмите "**Создать**" и скопируйте в текстовый файл сгенерированные ключи.

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-89b8db755caf7412559506194645b325a99536a1%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

В панели администратора скрипта, в разделе "**Модули**" -> "**BitOK**" заполните поля для авторизации в модуле:

{% tabs %}
{% tab title="2.5" %}

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-2c914595691dbfde45efd3cac6c79803276c8019%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

**API ключ** — **API ключ**, сгенерированный в ЛК сервиса BitOK

**API secret** — **Секрет API**, сгенерированный в ЛК сервиса BitOK

**Время ожидания результата проверки (сек, макс до 25-30 сек)** — время ожидания ответа от сервиса после отправки реквизитов (рекомендуем устанавливать значение в диапазоне от 15 до 28). Если проверяется кошелек при создании заявки, то на указанное значение в секундах будет увеличиваться время создание заявки после нажатия клиентом кнопки "**Создать заявку**".

**Риск, если API не работает (в автовыплате)** — укажите желаемое значение риска (от 0 до 100), которое будет иметь значение, если от API сервиса не будет получен ответ. Значение должно быть выше значения из поля "**Критичный уровень риска хэша**".
{% endtab %}

{% tab title="2.6" %}

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-c86240623478e96a6ec9ab6d8f7e7e1d332a3150%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

**API ключ** — **API ключ**, сгенерированный в ЛК сервиса BitOK

**API secret** — **Секрет API**, сгенерированный в ЛК сервиса BitOK

**Время ожидания результата проверки (сек, макс до 25-30 сек)** — время ожидания ответа от сервиса после отправки реквизитов (рекомендуем устанавливать значение в диапазоне от 15 до 28). Если проверяется кошелек при создании заявки, то на указанное значение в секундах будет увеличиваться время создание заявки после нажатия клиентом кнопки "**Создать заявку**".

**Статус заявки, если превышен риск** — автоматический перевод заявки в выбранный из выпадающего списка статус при превышении риска (опция актуальная, когда проверка адреса или хеша выполняется в уже созданной заявке)

**Риск, если API не работает** — укажите желаемое значение риска (от 0 до 100), которое будет иметь значение, если от API сервиса не будет получен ответ. Значение должно быть выше значения из полей "**Критичный уровень риска адреса**" и "**Критичный уровень риска хеша**".
{% endtab %}
{% endtabs %}

## Настройка модуля

{% hint style="warning" %}
Обратите внимание, что уровень риска в модуле настраивается для всех направлений обмена, где он будет использоваться, вне зависимости от валюты. Индивидуальных настроек для каждого направления обмена не предусмотрено
{% endhint %}

В разделе "**Модули**" -> "**BitOK**" отображаются поля для настройки уровня риска, при котором будет срабатывать модуль. В зависимости от настроек направления обмена:

* **для кошелька** — запрещать создание заявки с указанным кошельком
* **для хеша входящей транзакции** — запрещать проводить автовыплату (при использовании подключенного модуля автовыплаты)

### Настройки для проверки адреса

**Критичный уровень риска адреса** — <mark style="color:red;">**обязательно**</mark> укажите значение (от 0 до 100), при превышении которого модуль будет сообщать о риске для заявки в разделе "Заявки" (перед настройкой раздела рекомендуем запросить у менеджера BitOK консультацию по настройке уровня риска)

**Остальные параметры** — установка уровней риска для тех или иных категорий (заполнять не требуется, т.к. настройка по категориям производится на стороне сервиса BitOK)

<div><figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-f0ab5209fae4a5cea9d3c91e2b77413b01f323db%2Fimage.png?alt=media" alt="" width="305"><figcaption></figcaption></figure> <figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-328915fce48d2e997bcf36038b1f7e49f89f46b5%2Fimage.png?alt=media" alt="" width="293"><figcaption></figcaption></figure></div>

### Настройки для проверки хеша входящей транзакции

**Критичный уровень риска хеша** — <mark style="color:red;">**обязательно**</mark> укажите значение (от 0 до 100), при превышении которого модуль будет сообщать о риске для заявки в разделе "Заявки" (перед настройкой раздела рекомендуем запросить у менеджера BitOK консультацию по настройке уровня риска)

**Остальные параметры** — установка уровней риска для тех или иных категорий (заполнять не требуется, т.к. настройка по категориям производится на стороне сервиса BitOK)

<div><figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-3e592349daf59e0ae3cc2027a2b664c3063a803e%2Fimage.png?alt=media" alt="" width="314"><figcaption></figcaption></figure> <figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-3c4cbe1cd54af8681377c086d0d6714cf7a2f476%2Fimage.png?alt=media" alt="" width="293"><figcaption></figcaption></figure></div>

### Ручные проверки

Также в этом же разделе вы можете производить проверки адресов и хешей вручную.

Для проверки адреса укажите его значение в поле "**Адрес**", выберите корректную валюту для этого адреса и нажмите кнопку "**Проверка**".

Для проверки хеша укажите адреса кошелька **для приема средств** по проверяемой транзакции в поле "**Адрес**", выберите корректную валюту для этого адреса, а также укажите сам хеш в поле "**TxID**" и нажмите кнопку "**Проверка**".

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-fea00490b59932c3497ebccbee21a8bfd9e03fac%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Результаты проверки будут отображаться в начале страницы с настройками модуля, а также в разделе "**Модули**" -> "**Bitok logs**".

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-f96151b5ca7b87dad3e38b310e703b51921e7beb%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-2e7570b3559877fdf9e823859aa6d3d78689ecc0%2Fimage%20(1746).png?alt=media" alt="" width="421"><figcaption></figcaption></figure>

## Настройка модуля в направлении обмена

{% hint style="warning" %}
Ошибка как на скриншоте ниже, означает, что у вас нет доступных проверок — необходимо приобрести новый пакет проверок на сервисе BitOK.

<img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-aaa42531669ddb76b019b9f5d12f3778e29a6596%2Fimage.png?alt=media" alt="" data-size="original">
{% endhint %}

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

Откройте настройки направления обмена, в котором хотите использовать проверки и перейдите на вкладку "**Bitok**"

### Версия 2.5

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-acab86f79abb46f22dbe278b4bb80609ae6092cd%2Fimage.png?alt=media" alt="" width="533"><figcaption></figcaption></figure>

Проверка счетов "**Отдаю**" и "**Получаю**":

<div><figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-7509d47ff5af5a1c7cec59f9087f24afa3198f17%2Fimage.png?alt=media" alt="" width="253"><figcaption></figcaption></figure> <figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-41d54dc9843d570de26907767628fb243363b84b%2Fimage.png?alt=media" alt="" width="242"><figcaption></figcaption></figure></div>

* **Нет** — проверка не будет производиться
* **Да** — проверка будут производиться только для информационных целей без запрета на создание заявки<br>

  <figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-061716b318128d17a58b3b658ff2c957e5d30f4a%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
* **Да и запретить создавать заявку** — проверка будут производиться для запрета создания заявки при превышении заданного уровня риска<br>

  <figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-fafb1eae3a9db9d276ecda634c83a62723662404%2Fbrave_nG8qmZEGwR.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>
* **Сумма обмена "от"** — укажите размер суммы из заявки, при превышении которого будет выполняться проверка адреса. При сумме ниже указанной, проверка выполняться не будет.\
  \
  Значение указывается в валюте, для которой будет проверяться адрес (к примеру для проверки адреса USDT укажите 1000, для BTC — 0.015 и т.п., но все значения вы указываете на своё усмотрение).

Проверка TxID:

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-088b0a3e168664544860ed68359a97b1492113b9%2Fimage.png?alt=media" alt="" width="206"><figcaption></figcaption></figure>

* **Нет** — проверка не будет производиться
* **Да** — проверка будут производиться только для информационных целей без запрета выплаты\ <br>

  <figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-f16ce438d6c6966b489ae60cb96b36cf75e91d83%2F.png?alt=media" alt=""><figcaption></figcaption></figure>
* **Да и прекратить выплату** — проверка будут производиться для запрета выплаты по заявке при превышении заданного уровня риска (актуально только если в направлении обмена подключена автовыплата).\
  При переходе заявки в статус "**Ошибка автовыплаты**" при превышении уровня риска вы можете убедиться в срабатывании модуля, перейдя в раздел "**Мерчанты**" -> "**Лог автовыплат**", где будет отображаться следующая запись:<br>

  <figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-30053871fd640f45271081f534be4ff1ddb92783%2Fbrave_phwefACCZG.png?alt=media" alt=""><figcaption></figcaption></figure>
* **Сумма обмена "от"** — укажите размер суммы из заявки, при превышении которого будет выполняться проверка хеша. При сумме ниже указанной, проверка выполняться не будет.\
  Значение указывается в валюте для стороны "**Отдаю**"

### Версия 2.6

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-9cc7255670d0a292295bfa69db1062943e529718%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Проверка счетов "**Отдаю**" и "**Получаю**":

<div><figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-8540dc9081e372a2dfd49a080f59dc9cad36a343%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure> <figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-0765b19a20608d33c4d60e6d8997180693de2144%2Fimage%20(402).png?alt=media" alt=""><figcaption></figcaption></figure></div>

* **Нет** — проверка не будет производиться
* **Да, во время создания заявки** — проверка будут производиться для запрета создания заявки при превышении заданного уровня риска<br>

  <figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-fafb1eae3a9db9d276ecda634c83a62723662404%2Fbrave_nG8qmZEGwR.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>
* **Да, при оплате** — проверка счета будет производиться после приема платежа, сделанного клиентом (только, если в направлении обмена подключен модуль мерчанта на прием средств)
* **Да, во время автовыплаты** — проверка счета будет производиться перед выплатой средств клиенту (только, если в направлении обмена подключен модуль автовыплаты средств)
* **Превышение риска:**\
  • **Ничего** — Проверки будут производиться только для информационных целей\
  • **Ошибка** — При превышении риска, указанного в настройках модуля, будет отображаться ошибка
* **Сумма обмена "от"** — укажите размер суммы из заявки, при превышении которого будет выполняться проверка адреса. При сумме ниже указанной, проверка выполняться не будет.\
  \
  Значение указывается в валюте, для которой будет проверяться адрес (к примеру для проверки адреса USDT укажите 1000, для BTC — 0.015 и т.п., но все значения вы указываете на своё усмотрение).

Проверка TxID:

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-5217a46083cf823d574ff586bfdc138f6dd6fbaf%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-088b0a3e168664544860ed68359a97b1492113b9%2Fimage.png?alt=media" alt="" width="206"><figcaption></figcaption></figure>

* **Нет** — проверка не будет производиться
* **Да, при оплате** —
* **Да, во время автовыплаты** —\ <br>

  <figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-f16ce438d6c6966b489ae60cb96b36cf75e91d83%2F.png?alt=media" alt=""><figcaption></figcaption></figure>
* **Да и прекратить выплату** — проверка будут производиться для запрета выплаты по заявке при превышении заданного уровня риска (актуально только если в направлении обмена подключена автовыплата).\
  При переходе заявки в статус "**Ошибка автовыплаты**" при превышении уровня риска вы можете убедиться в срабатывании модуля, перейдя в раздел "**Мерчанты**" -> "**Лог автовыплат**", где будет отображаться следующая запись:<br>

  <figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-30053871fd640f45271081f534be4ff1ddb92783%2Fbrave_phwefACCZG.png?alt=media" alt=""><figcaption></figcaption></figure>
* **Сумма обмена "от"** — укажите размер суммы из заявки, при превышении которого будет выполняться проверка хеша. При сумме ниже указанной, проверка выполняться не будет.\
  Значение указывается в валюте для стороны "**Отдаю**"