> 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/help-center/ai-base/integracii-i-uvedomleniya/payments-notifications-reference.md). # Платежи, автовыплаты и уведомления Этот справочник объединяет приём оплаты, выплаты клиентам, журналы платежных шлюзов, Telegram Bot, центр уведомлений и email. ## Платёжные системы | Поле / настройка | Что означает | Как правильно заполнять | Рекомендация | | ---------------- | ------------------------ | ---------------------------------- | --------------------------------------- | | Название | Имя платёжной системы | Например Bitcoin, Tether, Сбербанк | Клиент должен понимать название | | Логотип | Иконка системы | Загрузите читаемую иконку | Влияет на список валют | | Статус | Использовать систему | Включайте рабочие системы | Выключенная система может скрыть валюты | | Сортировка | Порядок показа | Популярные выше | Удобно клиентам | | Описание | Дополнительное пояснение | Укажите особенности, если есть | Не вставляйте приватные данные | ## Мерчанты — приём оплаты | Поле / настройка | Что означает | Как правильно заполнять | Рекомендация | | ---------------------------- | --------------------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------- | | Название | Имя мерчанта в админке | Например “Crypto Pay основное” | Название должно отличать провайдеров | | Статус | Включен ли мерчант | Включайте после теста | Выключенный мерчант не выдаёт реквизиты | | Валюты | Какие валюты обслуживает мерчант | Выберите только поддерживаемые валюты | Валюта ещё должна быть связана в карточке валюты | | Поля подключения | Данные, которые выдает платежный провайдер | Заполняйте по инструкции провайдера | Значения секретов нельзя документировать | | Дополнительные опции | Поведение конкретного провайдера | Заполняйте по назначению | У разных провайдеров поля отличаются | | Инструкция оплаты | Что клиент увидит при оплате | Пишите просто и пошагово | Если пусто, может использоваться инструкция направления | | Комментарий | Внутренняя заметка | Укажите особенности провайдера | Не храните секреты в комментарии | | Допуск расхождения суммы | Насколько платёж может отличаться | Укажите по регламенту | Слишком большой допуск опасен | | Суточный объём | Сколько денег можно принять за день | По лимитам провайдера | При превышении мерчант станет недоступен | | Месячный объём | Сколько можно принять за месяц | По договору или риск-лимитам | Контролируйте лимиты | | Минимум на заявку | Минимальная сумма оплаты | По лимитам провайдера | Ниже лимита мерчант не подходит | | Максимум на заявку | Максимальная сумма оплаты | По лимитам провайдера | Выше лимита нужен другой мерчант | | Дневной лимит заявок | Количество заявок за день | `0` обычно без лимита | Защита от перегруза | | Месячный лимит заявок | Количество заявок за месяц | По регламенту | Не путать с суммой | | Кнопка мерчанта | Показывать кнопку оплаты | Включайте, если провайдер дает отдельную страницу оплаты | Если выключено, клиент может не увидеть переход | | Запрет IP | Блокировать определённые IP | Используйте при риске | Осторожно с общими IP | | Разрешённые IP | Принимать уведомления только с IP провайдера | Заполняйте по официальному списку | Неверный IP блокирует уведомления об оплате | | Сумма оплаты | Какую сумму передавать провайдеру | По настройке провайдера | Ошибка меняет сумму платежа | | Сумма зачисления | Как считать зачисленную сумму | По настройке провайдера | Влияет на статус оплаты | | Приоритет | Очередность выбора мерчанта | Чем выше приоритет, тем раньше выбирается | Проверяйте с правилами мерчантов | | Статус при малой сумме | Что делать, если клиент оплатил меньше | Выберите по регламенту | Может привести к отклонению или ручной проверке | | Статус при большой сумме | Что делать, если клиент оплатил больше | Выберите по регламенту | Нужна политика доплат/возвратов | | Защитный код уведомлений | Код, по которому система проверяет уведомления провайдера | Генерируется или заполняется в админке | Не документировать значение | | Адрес уведомлений провайдера | Адрес, куда провайдер отправляет статус оплаты | Передается провайдеру | Не добавляйте приватные адреса в документацию | | Безопасный просмотр секретов | Временный доступ к закрытым полям подключения | Используйте только для безопасной проверки | Не пересылайте секреты | ## Стратегии суммы мерчанта | Вариант | Что означает | Когда использовать | | ----------------------------- | ----------------------------------------- | ------------------------------------- | | Сумма с внешней комиссией | Клиент оплачивает сумму с учётом комиссии | Если провайдер берёт комиссию сверху | | Сумма с комиссией и процентом | Учитываются несколько типов комиссии | Если провайдер требует сложный расчёт | | Сумма без комиссии | Передаётся чистая сумма | Если комиссия уже учтена в курсе | ## Автовыплаты | Поле / настройка | Что означает | Как правильно заполнять | Рекомендация | | ---------------------------- | ---------------------------------------- | --------------------------------- | ------------------------------------------------ | | Название | Имя провайдера автовыплат | Например “USDT TRC20 выплаты” | Отличайте сеть и кошелек | | Статус | Включена ли автовыплата | Включайте после тестовой выплаты | Ошибка может привести к деньгам | | Валюты | Какие валюты можно выплачивать | Выберите поддерживаемые | Валюта ещё должна быть связана в карточке валюты | | Поля подключения | Данные подключения провайдера | Заполняйте в закрытой админке | Не документировать секреты | | Опции | Настройки провайдера автовыплат | По инструкции провайдера | У разных провайдеров разные поля | | Комментарий | Внутренняя заметка | Пишите особенности лимитов | Без секретов | | Допуск суммы | Допустимое расхождение | Используйте осторожно | Влияет на успешность выплаты | | Суточный объём выплат | Максимум суммы за день | По балансу и лимитам | Защита от потери средств | | Месячный объём выплат | Максимум за месяц | По фин. плану | Контроль рисков | | Минимум на заявку | Минимальная выплата | По провайдеру | Ниже нужна ручная обработка | | Максимум на заявку | Максимальная выплата | По провайдеру и риску | Крупные суммы лучше вручную | | Дневной лимит заявок | Количество выплат | По нагрузке | Не путать с объёмом | | Месячный лимит заявок | Количество выплат за месяц | По регламенту | При превышении автовыплата недоступна | | Разрешить автовыплату | Позволить автоматическую выплату | Да только после тестов | На старте лучше ручное подтверждение | | Тип суммы выплаты | Какую сумму отправлять | По требованиям провайдера | Ошибка меняет итог клиенту | | Ручная выплата заявки | Разрешить ручной запуск через провайдера | Включайте для операторов с правом | Нужны права и контроль | | Безопасный просмотр секретов | Доступ к секретам автовыплаты | Используйте только доверенным | Не пересылайте | ## Правила выбора мерчантов и выплат | Поле / настройка | Что означает | Как правильно заполнять | Рекомендация | | ---------------- | ------------------------------------------ | --------------------------------------------------- | --------------------------------- | | Направление | Для какой пары действует правило | Выберите точную пару `BTC - USDT` | Не путайте стороны | | Валюта | Для какой валюты правило | Выберите входную для мерчанта, выходную для выплаты | Сторона критична | | Провайдер | Какой мерчант или провайдер выплат выбрать | Выберите активного | Должен поддерживать валюту и сеть | | Диапазон суммы | На какие суммы действует | Укажите min/max | Диапазоны не должны конфликтовать | | Приоритет | Очередность правила | Важное правило выше | Конфликты решаются приоритетом | | Статус | Использовать правило | Включайте после теста | Выключенное правило игнорируется | ## Журналы платежных шлюзов и история оплаты | Лог / поле | Что означает | Как использовать | | ------------------------------- | --------------------------------------------------- | -------------------------------------------------------------------- | | Журнал приема оплаты | События по выдаче реквизитов и подтверждению оплаты | Если реквизиты не выдались или оплата не подтвердилась | | Журнал автовыплат | События по автоматическим выплатам | Если выплата не ушла или вернулась ошибка | | История оплаты | Полная цепочка событий по заявке | Для глубокой диагностики | | Данные, отправленные провайдеру | Сумма, валюта и номер заявки, переданные провайдеру | Сравнить с тем, что должно было уйти | | Ответ провайдера | Что провайдер сообщил системе | Найти ошибку или статус | | Код ответа провайдера | Условный результат ответа | Успех означает, что провайдер принял запрос; ошибка требует проверки | | Текст ошибки | Сообщение провайдера | Перевести в понятный ответ поддержке | | Время события | Когда произошло событие | Сравнить с действием клиента | | Настройки журналов | Изменения логирования | Проверить, включены ли нужные журналы | ## Email | Поле / настройка | Что означает | Как правильно заполнять | Рекомендация | | --------------------------- | ----------------------------------------------- | ------------------------------ | ---------------------------------------------------- | | SMTP / Resend | Как отправлять письма | Выберите один рабочий способ | После изменения отправьте тест | | SMTP-сервер | Адрес почтового сервера | По данным почтового сервиса | Не угадывайте | | Порт SMTP | Номер порта почтового сервера | 465, 587 или другой по сервису | Неверный порт ломает отправку | | Логин SMTP | Логин от почтового сервиса | Из сервиса | Не документировать | | Пароль SMTP | Пароль от почтового сервиса | Из сервиса | Не документировать | | Шифрование | Защита соединения с почтой | TLS/SSL по инструкции сервиса | Неверно — письма не уйдут | | Адрес отправителя | От кого письмо | support email обменника | Должен быть доверенным | | Имя отправителя | Имя отправителя письма | Название обменника | Клиент должен узнать бренд | | Email поддержки | Адрес для клиентов | Публичный support email | Не личная почта | | Email админов | Куда слать внутренние письма | Рабочие адреса команды | Не раскрывать в документации | | Центр уведомлений | Общая настройка уведомлений | Включайте для шаблонов | Нужно включить каналы | | Email-канал | Email-канал уведомлений | Да, если письма нужны | Без него шаблоны не уйдут по email | | События заявок | Письма по созданию, статусам, выплатам, отказам | Включайте нужные события | Не перегружайте клиента | | События входа | Успешный вход, новое устройство, lockout | Включайте для безопасности | Помогает выявлять взлом | | События верификации | Успех/отказ карты и KYC | Включайте при KYC | Текст должен быть понятным | | События для администраторов | Новая заявка, новая проверка, отзыв | Включайте для команды | Проверьте адреса админов | | Тестовая отправка | Проверяет настройки | Запускайте после изменений | Если тест не прошёл, другие письма тоже под вопросом | ## Telegram Bot и Telegram-уведомления | Поле / настройка | Что означает | Как правильно заполнять | Рекомендация | | --------------------- | ------------------------------ | ------------------------------------- | ------------------------------------- | | Название канала | Имя записи в админке | Например “Админы заявки” | Понятно для команды | | Токен Telegram-бота | Токен Telegram-бота | Вставляется только в закрытой админке | Нельзя документировать значение | | ID канала | ID чата или канала | Получите через проверку и привязку | Ошибка — сообщения не уйдут | | Название канала | Название канала | Для удобства | Не обязательно совпадает с ID | | Статус | Включить отправку | Включайте после проверки и привязки | Выключенный канал молчит | | Проверка | Диагностика канала | Проверяет доступность | Ничего не сохраняет | | Привязка | Привязка канала | Сохраняет найденный ID чата | Используйте после проверки | | Шаблон администратора | Сообщение для админов | Включайте важные события | Без лишних персональных данных | | Шаблон оператора | Сообщение для оператора | Для назначений и действий | Пишите коротко | | Шаблон клиента | Сообщение клиенту | Используйте осторожно | Telegram клиента должен быть известен | | Предпросмотр шаблона | Предпросмотр сообщения | Проверяйте перед сохранением | Уменьшает ошибки в тегах | | Теги шаблона | Переменные заявки/пользователя | Используйте только нужные | Не выводите секреты | ## Шаблоны уведомлений | Поле / настройка | Что означает | Как правильно заполнять | Рекомендация | | ---------------- | -------------------------------- | --------------------------- | ---------------------------- | | Тип шаблона | Событие уведомления | Выберите нужное событие | Например создание заявки | | Канал | Email, Telegram или другой канал | Настраивается по событию | Канал должен быть включён | | Тема | Заголовок письма | Коротко и понятно | Для email важно | | Тело сообщения | Основной текст | Пишите простым языком | Не добавляйте секреты | | Переменные | Подстановка данных | Используйте каталог тегов | Проверяйте предпросмотр | | Предпросмотр | Тестовый вид | Проверяйте перед включением | Ошибки шаблона видны заранее | ## Типовые ошибки | Ситуация | Причина | Что сделать | | ------------------------------- | -------------------------------------------------------------------------------- | ---------------------------------------------------- | | Клиент не получил реквизиты | Мерчант выключен, превышен лимит, не совпадает сеть или провайдер вернул ошибку | Проверить валюту, направление и журнал приема оплаты | | Уведомление об оплате не пришло | Неверный адрес уведомлений, защитный код, IP провайдера или провайдер недоступен | Проверить настройки мерчанта и журналы | | Автовыплата не ушла | Статус заявки, лимит, сеть, баланс или ошибка провайдера выплат | Проверить журнал автовыплат и статус | | Двойная выплата | Повторили выплату без проверки первой | Срочно проверить историю у провайдера и журналы | | Email не отправляется | Почтовый сервис, очередь или событие выключено | Тестовая отправка, очередь, настройки события | | Telegram молчит | Токен бота, ID канала, права бота, статус | Проверить привязку и права бота в канале | | Шаблон показывает пустые поля | Неверные теги или данных нет | Проверить предпросмотр и каталог тегов | | Уведомления приходят не туда | Неверный список email или канал Telegram | Проверить получателей | ## Безопасные рекомендации 1. Не включайте мерчант или автовыплату без теста. 2. Для автовыплат сначала используйте ручное подтверждение. 3. Не храните секреты в комментариях, шаблонах, документации и тикетах. 4. Для проблем платежного шлюза начинайте с номера заявки, затем смотрите историю оплаты. 5. Для уведомлений проверяйте не только шаблон, но и включение канала. --- # 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: ``` GET https://docs.iexexchanger.com/help-center/ai-base/integracii-i-uvedomleniya/payments-notifications-reference.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.