> 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/partnery-eksport-i-chat/partners-referrals-export-chat.md). # Партнеры, экспорт и чат заявки Этот раздел описывает связанные функции, которые часто участвуют в вопросах клиентов и поддержки: партнерская программа, реферальные логи, партнерские баннеры, экспорт курсов и данных, чат в заявке и общий центр чатов. ## Для чего нужен раздел Раздел нужен, чтобы GitBook AI мог отвечать не только “где включить партнерку”, но и “почему бонус не начислился”, “почему направление не попало в XML”, “почему ручная пара скрылась из файла курсов”, “как оператору запросить чек в чате”, “как закрыть чат для клиента”. ## Когда использовать | Ситуация | Что открыть | Что проверить | | ------------------------------------------- | ------------------------------- | ------------------------------------------------------------ | | Партнер не получил бонус | Партнеры, реферальные логи | Программа, процент, тип начисления, заявка, trace | | Клиент не привязался к партнеру | Реферальная программа и cookie | Включена ли партнерка, срок cookie, событие client\_attached | | Партнер не может запросить выплату | Настройки партнерской системы | Минимальная выплата и баланс | | Нужно добавить баннер партнера | Partner banners | Название, ссылка, логотип, локали | | Мониторинг не видит XML | Export rates | Статус файла, доступность, исключенные направления | | Направление пропало из XML | Export rates и статус оператора | Offline operator, резерв, исключения, ручной режим | | Нужно выгрузить данные из админки | Export data | Тип выгрузки, период, права доступа | | Клиент прислал чек или спорит по реквизитам | Чат заявки | Сообщения, файлы, запрос полей, история клиента | | В чатах много непрочитанных | Order chats center | Фильтр, поиск, отметить прочитанным | ## Основные возможности | Возможность | Что означает простыми словами | Когда использовать | | ------------------------------ | ---------------------------------------------------- | ------------------------------------------------ | | Включить реферальную программу | Разрешить начислять партнерам бонусы | При запуске партнерки | | Программа по умолчанию | Какой процент назначать новым партнерам | Чтобы новые партнеры не оставались без программы | | Тип вознаграждения | От чего считать бонус: суммы обмена или прибыли | Чтобы управлять экономикой партнерки | | Срок жизни cookie | Как долго клиент помнит партнера | Для правил атрибуции | | Реферальные логи | История событий партнерки | При споре по начислению | | Партнерские баннеры | Логотипы и ссылки партнеров | Для публичного блока партнеров | | Экспорт курсов | XML или BestChange XML файл | Для мониторингов и партнеров | | Доступность файла | Всем или только по ссылке | Для публичного или закрытого экспорта | | Исключенные направления | Пары, которые не попадут в экспорт | Если пару нельзя отдавать мониторингу | | Export data | Выгрузка данных из админки | Для отчетов и аудита | | Чат заявки | Переписка клиента и оператора по заявке | При оплате, чеке, уточнении реквизитов | | Закрыть чат | Запретить клиенту писать дальше | После завершения спора или злоупотребления | | Запретить файлы | Запретить клиенту прикреплять файлы | Если клиент отправляет мусор или опасные файлы | | Запросить поля | Попросить клиента заполнить структурированные данные | Для чека, TXID, банка, суммы, комментария | ## Настройки партнерской системы ### Для чего нужны Настройки партнерской системы определяют, работает ли партнерка, как начислять бонус, сколько хранить реферальную привязку и когда партнер может запросить выплату. ### Поля и настройки | Поле / настройка | Что означает | Как правильно заполнять | Важно знать | | ------------------------------ | ---------------------------------------------- | ----------------------------------------- | ------------------------------------------------ | | Минимальная выплата | С какой суммы партнер может вывести бонус | Укажите сумму по регламенту | Слишком высокая сумма вызывает вопросы партнеров | | Включить реферальную программу | Разрешить начисления | Да — если партнерка должна работать | Нет — новые бонусы не начисляются | | Программа по умолчанию | Какая программа назначается новым партнерам | Выберите активную программу | Без нее партнер может остаться без процента | | Лог действий | Записывать события бонусной системы | Да — для нормальной диагностики | Если выключить, сложнее разбирать споры | | Тип вознаграждений | От суммы обмена или от прибыли обменника | Выберите бизнес-модель | От суммы проще, от прибыли точнее для экономики | | Срок жизни реферала | Как долго хранится привязка клиента к партнеру | Без ограничения или ограничить по времени | Влияет на будущие начисления | | Время жизни cookie в днях | Сколько дней работает cookie | Например 90, 365, 1825 | Работает только при ограничении по времени | ### Типы вознаграждений | Тип | Что означает | Когда использовать | | -------------------- | ------------------------------------------ | ---------------------------------------------------- | | От суммы обмена | Партнер получает процент от суммы операции | Когда нужна простая и понятная схема | | От прибыли обменника | Партнер получает процент от чистой прибыли | Когда важно учитывать комиссии и расходы направления | ### Как настроить партнерку 1. Создайте хотя бы одну реферальную программу. 2. Укажите процент партнера. 3. Включите реферальную программу. 4. Выберите программу по умолчанию. 5. Укажите минимальную выплату. 6. Выберите тип начисления: от суммы обмена или от прибыли. 7. Включите лог действий. 8. Настройте срок cookie. 9. Сделайте тестовую регистрацию по реферальной ссылке. 10. Создайте тестовую заявку и проверьте лог начисления. ### Типовые ошибки | Ошибка / ситуация | Причина | Что сделать | | ------------------------ | ------------------------------------------------------ | ------------------------------------------------- | | Бонус не начислился | Партнерка выключена, нет программы, заявка не подходит | Проверить настройки и реферальные логи | | Бонус равен 0 | Процент 0, нет прибыли, условия не выполнены | Проверить программу, тип начисления и направление | | Клиент не привязался | Cookie истек или ссылка не применена | Проверить срок cookie и событие client\_attached | | Партнер не видит выплату | Не достигнута минимальная сумма вывода бонусов | Проверить баланс и минимальную сумму выплаты | ## Реферальные программы ### Поля программы | Поле / настройка | Что означает | Как правильно заполнять | Важно знать | | ----------------------- | --------------------------------------------------- | --------------------------------- | -------------------------------------------------- | | Название программы | Имя программы по языкам | “Базовая 2%”, “VIP” | Основной язык обязателен | | Описание | Объяснение условий | Пишите простым языком | Может быть видно партнеру | | Процент партнера | Сколько начислять | Укажите число, например 2 или 0.6 | Не добавляйте знак процента, если форма ждет число | | Срок действия в минутах | Сколько действует привязка или cookie для программы | Можно оставить пустым | Есть быстрые пресеты 5 месяцев, 1 год, 3 года | ### Рекомендации | Цель | Рекомендация | | ----------------------- | ---------------------------------------------- | | Простая партнерка | Одна программа по умолчанию и понятный процент | | Разные уровни партнеров | Несколько программ с понятными названиями | | Временная акция | Отдельная программа с ограниченным сроком | | Снижение споров | Подробное описание условий и включенные логи | ## Реферальные логи ### Для чего нужны Реферальные логи показывают, что происходило с партнерской системой: регистрация, привязка клиента, начисление бонуса, отказ в начислении, дубль, сторно или предварительный расчет. ### Фильтры | Фильтр | Что означает | Как использовать | | ------------------- | --------------------------- | ------------------------------------------------------ | | Search | Поиск по тексту или событию | Введите часть сообщения | | Event | Тип события | Выберите начисление, привязку, регистрацию и другое | | Level | Уровень события | Info, warning, error | | Partner ID | ID партнера | Используйте при споре конкретного партнера | | Client ID | ID клиента | Используйте при споре по клиенту | | Task ID | ID заявки | Основной фильтр для спора по начислению | | Trace ID | Технический ID цепочки | Используйте, если событие прошло через несколько шагов | | Date from / Date to | Период | Ограничьте дату, чтобы не смотреть весь журнал | ### События | Событие | Что означает | Что делать при вопросе | | ------------------ | ------------------------------ | ------------------------------------------------- | | register\_start | Началась регистрация | Проверить, дошел ли клиент до завершения | | register\_finish | Регистрация завершена | Проверить привязку к партнеру | | client\_attached | Клиент стал рефералом | Значит ссылка или cookie сработали | | credit\_success | Бонус начислен | Проверить сумму, процент и заявку | | credit\_ineligible | Начисление недоступно | Смотреть условия и причину в сообщении | | credit\_duplicate | Повторное начисление пропущено | Обычно защита от дубля | | credit\_zero | Бонус получился 0 | Проверить процент, прибыль и сумму | | hold\_settled | HOLD снят, бонус стал доступен | Можно объяснить партнеру, что бонус разблокирован | | credit\_reversed | Бонус отменен | Проверить причину сторно | | preview | Предварительный расчет | Не является реальным начислением | | balance\_created | Создан баланс партнера | Нормальное служебное событие | | program\_assigned | Назначена программа | Проверить, какая программа назначена | ### Аналитика логов | Показатель | Что означает | Как использовать | | ------------- | ----------------------------------- | ----------------------------------- | | Всего событий | Общее количество записей | Оценить активность | | За сегодня | События за текущий день | Проверка свежих проблем | | За 7 дней | Недельная динамика | Найти повторяющуюся ошибку | | За 30 дней | Месячная динамика | Оценить стабильность партнерки | | Топ событий | Какие события чаще всего происходят | Если много ошибок, смотреть условия | | По уровню | Info, warning, error | Ошибки требуют проверки | ## Партнерские условия и баннеры ### Информация для партнеров | Поле | Что означает | Как заполнять | Важно знать | | --------------------- | ---------------------------- | --------------------------------------------------- | ------------------------------------------- | | Реферальная программа | Текст условий партнерки | Пишите понятно: как считается бонус, когда доступен | Не обещайте то, чего нет в настройках | | Скидки | Описание скидок или cashback | Укажите реальные условия | Текст должен совпадать с настройками скидок | | Мониторингам | Текст для мониторингов | Объясните правила сотрудничества | Не добавляйте приватные контакты | ### Партнерские баннеры | Поле | Что означает | Как заполнять | Важно знать | | -------------- | --------------------------- | ------------------------------ | -------------------------------------- | | Название | Название партнера по языкам | Основной язык обязателен | Должно быть понятно на публичном сайте | | Ссылка на сайт | URL партнера | Только http или https | Для основного языка ссылка обязательна | | Логотип | Изображение партнера | Загрузите качественный логотип | Не используйте тяжелые файлы | | Сортировка | Порядок баннеров | Перетащите строку в списке | Важные партнеры выше | ### Типовые ошибки | Ошибка / ситуация | Причина | Что сделать | | ----------------------- | ----------------------------------------- | --------------------------------------------- | | Баннер не сохраняется | Нет названия или ссылки на основном языке | Заполнить обязательные поля | | Ссылка некорректна | Не http/https или пустая ссылка | Исправить URL | | Логотип не отображается | Файл не загружен или удален | Загрузить заново через медиа/поле изображения | ## Экспорт курсов ### Для чего нужен Экспорт курсов создает XML или BestChange XML файл с направлениями обмена. Его используют мониторинги, партнеры, внешние сервисы и иногда владельцы обменника для проверки доступных пар. ### Поля создания файла | Поле / настройка | Что означает | Как правильно заполнять | Важно знать | | ----------------- | ---------------------------- | -------------------------------- | ------------------------------------------------------------- | | Название файла | Имя экспортного файла | Коротко, латиницей, без секретов | Не используйте приватные названия | | Тип файла | Формат | XML или BestChange XML | BestChange XML должен соответствовать требованиям мониторинга | | Доступность файла | Кто может открыть | Всем или только по ссылке | “Только по ссылке” не заменяет секретную защиту | | Статус | Генерировать и отдавать файл | Да — если файл должен работать | Выключенный файл не должен быть доступен как активный экспорт | ### Поля редактирования файла | Поле / настройка | Что означает | Как правильно заполнять | Важно знать | | ---------------------------------------------------------------- | ------------------------------------------ | ------------------------------------------------------ | --------------------------------------------------------------- | | Описание | Краткое описание файла по языкам | Пишите назначение файла | Не добавляйте приватные URL | | Учитывать правила верификации карты | Влияют ли KYC/card rules на расчет курса | Да — если мониторинг должен видеть реальные условия | Если Нет, файл может показывать курс, недоступный клиенту | | Скрывать направление, если резерв меньше минимальной суммы | Убирать пару из экспорта при малом резерве | Да — чтобы не принимать невозможные обмены | Если Нет, мониторинг может видеть пару без достаточного резерва | | Тип отображения знаков после запятой | Откуда брать округление | От настроек валюты или принудительно | Принудительное округление может менять вид курса | | Количество знаков после запятой | Сколько знаков показывать | Заполняйте только при принудительном режиме | Неверное число портит формат файла | | Параметр для fromfee | Как передавать комиссию стороны “Отдаю” | Дополнительная комиссия или комиссия платежной системы | Должно соответствовать ожиданию мониторинга | | Параметр для tofee | Как передавать комиссию стороны “Получаю” | Дополнительная комиссия или комиссия платежной системы | Ошибка даст неверную комиссию | | Разрешить отключить ручные направления, когда оператор не в сети | Скрывать ручные пары, если оператор офлайн | Да — если ручной обмен без оператора невозможен | Связано со статусом оператора | | Исключенные направления | Пары, которые не попадут в файл | Выберите пары вручную | Используйте для временно проблемных направлений | ### Как проверить экспорт 1. Откройте список export rates. 2. Убедитесь, что файл включен. 3. Проверьте тип файла. 4. Проверьте доступность: всем или только по ссылке. 5. Откройте настройки файла. 6. Проверьте исключенные направления. 7. Проверьте настройки резерва и статуса оператора. 8. Если мониторинг жалуется, сравните пару в админке и в XML. ### Типовые ошибки | Ошибка / ситуация | Причина | Что сделать | | ---------------------------------- | ------------------------------------------------------------ | ------------------------------------------------- | | XML пустой | Все направления выключены, исключены или нет резерва | Проверить статус направлений, резерв и исключения | | Пары нет в BestChange XML | Тип файла не BestChange XML или пара исключена | Проверить type\_file и excluded directions | | Мониторинг видит неверную комиссию | Неверно выбран fromfee/tofee | Сверить комиссии направления и параметры экспорта | | Ручная пара пропала | Оператор оффлайн и включено скрытие ручных направлений | Проверить статус оператора | | Курс отличается от сайта | В экспорт включены другие правила округления или верификации | Проверить number format и card verification rules | ## Export data ### Для чего нужен Export data — это инструмент выгрузки данных из админки. Он нужен для отчетов, аудита и передачи информации владельцу или бухгалтерии. ### Рекомендации | Правило | Почему важно | | ------------------------------------------- | ------------------------------------------------- | | Выгружайте только нужный период | Меньше риск утечки и проще анализ | | Давайте доступ только доверенным ролям | Выгрузки могут содержать чувствительные данные | | Не храните файлы в публичных местах | В них могут быть заявки, email, суммы и реквизиты | | Не добавляйте реальные выгрузки в GitBook | Это приватные данные клиентов | | После выгрузки проверьте, кто запросил файл | Это важно для аудита | ## Чат заявки ### Для чего нужен Чат заявки позволяет оператору и клиенту обсуждать конкретную заявку: оплату, чек, TXID, ошибку реквизитов, возврат или уточнение данных. Чат хранится в карточке заявки и доступен в общем центре чатов. ### Состояния и настройки | Поле / настройка | Что означает | Как правильно использовать | Важно знать | | ----------------------- | ------------------------------------ | --------------------------------------------------- | ----------------------------------------------- | | Чат включен | Включен ли чат заявок глобально | Проверяйте в настройках онлайн-чата | Если выключен, чат не работает | | Chat state `is_blocked` | Чат закрыт для клиента | Закрывайте после завершения спора | История остается в админке | | Files enabled | Разрешены ли файлы глобально | Включайте, если нужны чеки | Файлы должны быть безопасных форматов | | Files blocked | Файлы запрещены только в этой заявке | Используйте при злоупотреблении | Не отключает текстовые сообщения | | Allowed file extensions | Какие файлы можно отправлять | PNG, JPG, JPEG, PDF | Нельзя разрешать произвольные опасные форматы | | Max file size MB | Максимальный размер файла | Обычно до 10 МБ, технический максимум до 50 МБ | Большие файлы грузятся медленно | | Индикатор печати | Показывать “печатает” | Используйте для живого чата | Требует настроек обновления в реальном времени | | Quick replies | Быстрые ответы оператора | Подставляют текст в поле, не отправляют сразу | Оператор должен проверить текст перед отправкой | | Активный запрос данных | Активный запрос данных у клиента | Используйте для структурированного сбора информации | Пока запрос активен, клиент видит форму | | Customer context | Данные клиента и последние заявки | Смотрите при повторных проблемах | Не отправляйте эти данные другим клиентам | ### Действия оператора | Действие | Что означает | Когда использовать | Важно знать | | ------------------------------ | ---------------------------- | ---------------------------------------------- | ------------------------------------------------ | | Отправить сообщение | Написать клиенту в чат | Для уточнения оплаты или реквизитов | Пишите коротко и конкретно | | Закрыть для клиента | Запретить новые сообщения | После решения вопроса или злоупотребления | Клиент больше не сможет писать | | Открыть чат | Снова разрешить сообщения | Если вопрос возобновился | Проверьте причину открытия | | Запретить файлы клиенту | Запретить прикрепления | Если клиент отправляет мусор или опасные файлы | Текстовый чат остается | | Разрешить файлы клиенту | Вернуть прикрепления | Если снова нужен чек или документ | Следите за лимитами файлов | | Запросить поля у клиента | Попросить заполнить форму | Для TXID, суммы, банка, комментария | Укажите понятные label и placeholder | | Отменить запрос полей | Убрать активный запрос | Если запрос ошибочный или больше не нужен | Клиент снова работает без этой формы | | Отметить чат прочитанным | Убрать непрочитанный счетчик | После обработки сообщений | Не удаляет переписку | | Отметить все чаты прочитанными | Массово убрать счетчики | В конце смены, если все обработано | Не используйте, если есть необработанные вопросы | ### Поля запроса данных у клиента | Поле | Что означает | Как заполнять | Важно знать | | ----------- | -------------------- | ------------------------------------------ | --------------------------------------------- | | Title | Заголовок запроса | “Уточните данные платежа” | Клиент должен понимать цель | | Fields | Список полей | От 1 до 8 полей | Не перегружайте клиента | | Label | Название поля | “TXID”, “Банк отправителя”, “Сумма оплаты” | Обязательное поле в настройке | | Type | Тип поля | Text, textarea или number | Number только для чисел | | Required | Обязательное ли поле | Да — если без него нельзя проверить оплату | Не делайте все поля обязательными без причины | | Placeholder | Подсказка | “Введите TXID из кошелька” | Не используйте реальные данные | ### Центр чатов заявок | Поле / действие | Что означает | Когда использовать | | ---------------- | ---------------------------------- | ------------------------------------------- | | Список чатов | Последние чаты по заявкам | Для работы оператора со всеми сообщениями | | Search value | Поиск по ID заявки или public ID | Когда клиент назвал номер заявки | | Unread count | Количество непрочитанных сообщений | Сначала обрабатывайте чаты с непрочитанными | | Last message | Последнее сообщение | Быстро понять суть | | Customer context | Клиент и до 20 последних заявок | Для повторных проблем | | All read by ID | Отметить один чат прочитанным | После обработки заявки | | All read chats | Отметить все чаты прочитанными | Только когда все реально обработано | ### Типовые ошибки | Ошибка / ситуация | Причина | Что сделать | | --------------------------------- | ---------------------------------------------------- | -------------------------------------------------- | | Клиент не может написать | Чат закрыт или глобально выключен | Проверить chat enabled и is\_blocked | | Клиент не может отправить чек | Файлы выключены глобально или заблокированы в заявке | Проверить files enabled и files blocked | | Файл не прикрепляется | Неверный формат или размер | Попросить PNG, JPG, JPEG или PDF в пределах лимита | | Оператор не видит новые сообщения | Realtime или очередь не работает | Обновить страницу, проверить уведомления и очередь | | Клиент заполнил не те данные | Плохой label или placeholder | Создать новый понятный запрос полей | ## Важные предупреждения Не обещайте партнеру начисление, пока не проверены реферальные логи и статус заявки. Бонус может быть недоступен из-за условий, дубля, нулевой прибыли или сторно. Не публикуйте экспортные ссылки с приватной доступностью в открытых местах. Даже “только по ссылке” не означает полноценную защиту секретом. Не включайте направления в XML, если по ним нет резерва, оператор оффлайн или реквизиты не готовы. Не отправляйте в чат персональные данные другого клиента. Чат заявки относится только к конкретному клиенту и конкретной заявке. Не разрешайте опасные типы файлов в чате. Безопасный набор — изображения и PDF, если это соответствует настройкам проекта. ## Связанные разделы | Раздел | Почему связан | | ----------------------------------------- | --------------------------------------------------------------------- | | Заявки | Заявки, статусы и действия оператора | | Пользователи | Пользователи, партнерская привязка и балансы | | Справочник системных настроек | Online chat, уведомления и системные настройки | | Источники курсов, формулы и резервы | Курсы, резервы и экспорт | | Операции, статусы и действия оператора | Карточка заявки и чат | | Справочник пользователей, ролей и доступа | Партнеры, скидки, роли и доступ | | Служебные инструменты админки | Файловый менеджер, обновления в реальном времени и служебные действия | --- # 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/partnery-eksport-i-chat/partners-referrals-export-chat.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.