> 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/ru/funkcional-admin-paneli/merchanty/2328.io.md).
# 2328.io
Интеграция с 2328.io позволяет принимать криптовалютные платежи от клиентов через автоматическую генерацию адреса для оплаты. После поступления средств платформа получает webhook-уведомление и подтверждает заявку без участия оператора.
Сайт сервиса: [https://2328.io](https://2328.io/) Документация API: [https://doc.2328.io](https://doc.2328.io/)
➡️ Для автоматических выплат используется отдельный модуль — [см. документацию по автовыплатам 2328.io.](https://lara-script.gitbook.io/docs/ru/funkcional-admin-paneli/obshie/avtoplatezhi/2328.io)
#### 📌 Возможности интеграции
* Приём криптовалют через 2328.io (merchant)
* Автоматическая генерация адреса / QR-кода для оплаты
* Webhook-уведомления о статусе платежа
* Поддержка множества сетей и токенов
* Автоконвертация входящих средств в USDT (настраивается в личном кабинете 2328.io)
* Провайдер котировок 2328.io для динамических курсов в направлениях
#### 🔑 Получение ключей в личном кабинете 2328.io
**Шаг 1. Регистрация**
Зарегистрируйтесь на и войдите в личный кабинет.
**Шаг 2. Создание проекта**
1. Перейдите в раздел **Проекты** (Бизнес → Проекты)
2. Нажмите **«+ Новый проект»**
3. Заполните форму:
* **Название проекта** — имя вашего проекта
* **URL проекта** — адрес вашего сайта
* **Telegram-контакт** — ваш Telegram для связи с модерацией
4. Нажмите **«Отправить на проверку»**
> ⚠️ Каждый проект проходит ручную модерацию. Обычно проверка занимает несколько часов. До одобрения проект будет в статусе **«МОДЕРАЦИЯ»**. После одобрения статус сменится на **«АКТИВНЫЙ»**.
**Шаг 3. Настройка проекта**
После активации откройте проект и настройте параметры под себя:
| Раздел | Описание |
| ---------------------- | ------------------------------------------------------- |
| Автоконвертация в USDT | Автоматическая конвертация входящих платежей в USDT |
| Брендирование PayForm | Логотип, цвета и оформление платёжной формы для клиента |
| Fee split и наценка | Передача комиссии на плательщика, наценки по валютам |
| Доступные валюты | Какие монеты и сети видит клиент при оплате |
| Время жизни инвойса | Срок действия платёжной ссылки по умолчанию |
| Уведомления в Telegram | Оповещения о платежах в Telegram-чат |
⚠️ Рекомендуем настроить автоконвертацию в USDT - тогда Вам не нужно будет держать запасной баланс USDT для дальнейшего использования функционала автовыплат, для этого достаточно перейти в настройки данного раздела, и выбрать исходные валюты для работы данного правила.
**Шаг 4. Получение ключей**
В блоке **«Детали проекта»** скопируйте необходимые данные:
| Поле в 2328.io | Где используется в Lara Script |
| ------------------- | ------------------------------------------------ |
| **Project ID** | Мерчант и автовыплаты |
| **Payment API Key** | Только мерчант (приём платежей) |
| **Payout API Key** | Только модуль автовыплат (не нужен для мерчанта) |
> 💡 Для настройки мерчанта нужны **Project ID** и **Payment API Key**.
#### ⚙️ Подключение мерчанта в Lara Script
1. Перейдите в **Админ-панель → Мерчанты**
2. Выберите мерчант **2328.io**
3. Заполните поля:
| Поле в Lara Script | Значение |
| ------------------ | --------------- |
| UUID проекта | Project ID |
| API-ключ | Payment API Key |
4. Сохраните изменения
#### 🪙 Настройка валют
После подключения мерчанта обязательно настройте валюты.
Перейдите: **Общие → Валюты**
**📌 Основное правило**
Тикер валюты и код сети должны строго соответствовать справочнику 2328.io.
Полный справочник:
**Соответствие валют и сетей**
| Тикер валюты | Сеть мерчанта |
| ------------ | ------------------------------------------------------------ |
| `USDT` | TRX-TRC20, BSC-BEP20, ETH-ERC20, AVAX-C, POL-MATIC, TON, SOL |
| `USDC` | BSC-BEP20, ETH-ERC20, AVAX-C, POL-MATIC, SOL |
| `BTC` | BTC |
| `ETH` | ETH-ERC20 |
| `BNB` | BSC-BEP20 |
| `TRX` | TRX-TRC20 |
| `LTC` | LTC |
| `DASH` | DASH |
| `TON` | TON |
| `AVAX` | AVAX-C |
| `POL` | POL-MATIC |
| `SOL` | SOL |
| `DOGE` | DOGE |
> ⚠️ Если тикер или сеть указаны неверно — система не сможет создать платёж, и заявка не получит адрес для оплаты.
> ℹ️ В настройках проекта на стороне 2328.io (раздел «Доступные валюты») должны быть включены те же монеты и сети, которые вы используете на платформе.
#### 🔄 Настройка направлений обмена
Перейдите: **Админ-панель → Общие → Направления**
Для нужного направления:
1. Укажите **Мерчант: 2328.io** в настройках направления либо валюты
2. При необходимости выберите котировку с провайдером **2328.io**
3. Сохраните направление
#### ✅ Как это работает
1. Клиент создаёт заявку в направлении с мерчантом 2328.io
2. Платформа отправляет запрос в API → клиенту генерируется адрес кошелька для оплаты
3. Клиент переводит криптовалюту на сгенерированный адрес
4. 2328.io фиксирует поступление → отправляет webhook на платформу
5. Lara Script получает уведомление → заявка подтверждается
➡️ В связке с модулем автовыплат можно построить полностью автоматическое направление.
#### 📊 Мониторинг транзакций
Все входящие платежи доступны в личном кабинете 2328.io:
**История → История транзакций**
При раскрытии транзакции отображается полная информация:
Также доступны:
* **Детали webhook** — просмотр отправленного webhook
* **Переотправить webhook** — повторная отправка, если платформа не получила уведомление
**Статусы платежей 2328.io**
| Статус | Описание |
| ----------- | ----------------------------- |
| `pending` | Создан, ожидает инициализации |
| `check` | Ожидает оплаты от клиента |
| `paid` | Успешно оплачено |
| `underpaid` | Недоплачено |
| `overpaid` | Переплачено (зачислено) |
| `cancel` | Отменено / просрочено |
| `aml_lock` | Заблокировано AML-проверкой |
> ℹ️ Статусы `paid` и `overpaid` следует трактовать как успешную оплату.
#### 💱 Конвертация на балансе 2328.io
На сервисе 2328.io доступна конвертация между валютами на балансе **без комиссий**. Это удобно, если вы принимаете платежи в разных монетах, а хотите держать баланс, например, в USDT.
Автоконвертация также настраивается в параметрах проекта (раздел «Автоконвертация в USDT»).
#### 📈 Использование котировок 2328.io
Lara Script поддерживает провайдер котировок **2328.io** — актуальные курсы берутся напрямую с сервиса.
1. Перейдите: **Курсы валют → Котировки**
2. Нажмите **«Добавить»**
3. При создании формулы выберите источник котировки **2328.io**
4. Сохраните котировку
После этого котировку можно использовать:
* в формулах валют
* в формулах направлений обмена
➡️ Один и тот же сервис может одновременно передавать актуальные курсы, принимать платежи и выполнять автовыплаты.