Всего курсов:
24671
Обменников:
301/305
Обновление:
21:45:05

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

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

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

Код валютыОписание
WMZWMZ
WMRWMR
WMEWME
WMUWMU
WMBWMB
WMKWMK
WMGWMG
WMXWMX
PMRUSDPaymer USD
PMRRUBPaymer RUB
PMREURPaymer EUR
PMRUAHPaymer UAH
YAMRUBЯндекс.Деньги
QWUSDQIWI USD
QWRUBQIWI RUB
QWEURQIWI EUR
QWKZTQIWI KZT
PMUSDPerfect Money USD
PMEURPerfect Money EUR
PMBTCPerfect Money BTC
PMVUSDPM e-Voucher USD
PPUSDPayPal USD
PPRUBPayPal RUB
PPEURPayPal EUR
PPGBPPayPal GBP
BTCBitcoin (BTC)
BCHBitcoin Cash (BCH)
ETHEthereum (ETH)
ETCEther Classic (ETC)
LTCLitecoin (LTC)
XRPRipple (XRP)
XMRMonero (XMR)
DOGEDogecoin (DOGE)
NMCNamecoin (NMC)
PPCPeercoin (PPC)
DASHDash (DASH)
ZECZcash (ZEC)
USDTTether (USDT)
XEMNEM (XEM)
REPAugur (REP)
WEXUSDWEX USD
WEXRUBWEX RUB
WEXEURWEX EUR
EXMUSDExmo USD
EXMRUBExmo RUB
EXMEURExmo EUR
EXMUAHExmo UAH
CRPCUSDCryptocheck
ECNEXUSDeCoin
LVCNUSDLiveCoin
TRDUSDКриптобиржи USD
TRDEURКриптобиржи EUR
ADVCUSDAdvanced Cash USD
ADVCRUBAdvanced Cash RUB
ADVCEURAdvanced Cash EUR
ADVCUAHAdvanced Cash UAH
PRUSDPayeer USD
PRRUBPayeer RUB
PREURPayeer EUR
SKLUSDSkrill USD
SKLEURSkrill EUR
PAUSDPayza USD
PAEURPayza EUR
OKUSDOKPay USD
OKRUBOKPay RUB
OKEUROKPay EUR
WOUSDW1 USD
WORUBW1 RUB
WOUAHW1 UAH
IDAMDIdram
PAXUMUSDPaxum USD
PAXUMEURPaxum EUR
CPTSUSDCapitalist
EPSUSDEpese
MPLUSDMoneyPolo USD
MPLEURMoneyPolo EUR
NTLRUSDNeteller USD
NTLREURNeteller EUR
PSRUSDPaySera
PSCEURPaySafeCard
STPUSDSolidTrust Pay
NIXUSDNixMoney USD
NIXEURNixMoney EUR
EPAYUSDEpay USD
EPAYEUREpay EUR
ALPCNYAlipay
LQUSDLiqPay
EKZTE-kzt
ZPRUBZ-Payment
MWRUBБаланс телефона
SBERRUBСбербанк
ACRUBАльфа-Банк
ACCUSDАльфа cash-in USD
ACCRUBАльфа cash-in RUB
TCSBRUBТинькофф
TBRUBВТБ24
RUSSTRUBРусский Стандарт
AVBRUBАвангард
PSBRUBПромсвязьбанк
GPBRUBГазпромбанк
KUKRUBКукуруза
RFBRUBРайффайзен
RNKBRUBРНКБ
P24USDПриват 24 USD
P24UAHПриват 24 UAH
RFBUAHРайффайзен UAH
OSDBUAHОщадбанк
PMBBUAHПУМБ
BLRBBYNБеларусбанк
KKBKZTКазкоммерцбанк
HLKBKZTHalykBank
SBERKZTСбербанк KZT
FRTBKZTForteBank
ATNBKZTБанк Астаны
UPCNYUnionPay
CARDUSDVisa/MasterCard USD
CARDRUBVisa/MasterCard RUB
CARDEURVisa/MasterCard EUR
CARDUAHVisa/MasterCard UAH
CARDBYNVisa/MasterCard BYN
CARDKZTVisa/MasterCard KZT
WIREUSDЛюбой банк USD
WIRERUBЛюбой банк RUB
WIREEURЛюбой банк EUR
WIREUAHЛюбой банк UAH
WIREKZTЛюбой банк KZT
WIREGBPЛюбой банк GBP
WIRECNYЛюбой банк CNY
WIRETHBЛюбой банк THB
STLMRUBСчет ИП или ООО
WUUSDWestern Union USD
WUEURWestern Union EUR
MGUSDMoneyGram USD
MGEURMoneyGram EUR
CNTUSDContact USD
CNTRUBContact RUB
GCMTUSDЗолотая Корона USD
GCMTRUBЗолотая Корона RUB
USTMUSDЮнистрим
RMTFUSDRia USD
RMTFEURRia EUR
CASHUSDНаличные USD
CASHRUBНаличные RUB
CASHEURНаличные EUR
CASHUAHНаличные UAH
CASHKZTНаличные KZT

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

