Формат экспортного файла курсов

На данной странице приведено описание стандарта для формирования экспортного файла курсов, поддерживаемого мониторингом обменных пунктов BestChange. Для добавления обменного пункта, вместе с остальной информацией для включения, необходимо предоставить администрации BestChange ссылку на экспортный файл, размещенный на вашем сайте. Пример содержимого подобного файла можно увидеть ниже.

Основные правила:

1. Экспортный файл формируется в XML-формате;
2. Каждая запись идет с новой строки. Перенос осуществляется символом \n;
3. Для числовых значений разделителем целой части является точка;
4. Корневой элемент – <rates>;
5. Каждое направление обмена описывается в элементе <item>;

6. Обязательные к указанию элементы для описания направления обмена внутри элемента item:

   • <from> – код валюты, которую обменный пункт принимает от клиента. Коды валют приведены в списке ниже;
   • <to> – код валюты, которую обменный пункт отправляет клиенту. Коды валют приведены в списке ниже;
   • <in> – для указания курса обмена, сколько валюты from должен отдать клиент;
   • <out> – для указания курса обмена, сколько валюты to получит клиент;
   • <amount> – размер резерва валюты to в обменном пункте, максимум, который может получить клиент;
   • <minamount> – минимальная возможная к обмену сумма валюты, которую обменный пункт принимает от клиента. Указывается в валюте from.
     Пример: <minamount>4.1</minamount>
     Если ограничений по минимальной сумме несколько, например, отдельно на прием и на выплату, необходимо указывать в поле minamount максимальное значение такого ограничения, сконвертированное в валюту from. Если нет возможности выбрать максимальное значение из нескольких значений минимальных сумм, необходимо указать дополнительные поля minamount с отдельной минимальной суммой в каждом;
   • <maxamount> – максимальная возможная к разовому обмену сумма валюты, которую обменный пункт принимает от клиента. Указывается в валюте from.
     Пример: <maxamount>5000</maxamount>
     Если ограничений по максимальной сумме несколько, например, отдельно на прием и на выплату, необходимо указывать в поле maxamount минимальное значение такого ограничения, сконвертированное в валюту from. Если нет возможности выбрать минимальное значение из нескольких значений максимальных сумм, необходимо указать дополнительные поля maxamount с отдельной максимальной суммой в каждом.

