Формат экспортного файла курсов
На данной странице приведено описание стандарта для формирования экспортного файла курсов, поддерживаемого мониторингом обменных пунктов BestChange.ru. Пример содержимого подобного файла можно увидеть ниже.
Основные правила:
- Экспортный файл формируется в XML-формате;
- Каждая запись идет с новой строки. Перенос осуществляется символом \n;
- Для числовых значений разделителем целой части является точка;
- Корневой элемент – <rates>;
- Каждое направление обмена описывается в элементе <item>;
- Элементы для описания каждого направления обмена:
- <from> – код валюты, которую обменный пункт принимает от клиента. Коды электронных валют приведены в списке ниже;
- <to> – код валюты, которую обменный пункт отправляет клиенту. Коды электронных валют приведены в списке ниже;
- <in> – сколько валюты from должен отдать клиент;
- <out> – сколько валюты to получит клиент;
- <amount> – размер резерва валюты to в обменнике;
- <minfee> – минимальная комиссия, которую взимает обменный пункт в текущем направлении обмена. Указывается с кодом национальной валюты.
Пример: <minfee>5 USD</minfee>; - <fromfee> – дополнительная комиссия, не входящая в курс обмена и взимаемая с суммы, которую клиент переводит в обменный пункт. Указывается с кодом национальной валюты.
Пример: <fromfee>2.15 EUR</fromfee>
Вместо кода нац. валюты возможно также использование знака % для обозначения процентной дополнительной комиссии; - <tofee> – дополнительная комиссия, не входящая в курс обмена и взимаемая с суммы, которую обменный пункт переводит клиенту. Указывается с кодом национальной валюты.
Пример: <tofee>30 RUB</tofee>
Вместо кода нац. валюты возможно также использование знака % для обозначения процентной дополнительной комиссии; - <minamount> – минимальная возможная к обмену сумма валюты, которую обменный пункт принимает от клиента. Если у вас несколько ограничений по минимальной сумме, например, отдельно на прием и на выплату, необходимо указывать в поле minamount максимальное значение такого ограничения, сконвертированное в валюту from. Указывается с кодом национальной валюты.
Пример: <minamount>4.1 USD</minamount>; - <maxamount> – максимальная возможная к разовому обмену сумма валюты, которую обменный пункт принимает от клиента. Если у вас несколько ограничений по максимальной сумме, например, отдельно на прием и на выплату, необходимо указывать в поле maxamount минимальное значение такого ограничения, сконвертированное в валюту from. Указывается с кодом национальной валюты.
Пример: <maxamount>5000 USD</maxamount>; - <param> – данный элемент служит для указания дополнительных меток, таких как:
- manual – метка должна указываться для направлений обмена, которые обрабатываются через оператора вручную, либо если обмен по направлению производится с задержками (не моментально);
- juridical – обменный пункт производит переводы средств на банковский счет клиента со счета юридического лица или ИП. Указывается только для банковских направлений;
- verifying – при проведении обмена обменный пункт будет требовать от клиента документы, удостоверяющие его личность;
- floating – плавающий курс, который не фиксируется в заявке. При этом сумма обмена может измениться на момент отправки средств клиенту.
Пример: <param>manual, floating</param> - <city> – для указания города, в котором обменный пункт производит ввод/вывод электронных денег на наличные. Это поле имеет смысл указывать только для направлений с наличными. Экспортный файл может содержать направления обменов с разными указанными городами.
Пример: <city>MSK</city>
- Постоянные комиссии платежных систем не должны указываться в экспортном файле курсов. Наш мониторинг учитывает их самостоятельно.
Коды электронных валют
|
Коды национальных валют
Коды городов
|
Пример
<rates>
<item>
<from>WMZ</from>
<to>WMR</to>
<in>1</in>
<out>30.593562</out>
<amount>572962.42</amount>
</item>
<item>
<from>OKUSD</from>
<to>PMUSD</to>
<in>1</in>
<out>0.978</out>
<amount>2921.42</amount>
<minfee>7 USD</minfee>
<param>manual</param>
</item>
<item>
<from>WMR</from>
<to>CARDRUB</to>
<in>1</in>
<out>0.980</out>
<amount>67341.10</amount>
<minfee>130 RUB</minfee>
<tofee>1 %</tofee>
<param>manual, juridical</param>
</item>
<item>
<from>PMUSD</from>
<to>CASHUSD</to>
<in>1</in>
<out>0.9705</out>
<amount>3901.90</amount>
<minfee>5 USD</minfee>
<city>MSK</city>
</item>
</rates>
<item>
<from>WMZ</from>
<to>WMR</to>
<in>1</in>
<out>30.593562</out>
<amount>572962.42</amount>
</item>
<item>
<from>OKUSD</from>
<to>PMUSD</to>
<in>1</in>
<out>0.978</out>
<amount>2921.42</amount>
<minfee>7 USD</minfee>
<param>manual</param>
</item>
<item>
<from>WMR</from>
<to>CARDRUB</to>
<in>1</in>
<out>0.980</out>
<amount>67341.10</amount>
<minfee>130 RUB</minfee>
<tofee>1 %</tofee>
<param>manual, juridical</param>
</item>
<item>
<from>PMUSD</from>
<to>CASHUSD</to>
<in>1</in>
<out>0.9705</out>
<amount>3901.90</amount>
<minfee>5 USD</minfee>
<city>MSK</city>
</item>
</rates>
Ссылка на примерный экспортный файл курсов
FAQ по экспортным курсам
- Наш экспортный файл обновляется раз в минуту. Достаточно ли такой периодичности?
-
Нет, этого недостаточно. Наш мониторинг запрашивает файлы курсов каждые 5-8 секунд, поэтому для повышения точности передаваемых данных необходимо, чтобы обменный пункт имел экспортный файл, который в любой момент времени будет содержать информацию, соответствующую информации на сайте обменного пункта.
Подойдет один из следующих вариантов реализации экспорта:- Скрипт, который при каждом его запросе генерирует новые экспортные данные;
- Статичный экспортный файл, который будет программно пересоздан каждый раз, когда какое-либо изменение курсов/резервов/комиссий произойдет на сайте обменного пункта.
- Наш обменный пункт имеет ступенчатые курсы обмена, которые изменяются в зависимости от суммы обмена. Как указать это в экспорте?
- Мониторинг не поддерживает ступенчатые курсы. В данном случае, в экспорт должны передаваться курсы обмена с максимально возможным процентом.
- Наш обменный пункт имеет лимиты на максимальную дневную сумму обмена. Как указать это в экспорте?
-
Для этого нужно, в зависимости от размера установленного лимита, сделать автоматическую коррекцию резервов в тех направлениях, где есть лимиты.
Например: по направлению QIWI → WMZ установлен лимит на прием QIWI в 1000 RUB максимум – в таком случае нужно для этого направления установить резерв 1000 RUB в валюте получения, т.е. перевести 1000 RUB в USD.
Если установлен лимит равный нулю, то такие направления не должны передаваться в экспорт, либо резерв этих направлений также должен быть нулевым.
- Можно ли сделать, чтобы мы отображались в листинге с понедельника по субботу включительно, с 9:00 до 19:00, а в воскресенье чтобы не отображались?
-
Это можно сделать 2-я способами:
- Настроить скрипт генерации экспортных курсов так, чтобы файл курсов автоматически очищался (либо в нем обнулялись курсы или резервы) в то время, когда вы не работаете;
- Вручную каждый раз включать и выключать присутствие обменника в мониторинге при помощи ссылки Включить/Выключить в вашем аккаунте на bestchange.org
Если у вас возникли вопросы, вы можете задать их, связавшись с нами одним из способов, указанных на странице контактов.