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

    На данной странице приведено описание стандарта для формирования экспортного файла курсов, поддерживаемого мониторингом обменных пунктов ExNode.

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


      1. Экспортный файл формируется в XML-формате;
          • Каждая запись идет с новой строки. Перенос осуществляется символом \n;
          • Для числовых значений разделителем целой части является точка;
          • Корневой элемент – <rates>;
          • Каждое направление обмена описывается в элементе <item>;
          • Элементы для описания каждого направления обмена:
            • <from> – код валюты, которую обменный пункт принимает от клиента. Коды электронных валют приведены в списке ниже;
            • <to> – код валюты, которую обменный пункт отправляет клиенту. Коды электронных валют приведены в списке ниже;
            • <in> – сколько валюты from должен отдать клиент;
            • <out> – сколько валюты to получит клиент;
            • <amount> – размер резерва валюты to в обменнике;
            • <minfee> – минимальная комиссия, которая рассчитывается для разницы между отдаваемой суммой и эквивалентом получаемой валюты относительно среднего биржевого курса. Указывается с кодом национальной валюты.
              Пример: <minfee>5 USD</minfee>
              Пожалуйста, имейте в виду, что к дополнительным комиссиям fromfee и tofee комиссия minfee не имеет отношения, минимальная комиссия для отдаваемой или получаемой комиссии на данный момент никак не учитывается нашей системой, избегайте подобного формирования курса. Смотрите
          • использования.
          • <fromfee> – дополнительная комиссия, не входящая в курс обмена и взимаемая с суммы, которую клиент переводит в обменный пункт. Указывается с кодом национальной валюты.
            Пример: <fromfee>2.15 EUR</fromfee>
            Вместо кода нац. валюты возможно также использование знака % для обозначения процентной дополнительной комиссии;
          • <tofee> – дополнительная комиссия, не входящая в курс обмена и взимаемая с суммы, которую обменный пункт переводит клиенту. Указывается с кодом национальной валюты.
            Пример: <tofee>30 RUB</tofee>
            Вместо кода нац. валюты возможно также использование знака % для обозначения процентной дополнительной комиссии;
          • <minamount> – минимальная возможная к обмену сумма валюты, которую обменный пункт принимает от клиента. Указывается с кодом национальной валюты.
            Пример: <minamount>4.1 USD</minamount>
            Если ограничений по минимальной сумме несколько, например, отдельно на прием и на выплату, необходимо указывать в поле minamount максимальное значение такого ограничения, сконвертированное в валюту from. Если нет возможности выбрать максимальное значение из нескольких значений минимальных сумм, необходимо указать дополнительные поля minamount с отдельной минимальной суммой в каждом;
          • <maxamount> – максимальная возможная к разовому обмену сумма валюты, которую обменный пункт принимает от клиента. Указывается с кодом национальной валюты.
            Пример: <maxamount>5000 USD</maxamount>
            Если ограничений по максимальной сумме несколько, например, отдельно на прием и на выплату, необходимо указывать в поле maxamount минимальное значение такого ограничения, сконвертированное в валюту from. Если нет возможности выбрать минимальное значение из нескольких значений максимальных сумм, необходимо указать дополнительные поля maxamount с отдельной максимальной суммой в каждом;
          • <param> – данный элемент служит для указания дополнительных меток, таких как:
            • manual – метка должна указываться для направлений обмена, которые обрабатываются через оператора вручную, либо если обмен по направлению производится с задержками (не моментально);
            • juridical – обменный пункт производит переводы средств на банковский счет клиента со счета юридического лица или ИП. Данная метка актуальна к установке только в направлениях * —› Любой Банк;
            • verifying – при проведении обмена обменный пункт может требовать от клиента документы, удостоверяющие его личность;
            • cardverify – при проведении обмена обменный пункт может требовать от клиента верифицировать банковскую карту;
            • floating – плавающий курс, который не фиксируется в заявке. При этом сумма обмена может измениться на момент отправки средств клиенту;
            • otherin – прием денежных средств от клиента производится на стороннюю платежную систему, а не на ту, что указана в поле from;
            • otherout – выплата денежных средств клиенту производится со сторонней платежной системы, а не с той, что указана в поле to;
            • reg – для проведения обмена пользователь обязательно должен зарегистрироваться на сайте обменного пункта;
            • card2card – обменный пункт принимает средства от пользователей переводами Card2Card (не через карточный мерчант). Данная метка актуальна к установке только в направлениях Visa/MasterCard —› *.
            Если меток несколько, они указываются через запятую.
            Пример: <param>manual, floating</param>
          • <city> – для указания города, в котором обменный пункт производит ввод/вывод электронных денег на наличные. Это поле имеет смысл указывать только для направлений с наличными. Экспортный файл может содержать направления обменов с разными указанными городами.
            Пример: <city>MSK</city>
        • Постоянные комиссии платежных систем не должны указываться в экспортном файле курсов. Наш мониторинг учитывает их самостоятельно.