Інструкція по формуванню експортного файлу курсів валют

На цій сторінці представлена інформація щодо вимог до формату експортного файлу курсів. Увага до цих правил необхідна для безпомилкового відображення курсів валют на моніторингу обмінників Kursoff. Для додавання вашого обмінного пункту та іншої супутньої інформації, в заявці на інтеграцію необхідно вказати посилання на експортний файл, розміщений на вашому ресурсі.

Основні інструкції

1. Формат XML є обов'язковим для експорту курсових файлів.
2. Кожен запис повинен розташовуватися з нового рядка. Для перенесення використовується символ \n.
3. Для поділу дробової частини у числових значеннях використовується крапка.
4. Кореневий елемент – <rates>.
5. Кожен обмінний курс необхідно описувати в елементі <item>.
6. Обов'язкові елементи для опису обмінного курсу всередині елемента item:
– <from>: код валюти, яку обмінник приймає від клієнта. Коди валют доступні внизу сторінки.
– <to>: код валюти, яку обмінник відправляє клієнту.
– <in>: зазначення обмінного курсу, скільки валюти повинен віддати клієнт.
– <out>: зазначення обмінного курсу, скільки валюти отримає клієнт.
– <amount>: обʼєм резерву валюти у обмінного пункту (максимум, який може отримати клієнт).
– <minamount>: мінімальна сума валюти, яку обмінний пункт приймає від клієнта. Вказується у валюті from.

Приклад
<minamount>4.1</minamount>. Якщо обмежень за мінімальною сумою кілька, необхідно вказувати в полі minamount максимальне значення такого обмеження. Якщо немає можливості вибрати максимальне значення з декількох значень мінімальних сум, необхідно вказати додаткові поля minamount з окремою мінімальною сумою в кожному.

7. Додаткові елементи для опису обмінного курсу всередині елемента item:
– <fromfee>: додаткова комісія, яка не входить в обмінний курс і утримується із суми, яку клієнт переказує в обмінний пункт. Зазначається у валюті from.

Приклад: <fromfee>2.15</fromfee>. Можна також використовувати % для позначення комісії у відсотках.

Ці інструкції допоможуть структурувати ваш експортний файл обмінних курсів відповідно до вимог формату XML.

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

Код валюти

Опис

ACCUSDАльфа cash-in (USD)
ACEURAlfa Bank (EUR)
ACKZTAlfa Bank (KZT)
ACUAHАльфа Банк (UAH)
ACUSDAlfa Bank (USD)
ADVCEURAdvanced Cash (EUR)
ADVCUSDAdvanced Cash (USD)
ATNBKZTAstana Bank (KZT)
BCBCNYBank of China (CNY)
BCBUSDBank of China (USD)
BCHBitcoin Cash (BCH)
BTCBitcoin (BTC)
CARDAMDVisa/MasterCard (AMD)
CARDEURVisa/MasterCard (EUR)
CARDGBPVisa/MasterCard (GBP)
CARDKZTVisa/MasterCard (KZT)
CARDUAHVisa/MasterCard (UAH)
CARDUSDVisa/MasterCard (USD)
CASHAMDГотівка (AMD)
CASHEURГотівка (EUR)
CASHGBPГотівка (GBP)
CASHKZTГотівка (KZT)
CASHUAHГотівка (UAH)
CASHUSDГотівка (USD)
CCBCNYChina Construction Bank (CNY)
CMBCNYChina Merchants Bank (CNY)
CPTSUSDCapitalist (USD)
CUPCNYChinaUnionPay (CNY)
DASHDash (DASH)
DOGEDogecoin (DOGE)
ETCEthereum Classic (ETC)
ETHEthereum (ETH)
EURBKZTEurasian Bank (KZT)
EURBUSDEurasian Bank (USD)
EXMEURExmo (EUR)
EXMUSDExmo (USD)
FRTBKZTForteBank (KZT)
FRTBUSDForteBank (USD)
HCSBKZTZhilstroysberbank (KZT)
HLKBKZTHalykBank (KZT)
HLKBUSDHalyk Bank (USD)
ICBCCNYIndustrial and Commercial Bank of China (CNY)
KKBKZTКазкоммерцбанк (KZT)
KKBUSDKazkombank (USD)
LTCLitecoin (LTC)
MGEURMoneygram (EUR)
MGUSDMoneygram (USD)
NTLREURNeteller (EUR)
NTLRUSDNeteller (USD)
OSDBUAHОщад банк (UAH)
OTPBUAHОТП Банк (UAH)
P24EURPrivat24 (EUR)
P24UAHПриват 24 (UAH)
P24USDПриват 24 (USD)
PMBBUAHПумб (UAH)
PMEURPerfect Money (EUR)
PMUSDPerfect Money (USD)
PMVUSDPM e-Voucher (USD)
PNRUSDPayoneer (USD)
PPEURPayPal (EUR)
PPGBPPayPal (GBP)
PPUSDPayPal (USD)
PREURPayeer (EUR)
PRUSDPayeer (USD)
RFBUAHАваль (UAH)
RMTFEURRia Financial (EUR)
SKLEURSkrill (EUR)
SKLUSDSkrill (USD)
USDTBEP20USDT BEP20
WCTCNYWeChat (CNY)
WIREEURБудь-який банк (EUR)
WIREGBPБудь-який банк (GBP)
WIREKZTБудь-який банк (KZT)
WIREUAHБудь-який банк (UAH)
WIREUSDБудь-який банк (USD)
WUEURWestern Union (EUR)
WUUSDWestern Union (USD)
XMRMonero (XMR)
ZECZcash (ZEC)
XRPRipple (XRP)
BSVBitcoin (SV)
XEMNEM (XEM)
NEONEO (NEO)
EOSEOS (EOS)
XLMStellar (XLM)
IOTAIOTA (IOTA)
MONOBUAHMonobank (UAH)
USDTERC20USDT ERC20
KSPBKZTKaspi Gold (KZT)
USDTTRC20USDT TRC20
TRXTron (TRX)
CASHAEDГотівка (AED)
CARDAEDVisa/MasterCard (AED)
DAIDAI (USD)
ADACardano (ADA)
OMGOmiseGO (OMG)
BNBBinance Coin (BNB)
LINKChainlink (LINK)
ATOMCosmos (ATOM)
XTZTezos (XTZ)
DOTPolkadot (DOT)
UNIUniswap (UNI)
SOLSolana (SOL)
SHIBShiba Inu (SHIB)
LUNATerra (LUNA)
MATICPolygon (MATIC)
UAHГривня
USDДолари
KZTТенге
EURЄвро
BUSDBinance USD (BUSD)
KSMKusama (KSM)
NEARNear (NEAR)
USDCTRC20USDC (TRC20)
AVAXAvalanche (AVAX)
USDDTRC20USDD (TRC20)
CARDTHBVisa/MasterCard (THB)
CASHTHBГотівка (BAT)
IYBUSDIpakYuliBank
MCBUSDMoldindconbank (USD)
FRBUSDFreedom Bank (USD)
BKKTHBBangkok Bank (THB)
AYUTHBBank of Ayudhya (THB)
ALPCNYAlipay (CNY)
SwiftSwift (USD)
WHTBTUSDTWhiteBIT Code USDT
CARDGELVisa/MasterCard (GEl)
CARDTRYVisa/MasterCard (TRY)
BOAUSDBankofAmerica (USD)
ZELLEUSDZELLE (USD)
MPARSMERCADO PAGO (ARS)