Правила оформления файла курсов xml

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

1. Имена валют записываются латиницей. Пример: Perfect Money USD
2. Каждая валюта имеет сокращенное буквенное обозначение до 6-7 букв. Пример: PMUSD
3. Каждая валюта имеет трехзначный числовой код. Пример: 001
4. В системах с более чем одной валютой необходим указывать эквиваленты, соответствующие ISO 4217 после названия валюты (RUB, USD, UAH и т.д.), если валюта системы не имеет своего идентифицирующего названия или кода. В системах с одной валютой — рекомендуется так же использовать данное правило. Пример: E-Gold XAU USD
5. Краткие обозначения : Gold -> G, Money -> M

Правила формирования XML формата:

1. Элементы в каждой строке следуют в чётко определённой последовательности.
2. Каждая запись с новой строки. Перенос осуществляется символом \n.
3. <rates> — корневой элемент.
4. Каждое направление обмена описывается в элементе — <item>.
5. <from> — код валюты, которую обменный пункт принимает от клиента. Коды электронных валют приведены в списке ниже.
6. <to> — код валюты, которую обменный пункт отправляет клиенту. Коды электронных валют приведены в списке ниже.
7. <in> — сколько валюты from должен отдать клиент.
8. <out> — сколько валюты to получит клиент.
9. <amount> — размер резерва валюты to в обменнике.
10. <minfee> – минимальная комиссия, которую взимает обменный пункт в текущем направлении обмена. Указывается с кодом национальной валюты. Пример: <minfee>5 USD</minfee>.
11. <fromfee> – дополнительная комиссия, не входящая в курс обмена и взимаемая с суммы, которую клиент переводит в обменный пункт. Указывается с кодом национальной валюты. Пример: <fromfee>2.15 EUR</fromfee>. Вместо кода нац. валюты возможно также использование знака % для обозначения процентной дополнительной комиссии.
12. <tofee> – дополнительная комиссия, не входящая в курс обмена и взимаемая с суммы, которую обменный пункт переводит клиенту. Указывается с кодом национальной валюты. Пример: <tofee>30 RUB</tofee>. Вместо кода нац. валюты возможно также использование знака % для обозначения процентной дополнительной комиссии.
13. <minamount> – минимальная возможная к обмену сумма валюты, которую обменный пункт принимает от клиента. Указывается с кодом национальной валюты. Пример: <minamount>4.1 USD</minamount>.
14. <param> – данный элемент служит для указания дополнительных меток, таких как:
    14.1 manual – метка должна указываться для направлений обмена, которые обрабатываются через оператора вручную, либо если обмен по направлению производится с задержками (не моментально).
    14.2 juridical – данная метка означает, что обменный пункт производит переводы средств на банковский счет клиента со счета юридического лица или ИП. Указывается только для банковских направлений.
    14.3 verifying – при проведении обмена обменный пункт может требовать от клиента документы, удостоверяющие его личность;
    14.4 cardverify – при проведении обмена обменный пункт может требовать от клиента верифицировать банковскую карту;
    14.5 floating – плавающий курс, который не фиксируется в заявке. При этом сумма обмена может измениться на момент отправки средств клиенту;
    14.6 otherin – прием денежных средств от клиента производится на стороннюю платежную систему, а не на ту, что указана в поле from;
    14.7 otherout – выплата денежных средств клиенту производится со сторонней платежной системы, а не с той, что указана в поле to;
    14.8 reg – для проведения обмена пользователь обязательно должен зарегистрироваться на сайте обменного пункта;
    14.9 card2card – обменный пункт принимает средства от пользователей переводами Card2Card (не через карточный мерчант). Данная метка актуальна к установке только в направлениях Visa/MasterCard
    Если меток несколько, то они указываются через запятую.
    Пример: <param>manual, juridical</param>.
15. Использовать 6-ть значащих цифр после запятой для курсов.
16. Использовать 2-е значащие цифры после запятой для резервов.
17. Постоянные комиссии платежных систем не должны указываться в экспортном файле курсов.

Примеры:

Список с названиями всех валют можно найти на следующей странице

Список с системными названиями всех городов для наличного обмен доступен на данной странице