7. Дополнительные элементы для описания направления обмена внутри элемента item:

   • <fromfee> – дополнительная комиссия, не входящая в курс обмена и взимаемая с суммы, которую клиент переводит в обменный пункт. Указывается в валюте from.
     Пример: <fromfee>2.15</fromfee>
     Возможно также использование знака % для обозначения процентной комиссии;
   • <tofee> – дополнительная комиссия, не входящая в курс обмена и взимаемая с суммы, которую обменный пункт переводит клиенту. Указывается в валюте to.
     Пример: <tofee>0.01508</tofee>
     Возможно также использование знака % для обозначения процентной комиссии;
   • <minfee> – минимальная комиссия, которая рассчитывается для разницы между отдаваемой суммой и эквивалентом получаемой валюты относительно среднего биржевого курса. Указывается абсолютное значение в валюте from. Процентное значение недоступно для данного вида комиссии.
     Пример: <minfee>5</minfee>
     Пожалуйста, имейте в виду, что к дополнительным комиссиям fromfee и tofee комиссия minfee не имеет отношения, минимальная комиссия для отдаваемой или получаемой комиссии на данный момент никак не учитывается нашей системой, избегайте подобного формирования курса. Смотрите примеры использования.
     Пример №1. Минимальная комиссия больше маржи обменного пункта
     Курс обмена 1 доллара – 66 рублей, а официальный курс 68 рублей. Маржа составляет 2 рубля. При обмене 10 долларов получается, что 20 рублей – маржа обменного пункта. Но минимальная комиссия 100 рублей больше маржи в 20 рублей, поэтому 20 заменяется на 100 и происходит вычитание остатка из получаемой суммы: 660 - (100 - 20) = 580.
     Пример №2. Минимальная комиссия меньше маржи обменного пункта
     Курс обмена 1 доллара – 66 рублей, а официальный курс 68 рублей. Маржа составляет 2 рубля. При обмене 100 долларов получается, что 200 рублей – маржа обменного пункта. Минимальная комиссия меньше этого значения, поэтому этот параметр в данном расчете не учитывается: 6600 - 200 = 6400.
     
     Примечание: дополнительная комиссия minfee имеет недостатки, в ближайшее время планируется удаление этого типа комиссии.
   • <floating> – для установки метки плавающего курса. Указывается время в минутах, на которое курс обмена будет фиксироваться. Указывается значение 0 в случае отсутствия фиксации. Возможно также использование знака % для обозначения фиксации курса обмена до момента изменения биржевого курса обмена на указанный процент;
   • <delay> – для установки метки задержки в проведении обмена. Указывается время в минутах, на которое обмен будет задержан;

   • <param> – данный элемент служит для указания дополнительных меток, таких как:

     • manual – для указания метки ручного обмена, которая должна присутствовать для направлений обмена, которые обрабатываются через оператора вручную, либо если обмен по направлению производится с задержками (не моментально);
     • juridical – обменный пункт производит переводы средств на банковский счет клиента со счета юридического лица или ИП. Данная метка актуальна к установке только в направлениях * —› Банковский счет;
     • verifying – при проведении обмена обменный пункт может требовать от клиента документы, удостоверяющие его личность;
     • cardverify – при проведении обмена обменный пункт может требовать от клиента верифицировать банковскую карту;
     • otherin – прием денежных средств от клиента производится на стороннюю платежную систему, а не на ту, что указана в поле from;
     • otherout – выплата денежных средств клиенту производится со сторонней платежной системы, а не с той, что указана в поле to;
     • reg – для проведения обмена пользователь обязательно должен зарегистрироваться на сайте обменного пункта;
     • card2card – обменный пункт принимает средства от пользователей переводами Card2Card (не через карточный мерчант). Данная метка актуальна к установке только в направлениях Visa/MasterCard —› *;
     • delivery – обменный пункт не имеет офиса в выбранном городе, оплата курьерской доставки включена в курс обмена или отображена посредством метки "Дополнительная комиссия".
     Если меток несколько, они указываются через запятую.
     Пример: <param>manual, reg</param>
   • <city> – для указания города, в котором обменный пункт производит ввод/вывод электронных денег на наличные. Это поле имеет смысл указывать только для направлений с наличными. Экспортный файл может содержать направления обменов с разными указанными городами. Коды городов приведены в списке ниже.
     Пример: <city>MSK</city>
     Если условия по направлению обмена одинаковые в нескольких городах, разрешено указывать внутри одного элемента item несколько городов через запятую в одном элементе city.
     Пример: <city>MSK, DUBAI, KIEV</city>
8. Постоянные комиссии платежных систем не должны указываться в экспортном файле курсов. Наш мониторинг учитывает их самостоятельно.

Пример

<?xml version="1.0"?>
<rates>
  <item>
    <from>WMZ</from>
    <to>WMX</to>
    <in>1</in>
    <out>30.593562</out>
    <amount>572962.42</amount>
    <minamount>3</minamount>
    <maxamount>1000</maxamount>
  </item>
  <item>
    <from>ADVCUSD</from>
    <to>PMUSD</to>
    <in>1</in>
    <out>0.978</out>
    <amount>2921.42</amount>
    <minamount>2</minamount>
    <maxamount>2000</maxamount>
    <minfee>7</minfee>
    <param>manual</param>
  </item>
  <item>
    <from>BTC</from>
    <to>ETH</to>
    <in>1</in>
    <out>24.90782568</out>
    <amount>673.10</amount>
    <minamount>0.0001</minamount>
    <maxamount>0.42341216</maxamount>
    <tofee>1%</tofee>
    <param>manual, reg</param>
  </item>
  <item>
    <from>BTC</from>
    <to>CASHUSD</to>
    <in>1</in>
    <out>4342.352344</out>
    <amount>31.90343295</amount>
    <minamount>1.5</minamount>
    <maxamount>1000</maxamount>
    <minfee>5</minfee>
    <city>ANKR</city>
  </item>
</rates>

Ссылка на примерный экспортный файл курсов

FAQ по экспортным курсам

Если у вас возникли вопросы, вы можете задать их, связавшись с нами одним из способов, указанных на странице контактов.