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

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