Всего курсов:
17749
Обменников:
280/295
Обновление:
10:51:40

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

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

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

  • Экспортный файл формируется в 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>;
    • <maxamount> – максимальная возможная к разовому обмену сумма валюты, которую обменный пункт принимает от клиента. Указывается с кодом национальной валюты.
      Пример: <maxamount>5000 USD</maxamount>;
    • <param> – данный элемент служит для указания дополнительных меток, таких как:
      • manual – метка должна указываться для направлений обмена, которые обрабатываются через оператора вручную, либо если обмен по направлению производится с задержками (не моментально);
      • juridical – данная метка означает, что обменный пункт производит переводы средств на банковский счет клиента со счета юридического лица или ИП. Указывается только для банковских направлений.
      Если меток несколько, они указываются через запятую.
      Пример: <param>manual, juridical</param>
    • <city> – для указания города, в котором обменный пункт производит ввод/вывод электронных денег на наличные. Это поле имеет смысл указывать только для направлений с наличными. Экспортный файл может содержать направления обменов с разными указанными городами.
      Пример: <city>MSK</city>
  • Постоянные комиссии платежных систем не должны указываться в экспортном файле курсов. Наш мониторинг учитывает их самостоятельно.

Коды электронных валют

Код валютыОписание
WMZWMZ
WMRWMR
WMEWME
WMUWMU
WMBWMB
WMYWMY
WMKWMK
WMGWMG
WMXWMX
PMRUSDPaymer USD
PMRRUBPaymer RUB
YAMRUBЯндекс.Деньги
QWUSDQIWI USD
QWRUBQIWI RUB
QWEURQIWI EUR
QWKZTQIWI KZT
PMUSDPerfect Money USD
PMEURPerfect Money EUR
PMBTCPerfect Money BTC
PPUSDPayPal USD
PPRUBPayPal RUB
PPEURPayPal EUR
BTCBitcoin
LTCLitecoin
ETHEthereum
DOGEDogecoin
NMCNamecoin
PPCPeercoin
DASHDash
BTCEUSDBTC-e USD
BTCERUBBTC-e RUB
BTCEEURBTC-e EUR
EXMUSDExmo USD
EXMRUBExmo RUB
EXMEURExmo EUR
ECNEXUSDeCoin
TRDUSDTrade USD
PRUSDPayeer USD
PRRUBPayeer RUB
PREURPayeer EUR
ADVCUSDAdvanced Cash USD
ADVCRUBAdvanced Cash RUB
ADVCEURAdvanced Cash EUR
ADVCUAHAdvanced Cash UAH
SKLUSDSkrill USD
SKLEURSkrill EUR
PAUSDPayza USD
PAEURPayza EUR
OKUSDOKPay USD
OKRUBOKPay RUB
OKEUROKPay EUR
WOUSDW1 USD
WOUAHW1 UAH
ESPEasyPay
IDAMDIdram
WSMUZSWebSum
PAXUMUSDPaxum USD
PAXUMEURPaxum EUR
EPMUSDePayments
CPTSUSDCapitalist
PNRUSDPayoneer
MPLUSDMoneyPolo USD
MPLEURMoneyPolo EUR
NTLRUSDNeteller USD
NTLREURNeteller EUR
PSCEURPaySafeCard
STPUSDSolidTrust Pay
NIXUSDNixMoney USD
NIXEURNixMoney EUR
CGUSDC-Gold
LQUSDLiqPay
ZPRUBZ-Payment
MWRUBБаланс телефона
SBERRUBСбербанк
ACRUBАльфа-Банк
ACCUSDАльфа cash-in USD
ACCRUBАльфа cash-in RUB
TCSBRUBТинькофф
TBRUBВТБ24
RUSSTRUBРусский Стандарт
AVBRUBАвангард
PSBRUBПромсвязьбанк
OPNRUBОткрытие
KUKRUBКукуруза
RNKBRUBРНКБ
P24USDПриват 24 USD
P24UAHПриват 24 UAH
OSDBUAHОщадбанк
PMBBUAHПУМБ
BLRBBYRБеларусбанк
KKBKZTКазкоммерцбанк
HLKBKZTHalykBank
SBERKZTСбербанк KZT
UPCNYUnionPay
CARDUSDVisa/MasterCard USD
CARDRUBVisa/MasterCard RUB
CARDEURVisa/MasterCard EUR
CARDUAHVisa/MasterCard UAH
CARDBYRVisa/MasterCard BYR
CARDKZTVisa/MasterCard KZT
WIREUSDЛюбой банк USD
WIRERUBЛюбой банк RUB
WIREEURЛюбой банк EUR
WIREUAHЛюбой банк UAH
WIREKZTЛюбой банк KZT
WIREGBPЛюбой банк GBP
WUUSDWestern Union USD
WUEURWestern Union EUR
MGUSDMoneyGram USD
MGEURMoneyGram EUR
CNTUSDContact USD
CNTRUBContact RUB
GCMTUSDЗолотая Корона USD
GCMTRUBЗолотая Корона RUB
USTMUSDЮнистрим
CASHUSDНаличные USD
CASHRUBНаличные RUB
CASHEURНаличные EUR
CASHUAHНаличные UAH
CASHKZTНаличные KZT

