Экспорт курсов

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

Правила формирования названий валют

• Название валюты записывается латиницей, например Perfect Money USD.
• У каждой валюты есть сокращённое буквенное обозначение длиной до 6–7 букв, например PMUSD.
• У каждой валюты есть числовой код, например 001. В таблице ниже у более новых позиций код состоит из четырёх цифр.
• Если в платёжной системе больше одной валюты, после названия указывают эквивалент по ISO 4217 (RUB, USD, UAH и т. д.) — когда у валюты нет собственного названия или кода. Для систем с одной валютой это правило тоже рекомендуется. Пример: E-Gold XAU USD.
• Краткие обозначения: Gold → G, Money → M.

Формат XML

Элементы в каждой записи идут в строго определённой последовательности, каждая запись начинается с новой строки (перевод строки \n). Корневой элемент — <rates>, каждое направление обмена описывается элементом <item>.

<from>

код валюты, которую обменный пункт принимает от клиента; коды электронных валют даны в таблице ниже.

<to>

код валюты, которую обменный пункт отправляет клиенту.

<in>

сколько валюты from должен отдать клиент.

<out>

сколько валюты to получит клиент.

<amount>

размер резерва валюты to в обменном пункте.

<minfee>

минимальная комиссия, которую обменный пункт берёт в этом направлении; указывается с кодом национальной валюты, например <minfee>5 USD</minfee>.

<fromfee>

дополнительная комиссия, не входящая в курс и взимаемая с суммы, которую клиент переводит обменному пункту, например <fromfee>2.15 EUR</fromfee>. Вместо кода валюты можно использовать знак % для процентной комиссии.

<tofee>

дополнительная комиссия, не входящая в курс и взимаемая с суммы, которую обменный пункт переводит клиенту, например <tofee>30 RUB</tofee>. Знак % тоже допустим.

<minamount>

минимальная сумма, которую обменный пункт принимает от клиента; указывается с кодом национальной валюты, например <minamount>4.1 USD</minamount>.

<param>

дополнительные метки через запятую. manual — направление обрабатывается оператором вручную или с задержкой, не моментально. juridical — обменный пункт переводит деньги на банковский счёт клиента со счёта юридического лица или ИП (только для банковских направлений). Пример: <param>manual, juridical</param>.

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

Пример структуры файла. Числа в нём условные и показывают только формат, это не рыночный курс. В полях from и to допустимо любое из трёх обозначений валюты: полное название, сокращение или числовой код.

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

<from>WMZ</from>  <to>WMR</to>        — сокращённые обозначения
<from>001</from>  <to>002</to>        — числовые коды

Формат TXT

В текстовом файле элементы каждой строки тоже идут в определённом порядке, записи разделяются переводом строки в формате Unix (\n, 0x0A), а поля — точкой с запятой.

from;

отдаваемая валюта (полное, сокращённое или числовое обозначение).

to;

получаемая валюта.

in;

«отдадите».

out;

«получите».

amount

резерв валюты to.

Для курсов — шесть значащих цифр после запятой, для резервов — две. Строки, начинающиеся с символа #, считаются комментариями; так можно временно отключить направление обмена. Примеры (числа условные):

Webmoney USD;Webmoney RUB;1;23.628812;10000.23
WMZ;WMR;1;23.628812;10000.23
001;002;1;23.628812;10000.23

Список кодов валют

В таблице 443 позиций: название валюты, сокращённое обозначение и числовой код. Чтобы найти нужную валюту, введите часть названия, сокращения или кода.

Если нужной валюты или платёжной системы в списке нет, предложите её редакции — способ связи указан на странице «Контакты».

Как менялся список обозначений

Список дополнялся записями в блоге. Здесь собраны сообщения о правках таблицы и формата.

• 4 марта 2015 г.Добавлен стандарт экспорта кредитов

  Март 2015: добавлен стандарт экспорта условий кредитов для кредитных автоматов WebMoney.

• 22 февраля 2015 г.Добавлены новые обозначения

  Февраль 2015: в разделе стандарта экспорта курсов появились новые обозначения валют, найти их помогает поиск по таблице.

• 15 февраля 2015 г.Обновление сайта

  Февраль 2015: обновление сайта с личным кабинетом и онлайн-заявками на размещение обменников и мониторингов.

• 18 октября 2014 г.Профилактика списка обозначений

  Октябрь 2014 года: список обозначений валют проверен, часть обозначений переименована, добавлены новые.

• 24 ноября 2012 г.Новые валюты в списке

  В ноябре 2012 года в стандарт добавлены EgoPay, SolidTrustPay, PayWeb, Ukash, Paxum, Redpass и Epayments.

• 22 января 2011 г.Новые обозначения для валют

  В январе 2011 года в таблицу стандарта добавлены Qiwi, OKPay, Western Union, Moneygram, EuroGoldCash, Сбербанк и RusStandard.

Формат экспорта условий кредитов описан отдельно — в разделе «Экспорт кредитов».