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