# 001K

### Интеграция 001k Bot с Lara Script

**Режимы работы:**

* прием платежей (Merchant)
* автоматические выплаты по заявкам (Auto Payout)

### 1. Подготовка со стороны 001k Bot

#### 1.1 Запуск бота и получение UID

1. Откройте [Telegram-бот **001k**](https://t.me/OO1kBOT) и нажмите **Start**
2. Перейдите в раздел **Инфо**
3. Скопируйте ваш **UID**
4. После этого откройте пункт **Поддержка**

<figure><img src="https://2391054755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2FMymVYY6xFzoMgZhs7dni%2Fimage.png?alt=media&#x26;token=31b186f1-2c63-4404-b55b-bc28ff0f426b" alt="" width="563"><figcaption></figcaption></figure>

#### 1.2 Запрос на активацию API

В личных сообщениях с представителем поддержки **001k Bot Support** необходимо отправить запрос на подключение API.

В запросе укажите:

* ваш полученный в прошлом шаге **UID**
* название и ссылку на обменный сервис
* интересующие направления/валютные пары
* типы операций:
  * депозит
  * вывод

> ⚠️ Активация API производится вручную после проверки со стороны 001k.

#### 1.3 Подключение двухфакторной аутентификации (2FA)

Для работы с API **обязательно** требуется включить 2FA.

1. В боте откройте **Настройки**
2. Перейдите в раздел **2FA**
3. Нажмите **Добавить 2FA**
4. Введите произвольное название (например: *LaraScript*)
5. Подтвердите название
6. Отсканируйте QR-код или введите секретный ключ в приложение-аутентификатор\
   (Google Authenticator)
7. Отправьте боту 6-значный код подтверждения

После успешного добавления вы получите сообщение об активации "**2FA был добавлен!**"

### 2. Создание API-ключей в 001k Bot

После успешной активации API в боте становится доступен расширенный функционал.

1. Перейдите в раздел **Дополнительный функционал**
2. Выберите **API доступ**
3. Нажмите **Создать API ключ**
4. Укажите название API-ключа
5. Активируйте необходимые разрешения (для работы интеграции бота как мерчанта и модуля автовыплат Вам будет достаточно иметь первые 3 доступа):
   * **Баланс -** для просмотра всех деталей балансов
   * **Депозит** - для приема платежей
   * **Вывод** - для автоматических выплат
   * **Обмен** - возможность внутренних обменов валют
   * **Лимитный ордер** - функционал для фиксирования желаемой цены на покупку или продажу.
   * **AML** - внутренний функционал проверок что включают в себя анализ транзакций и клиентов
   * **Трансфер** - возможность отправлять средства используя лишь **UID**\ <br>

     <figure><img src="https://2391054755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2F8HlCYv50TgJ1Adhw9fvC%2Fimage.png?alt=media&#x26;token=ba36cb9e-77c1-4edb-ace0-0ee1b6afc0aa" alt="" width="270"><figcaption></figcaption></figure>
6. Нажмите **Далее**

#### 2.1 Добавление IP сервера Lara Script

Вам необходимо выполнить 1 из сценариев для получения IP:

1. Вам необходимо зайти через ssh на собственный сервер и выполнить команду /curl 2ip.me
2. Зайти в личный кабинет хостинг-провайдера и также найти IP собственного сервера
3. Либо оставить разрешёнными все IP

Вернитесь в Telegram-бот 001k и отправьте скопированный IP и подтвердите его

#### 2.2 Завершение создания API-ключа

1. Подтвердите активацию API сразу после создания
2. Проверьте параметры
3. Подтвердите создание ключа
4. Введите код 2FA

После этого бот отправит:

* **API Key**
* **API Secret**

⚠️ Рекомендуется:

* сохранить ключи в надежном месте
* **удалить сообщение с ключами из чата 001k Bot**

### 3. Настройка мерчанта в Lara Script

1. В админ-панели перейдите в Мерчанты - 001K и в Общие - Автовыплаты
2. Откройте настройки мерчанта **001k**
3. Заполните поля:
   * **API Key** — ключ доступа
   * **API Secret** — секретный ключ
4. Сохраните изменения

После этого мерчант считается настроенным и готовым к использованию.

### 4. Использование в направлениях обмена

Мерчант **001k Bot** может быть назначен:

* как модуль приема средств
* как модуль автоматических выплат по заявкам

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

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

### 5. Примечания

* Интеграция поддерживает автоматическую обработку заявок
* Все операции с API защищены двухфакторной аутентификацией
* Некорректный IP или отсутствие необходимых разрешений могут привести к отказу в выполнении API-запросов
* Рекомендуем также пользоваться [документацией 001k](https://telegra.ph/Bot-Guide-08-24)
* При настройке валют для приёма средств через данного мерчанта поле "Сеть мерчанта" заполняйте вместе с тикером валюты, пример ниже

<figure><img src="https://2391054755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2FQu1lMqoj0MTirGPeRRhK%2Fimage.png?alt=media&#x26;token=ee8a5afd-5fb6-4855-ab74-cbd4394d4cfe" alt=""><figcaption></figcaption></figure>