Інструкція по формуванню експортного файлу курсів валют
На цій сторінці представлена інформація щодо вимог до формату експортного файлу курсів. Увага до цих правил необхідна для безпомилкового відображення курсів валют на моніторингу обмінників 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) |
ACEUR | Alfa Bank (EUR) |
ACKZT | Alfa Bank (KZT) |
ACUAH | Альфа Банк (UAH) |
ACUSD | Alfa Bank (USD) |
ADVCEUR | Advanced Cash (EUR) |
ADVCUSD | Advanced Cash (USD) |
ATNBKZT | Astana Bank (KZT) |
BCBCNY | Bank of China (CNY) |
BCBUSD | Bank of China (USD) |
BCH | Bitcoin Cash (BCH) |
BTC | Bitcoin (BTC) |
CARDAMD | Visa/MasterCard (AMD) |
CARDEUR | Visa/MasterCard (EUR) |
CARDGBP | Visa/MasterCard (GBP) |
CARDKZT | Visa/MasterCard (KZT) |
CARDUAH | Visa/MasterCard (UAH) |
CARDUSD | Visa/MasterCard (USD) |
CASHAMD | Готівка (AMD) |
CASHEUR | Готівка (EUR) |
CASHGBP | Готівка (GBP) |
CASHKZT | Готівка (KZT) |
CASHUAH | Готівка (UAH) |
CASHUSD | Готівка (USD) |
CCBCNY | China Construction Bank (CNY) |
CMBCNY | China Merchants Bank (CNY) |
CPTSUSD | Capitalist (USD) |
CUPCNY | ChinaUnionPay (CNY) |
DASH | Dash (DASH) |
DOGE | Dogecoin (DOGE) |
ETC | Ethereum Classic (ETC) |
ETH | Ethereum (ETH) |
EURBKZT | Eurasian Bank (KZT) |
EURBUSD | Eurasian Bank (USD) |
EXMEUR | Exmo (EUR) |
EXMUSD | Exmo (USD) |
FRTBKZT | ForteBank (KZT) |
FRTBUSD | ForteBank (USD) |
HCSBKZT | Zhilstroysberbank (KZT) |
HLKBKZT | HalykBank (KZT) |
HLKBUSD | Halyk Bank (USD) |
ICBCCNY | Industrial and Commercial Bank of China (CNY) |
KKBKZT | Казкоммерцбанк (KZT) |
KKBUSD | Kazkombank (USD) |
LTC | Litecoin (LTC) |
MGEUR | Moneygram (EUR) |
MGUSD | Moneygram (USD) |
NTLREUR | Neteller (EUR) |
NTLRUSD | Neteller (USD) |
OSDBUAH | Ощад банк (UAH) |
OTPBUAH | ОТП Банк (UAH) |
P24EUR | Privat24 (EUR) |
P24UAH | Приват 24 (UAH) |
P24USD | Приват 24 (USD) |
PMBBUAH | Пумб (UAH) |
PMEUR | Perfect Money (EUR) |
PMUSD | Perfect Money (USD) |
PMVUSD | PM e-Voucher (USD) |
PNRUSD | Payoneer (USD) |
PPEUR | PayPal (EUR) |
PPGBP | PayPal (GBP) |
PPUSD | PayPal (USD) |
PREUR | Payeer (EUR) |
PRUSD | Payeer (USD) |
RFBUAH | Аваль (UAH) |
RMTFEUR | Ria Financial (EUR) |
SKLEUR | Skrill (EUR) |
SKLUSD | Skrill (USD) |
USDTBEP20 | USDT BEP20 |
WCTCNY | WeChat (CNY) |
WIREEUR | Будь-який банк (EUR) |
WIREGBP | Будь-який банк (GBP) |
WIREKZT | Будь-який банк (KZT) |
WIREUAH | Будь-який банк (UAH) |
WIREUSD | Будь-який банк (USD) |
WUEUR | Western Union (EUR) |
WUUSD | Western Union (USD) |
XMR | Monero (XMR) |
ZEC | Zcash (ZEC) |
XRP | Ripple (XRP) |
BSV | Bitcoin (SV) |
XEM | NEM (XEM) |
NEO | NEO (NEO) |
EOS | EOS (EOS) |
XLM | Stellar (XLM) |
IOTA | IOTA (IOTA) |
MONOBUAH | Monobank (UAH) |
USDTERC20 | USDT ERC20 |
KSPBKZT | Kaspi Gold (KZT) |
USDTTRC20 | USDT TRC20 |
TRX | Tron (TRX) |
CASHAED | Готівка (AED) |
CARDAED | Visa/MasterCard (AED) |
DAI | DAI (USD) |
ADA | Cardano (ADA) |
OMG | OmiseGO (OMG) |
BNB | Binance Coin (BNB) |
LINK | Chainlink (LINK) |
ATOM | Cosmos (ATOM) |
XTZ | Tezos (XTZ) |
DOT | Polkadot (DOT) |
UNI | Uniswap (UNI) |
SOL | Solana (SOL) |
SHIB | Shiba Inu (SHIB) |
LUNA | Terra (LUNA) |
MATIC | Polygon (MATIC) |
UAH | Гривня |
USD | Долари |
KZT | Тенге |
EUR | Євро |
BUSD | Binance USD (BUSD) |
KSM | Kusama (KSM) |
NEAR | Near (NEAR) |
USDCTRC20 | USDC (TRC20) |
AVAX | Avalanche (AVAX) |
USDDTRC20 | USDD (TRC20) |
CARDTHB | Visa/MasterCard (THB) |
CASHTHB | Готівка (BAT) |
IYBUSD | IpakYuliBank |
MCBUSD | Moldindconbank (USD) |
FRBUSD | Freedom Bank (USD) |
BKKTHB | Bangkok Bank (THB) |
AYUTHB | Bank of Ayudhya (THB) |
ALPCNY | Alipay (CNY) |
Swift | Swift (USD) |
WHTBTUSDT | WhiteBIT Code USDT |
CARDGEL | Visa/MasterCard (GEl) |
CARDTRY | Visa/MasterCard (TRY) |
BOAUSD | BankofAmerica (USD) |
ZELLEUSD | ZELLE (USD) |
MPARS | MERCADO PAGO (ARS) |