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

  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> – данный элемент служит для указания дополнительных меток, таких как: manual – метка должна указываться для направлений обмена, которые обрабатываются через оператора вручную, либо если обмен по направлению производится с задержками (не моментально). juridical – данная метка означает, что обменный пункт производит переводы средств на банковский счет клиента со счета юридического лица или ИП. Указывается только для банковских направлений. Пример: <param>manual, juridical</param>.
  15. Использовать 6-ть значащих цифр после запятой для курсов.
  16. Использовать 2-е значащие цифры после запятой для резервов.
  17. Постоянные комиссии платежных систем не должны указываться в экспортном файле курсов.

Примеры:

<rates>
<item>
<from>Webmoney USD</from>
<to>Webmoney RUB</to>
<in>1</in>
<out>23.628812</out>
<amount>10000.23</amount>
</item>
</rates>
<rates>
<item>
<from>WMZ</from>
<to>WMR</to>
<in>1</in>
<out>23.628812</out>
<amount>10000.23</amount>
</item>
</rates>
<rates>
<item>
<from>001</from>
<to>002</to>
<in>1</in>
<out>23.628812</out>
<amount>10000.23</amount>
</item>
</rates>