For the complete documentation index, see llms.txt. This page is also available as Markdown.

Экспорт курсов

Раздел «Экспорт курсов» используется для создания XML-файлов с курсами обменника.

Такие файлы обычно используются для:

  • мониторингов обменных пунктов;

  • партнёрских сервисов;

  • собственных интеграций;

  • внешних агрегаторов курсов;

  • автоматического обмена данными между системами.

После создания система автоматически формирует XML-файл, который можно передать стороннему сервису по прямой ссылке.

Откройте: «Настройки» — «Экспорт курсов»

В этом разделе можно создавать неограниченное количество экспортных файлов с разными настройками и наборами направлений.

Как работает экспорт курсов

Каждый экспорт представляет собой отдельный XML-файл.

Например, если создать файл с названием: rates

система автоматически сформирует: rates.xml

После генерации он будет доступен по ссылке:

Как сделать короткую ссылку на файл курсов?

Каждый файл может иметь собственные настройки:

  • формат файла;

  • список направлений;

  • правила округления;

  • комиссии;

  • ограничения по резервам;

  • доступность файла.


Создание нового файла

Для создания файла:

  1. Откройте раздел «Экспорт курсов».

  2. Нажмите «Добавить файл».

  3. Заполните основные параметры.

  4. Сохраните настройки.

1

Название файла

Название определяет имя XML-файла.

Примеры:

Используйте:

  • латинские буквы;

  • цифры;

  • символ _;

  • символ -.

Не используйте:

Расширение .xml система добавляет автоматически.

2

Тип файла

Доступны два варианта.

XML

Стандартный XML-файл.

Подходит для:

  • партнёров;

  • собственных интеграций;

  • агрегаторов;

  • сторонних сервисов.

BestChange XML

Файл формируется по формату BestChange.

Используйте этот вариант, если файл предназначен для мониторинга BestChange.

3

Доступность файла

Определяет, как файл будет доступен пользователям.

Всем

Файл отображается в публичном списке экспортов.

Подходит для файлов, которые должны быть доступны всем партнёрам или сервисам.

Только по ссылке

Файл не отображается в публичном списке.

Получить его можно только по прямой ссылке.

4

Статус

Определяет, участвует ли файл в автоматическом обновлении.

Включено

Файл автоматически обновляется системой.

Выключено

Файл сохраняется в системе, но больше не обновляется.

5

Описание файла

Поле «Описание» используется для пояснения назначения файла.

Например: Файл для мониторинга курсов

Если файл доступен всем, описание может отображаться рядом со ссылкой.


Настройки расчёта курсов

1

Учитывать правила верификации карты

Если включено, система учитывает правила верификации карты при расчёте курсов.

Рекомендуется оставить включённым, если в обменнике используются направления с обязательной проверкой карт.

2

Скрывать направление при недостаточном резерве

Настройка: «Скрывать направление, если резерв меньше минимальной суммы обмена»

Если включена, направление не попадёт в XML, когда доступного резерва недостаточно для создания заявки.

Пример:

Параметр
Значение

Минимальная сумма обмена

100 USDT

Резерв

50 USDT

Такое направление будет исключено из файла.


Знаки после запятой

Определяет, как округлять значения курсов и сумм.

Доступны два режима.

1

От настроек валюты

Система использует количество знаков после запятой из настроек валюты.

Это рекомендуемый режим.

2

Принудительно

Администратор сам задаёт количество знаков после запятой.

Например: 2

Тогда все значения будут выводиться с двумя знаками после запятой.

Используйте только если внешний сервис требует конкретный формат.

Комиссии в XML

1

fromfee

Определяет комиссию по стороне «Отдаю».

Можно выбрать:

  • дополнительную комиссию обменника;

  • комиссию платёжной системы.

2

tofee

Определяет комиссию по стороне «Получаю».

Можно выбрать:

  • дополнительную комиссию обменника;

  • комиссию платёжной системы.


Ручные направления

Настройка: «Разрешить отключить ручные направления, когда оператор не в сети»

Если включена, система может автоматически скрывать ручные направления из файла курсов, когда оператор находится офлайн.

Это удобно для:

  • наличных обменов;

  • ручных переводов;

  • направлений с ручной обработкой;

  • направлений с выдачей реквизитов оператором.

Исключённые направления

В настройках файла можно выбрать направления, которые не должны попадать в экспорт.

Это полезно, если нужно создать отдельный файл:

  • только для криптовалют;

  • только для мониторинга;

  • без наличных направлений;

  • без направлений с низкой маржой.

Исключение действует только для текущего файла.

Какие направления попадают в экспорт

Направление будет включено в XML, если:

  • направление активно;

  • обе валюты направления активны;

  • курс больше нуля;

  • направление не находится в списке исключений;

  • экспорт разрешён в настройках направления;

  • направление прошло все правила публикации;

  • хватает резерва, если включена проверка резервов.

Настройки экспорта в направлении

На каждое направление дополнительно влияет его собственная настройка экспорта.

Откройте нужное направление и перейдите в раздел: «Экспорт»

Там доступен параметр: «Добавить направление в файл курсов»

Варианты:

Значение
Описание

Да

Направление участвует в экспорте

Да, только по расписанию

Направление попадает в XML только в определённое время

Нет

Направление полностью исключается из файлов курсов

Автоматическое обновление файлов

Файлы курсов обновляются автоматически через систему планировщика задач.

После изменения настроек может потребоваться некоторое время, пока система сформирует новый XML-файл.

Если файл не обновляется, проверьте:

  • включён ли экспорт;

  • включено ли автоматическое обновление файлов курсов;

  • есть ли активные направления;

  • нет ли ошибок в курсах.

Рекомендуемая настройка

Для большинства обменников подходит следующий вариант:

Параметр
Значение

Тип файла

XML

Доступность

Только по ссылке

Статус

Включено

Знаки после запятой

От настроек валют

Проверка резервов

Включена

Учитывать верификацию карты

Включено

Для BestChange рекомендуется создать отдельный файл с типом: BestChange XML

Частые проблемы

Файл не появился

Проверьте:

  • файл включён;

  • указано корректное название;

  • есть активные направления;

  • система успела выполнить обновление.

Направление отсутствует в XML

Проверьте:

  • направление активно;

  • курс больше нуля;

  • хватает резерва;

  • экспорт разрешён в настройках направления;

  • направление не находится в исключениях.

XML пустой

Обычно это означает, что ни одно направление не прошло условия публикации.

Проверьте статусы направлений, валют, курсов и резервов.


Коротко

Раздел «Экспорт курсов» позволяет формировать XML-файлы с курсами обменника для мониторингов, партнёров и внешних сервисов. Для каждого файла можно настроить формат, список направлений, комиссии, правила публикации и доступность, а система будет автоматически поддерживать данные в актуальном состоянии.

Последнее обновление

Это было полезно?