Коды национальных валют

Код валютыОписание
AMDАрмянский драм
BTCБиткоин
BYRБелорусский рубль
CNYЮань
DSHDash
ETHЭфириум
EURЕвро
GAU1 грамм золота
GBPФунт стерлингов
KZTКазахстанский тенге
LTCЛайткоин
NMCНеймкоин
PPCПиркоин
RUBРоссийский рубль
UAHГривна
USDДоллар США
UZSУзбекский сум
WMXWMX (0.001 BTC)
XDGДогикоин

Коды городов

Код городаОписание
ANTRАнтрацит, Украина
ASTNАстана, Казахстан
BRNБрянск, Россия
VLGDВолгоград, Россия
DNPRДнепропетровск, Украина
DNTДонецк, Украина
EKBЕкатеринбург, Россия
ERVNЕреван, Армения
ZAPЗапорожье, Украина
IRKИркутск, Россия
KZNКазань, Россия
KEMКемерово, Россия
KIEVКиев, Украина
KSTКостанай, Казахстан
KRSKКрасноярск, Россия
KRVRКривой Рог, Украина
KURSKКурск, Россия
LONDЛондон, Великобритания
LVOVЛьвов, Украина
MRPLМариуполь, Украина
MINSKМинск, Беларусь
MSKМосква, Россия
NNOVНижний Новгород, Россия
MYKLНиколаев, Россия
NSKНовосибирск, Россия
ODSОдесса, Украина
OMSKОмск, Россия
PERMПермь, Россия
PTGRПятигорск, Россия
RSNDРостов-на-Дону, Россия
SMRСамара, Россия
SPBСанкт-Петербург, Россия
SIMFСимферополь, Россия
SOCHIСочи, Россия
STAVСтаврополь, Россия
TGNТаганрог, Россия
HRKХарьков, Украина
HMLNХмельницкий, Украина
CHEBЧебоксары, Россия
CHELЧелябинск, Россия
EKIBЭкибастуз, Казахстан

Пример

<rates>

<item>
<from>WMZ</from>
<to>WMR</to>
<in>1</in>
<out>30.593562</out>
<amount>572962.42</amount>
</item>

<item>
<from>OKUSD</from>
<to>PMUSD</to>
<in>1</in>
<out>0.978</out>
<amount>2921.42</amount>
<minfee>7 USD</minfee>
<param>manual</param>
</item>

<item>
<from>WMR</from>
<to>CARDRUB</to>
<in>1</in>
<out>0.980</out>
<amount>67341.10</amount>
<minfee>130 RUB</minfee>
<tofee>1 %</tofee>
<param>manual, juridical</param>
</item>

<item>
<from>PMUSD</from>
<to>CASHUSD</to>
<in>1</in>
<out>0.9705</out>
<amount>3901.90</amount>
<minfee>5 USD</minfee>
<city>MSK</city>
</item>

</rates>

Ссылка на примерный экспортный файл курсов


FAQ по экспортным курсам

Наш экспортный файл обновляется раз в минуту. Достаточно ли такой периодичности?
Нет, этого недостаточно. Наш мониторинг запрашивает файлы курсов каждые 5-8 секунд, поэтому для повышения точности передаваемых данных необходимо, чтобы обменный пункт имел экспортный файл, который в любой момент времени будет содержать информацию, соответствующую информации на сайте обменного пункта.
Подойдет один из следующих вариантов реализации экспорта:
  • Скрипт, который при каждом его запросе генерирует новые экспортные данные;
  • Статичный экспортный файл, который будет программно пересоздан каждый раз, когда какое-либо изменение курсов/резервов/комиссий произойдет на сайте обменного пункта.
Наш обменный пункт имеет ступенчатые курсы обмена, которые изменяются в зависимости от суммы обмена. Как указать это в экспорте?
Мониторинг не поддерживает ступенчатые курсы. В данном случае, в экспорт должны передаваться курсы обмена с максимально возможным процентом.
Наш обменный пункт имеет лимиты на максимальную дневную сумму обмена. Как указать это в экспорте?
Для этого нужно, в зависимости от размера установленного лимита, сделать автоматическую коррекцию резервов в тех направлениях, где есть лимиты.
Например: по направлению QIWI WMZ установлен лимит на прием QIWI в 1000 RUB максимум – в таком случае нужно для этого направления установить резерв 1000 RUB в валюте получения, т.е. перевести 1000 RUB в USD.
Если установлен лимит равный нулю, то такие направления не должны передаваться в экспорт, либо резерв этих направлений также должен быть нулевым.
Можно ли сделать, чтобы мы отображались в листинге с понедельника по субботу включительно, с 9:00 до 19:00, а в воскресенье чтобы не отображались?
Это можно сделать 2-я способами:
  1. Настроить скрипт генерации экспортных курсов так, чтобы файл курсов автоматически очищался (либо в нем обнулялись курсы или резервы) в то время, когда вы не работаете;
  2. Вручную каждый раз включать и выключать присутствие обменника в мониторинге при помощи ссылки Включить/Выключить в вашем аккаунте на bestchange.org

Если у вас возникли вопросы, вы можете задать их, связавшись с нами одним из способов, указанных на странице контактов.