> For the complete documentation index, see [llms.txt](https://lara-script.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lara-script.gitbook.io/docs/ua/funkcional-admin-paneli/merchanti/001k.md).

# 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="/files/58847ff93db4ea544efd2c9b4b94e9f64a30b3de" 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="/files/ZbDPfBNzcjjbfAZwuQ9o" 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-2)
* Під час налаштування валют для прийому коштів через цього мерчанта поле "Мережа мерчанта" заповнюйте разом з тікером валюти, приклад нижче

<figure><img src="/files/PL0t52sQlAEbKv7ZH0Fl" alt="" width="563"><figcaption></figcaption></figure>