Код валютыОписание
AMDАрмянский драм
BCHBitcoin Cash
BTCBitcoin
BYNБелорусский рубль
CNYЮань
DSHDash
ETCEthereum Classic
ETHEthereum
EURЕвро
GAU1 грамм золота
GBPФунт стерлингов
KZTКазахстанский тенге
LTCLitecoin
NMCNamecoin
PPCPeercoin
REPAugur
RUBРоссийский рубль
THBТайский бат
UAHГривна
USDДоллар США
UZSУзбекский сум
WMXWMX (0.001 BTC)
XDGDogecoin
XEMNEM
XMRMonero
XRPRipple
ZECZcash

Коды городов

Код городаОписание
ANTRАнтрацит, Украина
ASTNАстана, Казахстан
BRNБрянск, Россия
VLGDВолгоград, Россия
DNPRДнепропетровск, Украина
DNTДонецк, Украина
EKBЕкатеринбург, Россия
ERVNЕреван, Армения
ZAPЗапорожье, Украина
IZHVИжевск, Россия
IRKИркутск, Россия
KZNКазань, Россия
KEMКемерово, Россия
KIEVКиев, Украина
KSTКостанай, Казахстан
KRSKКрасноярск, Россия
KRMNКременчуг, Украина
KRVRКривой Рог, Украина
KURSKКурск, Россия
LVOVЛьвов, Украина
MRPLМариуполь, Украина
MINSKМинск, Беларусь
MSKМосква, Россия
NABCHНабережные Челны, Россия
NNOVНижний Новгород, Россия
MYKLНиколаев, Россия
NSKНовосибирск, Россия
ODSОдесса, Украина
OMSKОмск, Россия
PERMПермь, Россия
POLTПолтава, Украина
PTGRПятигорск, Россия
RIGAРига, Латвия
RSNDРостов-на-Дону, Россия
SMRСамара, Россия
SPBСанкт-Петербург, Россия
SIMFСимферополь, Россия
SOCHIСочи, Россия
STAVСтаврополь, Россия
TGNТаганрог, Россия
TULAТула, Россия
HRKХарьков, Украина
HMLNХмельницкий, Украина
CHEBЧебоксары, Россия
CHELЧелябинск, Россия
CHERNЧерновцы, Украина
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 секунд, поэтому для повышения точности передаваемых данных необходимо, чтобы обменный пункт имел экспортный файл, который в любой момент времени будет содержать информацию, соответствующую информации на сайте обменного пункта.
Подойдет один из следующих вариантов реализации экспорта:
  • Скрипт, который при каждом его запросе генерирует новые экспортные данные;
  • Статичный экспортный файл, который будет программно пересоздан каждый раз, когда какое-либо изменение курсов/резервов/комиссий произойдет на сайте обменного пункта.
В случае наличия на вашем сайте защиты от DDoS, добавьте IP-адрес нашего робота (95.213.255.11) в белый список для предотвращения блокировки доступа к вашему файлу курсов.
Наш обменный пункт имеет ступенчатые курсы обмена, которые изменяются в зависимости от суммы обмена. Как указать это в экспорте?
Мониторинг не поддерживает ступенчатые курсы. В данном случае, в экспорт должны передаваться курсы обмена с максимально возможным процентом.
Наш обменный пункт имеет лимиты на максимальную дневную сумму обмена. Как указать это в экспорте?
Для этого нужно, в зависимости от размера установленного лимита, сделать автоматическую коррекцию резервов в тех направлениях, где есть лимиты.
Например: по направлению QIWI WMZ установлен лимит на прием QIWI в 1000 RUB максимум – в таком случае нужно для этого направления установить резерв 1000 RUB в валюте получения, т.е. перевести 1000 RUB в USD.
Если установлен лимит равный нулю, то такие направления не должны передаваться в экспорт, либо резерв этих направлений также должен быть нулевым.
Можно ли сделать, чтобы мы отображались в листинге с понедельника по субботу включительно, с 9:00 до 19:00, а в воскресенье чтобы не отображались?
Это можно сделать 2-я способами:
  1. Настроить скрипт генерации экспортных курсов так, чтобы файл курсов автоматически очищался (либо в нем обнулялись курсы или резервы) в то время, когда вы не работаете;
  2. Вручную каждый раз включать и выключать присутствие обменника в мониторинге при помощи ссылки Включить/Выключить в вашем аккаунте на bestchange.org

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