> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/guide/integracii/merchanty-i-api/merchanty/2328.io.md).
# 2328.io
{% hint style="success" %}
Для обсуждения условий работы свяжитесь с [представителем сервиса](https://t.me/Partners2328).
{% endhint %}
{% hint style="info" %}
Перед включением мерчанта в рабочем направлении обязательно выполните тестовую оплату на небольшую сумму.
Если неправильно указать API-ключ или сеть, адрес для оплаты может не создаться, а автоматическая обработка платежей работать не будет.
{% endhint %}
2328.io — криптовалютный платёжный сервис, который позволяет автоматически принимать криптовалюту от клиентов.
После подключения iEXExchanger самостоятельно создаёт адрес для оплаты, отслеживает поступление средств и автоматически переводит заявку в следующий статус после подтверждения платежа.
Модуль поддерживает:
* создание статических адресов для оплаты;
* автоматическую проверку поступлений;
* webhook-уведомления;
* ручную и автоматическую проверку платежей;
* работу с несколькими блокчейн-сетями.
## Что нужно подготовить
Перед настройкой подготовьте следующие данные из кабинета 2328.io:
```
Project UUID
API key
```
Для приёма криптовалюты используется обычный API key.
Не используйте `Payout API key`, так как он предназначен только для автоматических выплат.
***
## Регистрация в 2328.io
Перейдите на официальный сайт: [https://2328.io](https://2328.io/)
Создайте аккаунт или войдите в существующий.
После входа:
1. Создайте новый проект.
2. Откройте настройки проекта.
3. Скопируйте `Project UUID`.
4. Скопируйте обычный `API key`.
Сохраните эти данные в безопасном месте и не передавайте их третьим лицам.
***
## Что такое статический кошелёк
2328.io использует статические кошельки.
Когда клиент создаёт заявку, iEXExchanger автоматически обращается к API 2328.io и получает адрес для оплаты.
После этого клиент переводит средства на полученный адрес, а система автоматически проверяет поступление средств и обновляет статус заявки.
Создавать адреса вручную не требуется.
***
Для добавления мерчанта откройте: **«Мерчанты и API» — «Список мерчантов»**
Нажмите: **Добавить**
В списке модулей выберите: **2328.io**
## Настройка мерчанта
{% stepper %}
{% step %}
### Project UUID
Укажите идентификатор проекта из кабинета 2328.io.
Пример:
```
019dff1f-0dbd-7277-8d45-271e7775388f
```
Поле обязательно для заполнения.
{% endstep %}
{% step %}
### API key
Укажите обычный API-ключ проекта.
Он используется для:
* создания адресов оплаты;
* проверки поступления средств;
* проверки подписи webhook.
Используйте только обычный `API key`.
Не вставляйте сюда `Payout API key`.
{% endstep %}
{% step %}
### User-Agent
Необязательное поле.
Если оставить его пустым, iEXExchanger автоматически отправит стандартный User-Agent.
Заполняйте это поле только в том случае, если это рекомендует техническая поддержка 2328.io.
{% endstep %}
{% step %}
### Invite code
Необязательное поле.
Используется как реферальный код при создании статических кошельков.
Если у вас нет Invite code, оставьте поле пустым.
{% endstep %}
{% step %}
### Код валюты/сети
Укажите код сети, который используется в 2328.io.
Например:
```
TRX-TRC20
ETH-ERC20
BSC-BEP20
BTC
TON
SOL
```
Для USDT TRC20 необходимо указать:
```
TRX-TRC20
```
Для USDT ERC20:
```
ETH-ERC20
```
Сеть должна полностью совпадать с сетью используемой валюты в iEXExchanger.
{% endstep %}
{% step %}
### Макс. время регистрации в блокчейне
Поле задаётся в минутах.
Рекомендуемое значение: **30**
В течение этого времени система ожидает регистрацию транзакции в блокчейне.
{% endstep %}
{% step %}
### Макс. время получения первого подтверждения
Поле задаётся в часах.
Рекомендуемое значение: **2**
{% endstep %}
{% endstepper %}
***
## Привязка мерчанта к валюте
После сохранения мерчанта его необходимо назначить нужной валюте.
Откройте: **«Основное» — «Валюты» — «Список валют»**
{% content-ref url="/pages/4kZXCpudXybY4zkSCKhx" %}
[Управление валютами](/guide/obmen/valyuty/upravlenie-valyutami.md)
{% endcontent-ref %}
Выберите необходимую валюту и перейдите в раздел автоматизации.
В качестве мерчанта выберите: **2328.io**
Убедитесь, что выбранная сеть соответствует сети, указанной в настройках мерчанта.
{% content-ref url="/pages/zEyPL7CgzEo11hFHLWrh" %}
[Автоматизация валют с разными сетями](/guide/integracii/merchanty-i-api/avtomatizaciya-valyut-s-raznymi-setyami.md)
{% endcontent-ref %}
Например:
```
Валюта: USDT
Сеть: TRX-TRC20
Мерчант: 2328.io
```
***
## Как работает приём платежей
После создания заявки iEXExchanger автоматически отправляет запрос в API 2328.io.
2328.io создаёт статический адрес и возвращает его системе.
Клиент переводит средства на полученный адрес.
После поступления средств сервис отправляет webhook или система самостоятельно проверяет платёж через API.
Когда платёж подтверждён, заявка автоматически переводится в следующий статус.
Для расчёта фактически поступившей суммы используется значение:
```
merchant_amount
```
Оно уже учитывает комиссию сервиса.
## Webhook
При создании адреса оплаты iEXExchanger автоматически передаёт callback URL.
Дополнительная настройка webhook в большинстве случаев не требуется.
Если сервис просит указать разрешённый домен, используйте Backend-домен:
```
https://app.ваш_домен
```
Все входящие webhook автоматически проверяются по HMAC-SHA256.
Если подпись не совпадает, уведомление будет отклонено.
## Что проверить перед запуском
Перед использованием мерчанта убедитесь, что:
* Project UUID заполнен правильно;
* используется обычный API key;
* сеть указана без ошибок;
* Backend доступен по HTTPS;
* мерчант привязан к нужной валюте или направлению;
* включено логирование запросов во время тестирования.
## Проверка работы
После настройки рекомендуется выполнить тестовый платёж.
Порядок проверки:
1. Создайте тестовую заявку.
2. Убедитесь, что появился адрес оплаты.
3. Отправьте небольшую сумму.
4. Дождитесь обработки платежа.
5. Проверьте изменение статуса заявки.
6. Проверьте журнал запросов.
Лог запросов находится в разделе: **«Журнал событий» — «Мерчанты и API» — «Лог запросов мерчантов»**
***
## Рекомендации
Используйте отдельный проект 2328.io для каждого обменного пункта.
Не публикуйте API-ключи в переписках и на скриншотах.
Перед включением мерчанта в рабочих направлениях всегда выполняйте тестовую оплату.
После успешной проверки можно отключить расширенное логирование запросов.
***
## Коротко
Для подключения приёма криптовалюты через 2328.io необходимо:
1. Зарегистрироваться в 2328.io.
2. Создать проект.
3. Получить `Project UUID` и обычный `API key`.
4. Добавить мерчант `2328.io` в iEXExchanger.
5. Заполнить все обязательные поля.
6. Указать правильный код сети.
7. Привязать мерчант к валюте или направлению.
8. Выполнить тестовую оплату.
9. Убедиться, что заявка автоматически изменила статус после поступления средств.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.iexexchanger.com/guide/integracii/merchanty-i-api/merchanty/2328.io.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.