Инструкция по формированию экспортного файла курсов валют
На этой странице представлена информация о требованиях к формату экспортного файла курсов. Внимание к этим правилам необходимо для безошибочного отображения курсов валют на мониторинге обменников 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 с отдельной минимальной суммой в каждом.
- <maxamount> — максимальная возможная до одноразового обмена сумма валюты, принимаемая обменным пунктом от клиента. Указывается в валюте from
Пример: <maxamount>5000</maxamount>
Если ограничений по максимальной сумме несколько, например отдельно на прием и выплату, необходимо указывать в поле maxamount минимальное значение такого ограничения, конвертируемое в валюту from. Если нет возможности выбрать минимальное значение из нескольких максимальных сумм, то нужно указать дополнительные поля maxamount с отдельной максимальной суммой в каждом.
7. Дополнительные элементы для описания обменного курса внутри элемента item:
– <fromfee>: дополнительная комиссия, которая не входит в обменный курс и удерживается из суммы, которую клиент переводит в обменный пункт. Указывается в валюте from.
Пример: <fromfee>2,15</fromfee>. Можно также использовать % для обозначения комиссии в процентах.
Эти инструкции помогут структурировать ваш экспортный файл обменных курсов в соответствии с требованиями формата XML
Коды электронных валют
Код валюти | Описание |
|---|---|
| ALPCNY | Alipay (CNY) |
| MPARS | MERCADO PAGO (ARS) |
| USDTBEP20 | USDT (BEP20) |
| USDTERC20 | USDT (ERC20) |
| USDTTRC20 | USDT (TRC20) |
| USDTSOL | USDT (SOL) |
| USDTPOLYGON | USDT (Polygon) |
| USDTTON | USDT (TON) |
| USDTOPTM | USDT (Optimism) |
| USDT ARBTM | USDT (Arbitrum) |
| USDCTRC20 | USDC (TRC20) |
| USDCERC20 | USDC (ERC20) |
| USDCBEP20 | USDC (BEP20) |
| USDCSOL | USDC (SOL) |
| WIREILS | Банковский счет (ILS) |
| HUMOUZS | Карта HUMO (UZS) |
| UZCUZS | Карта UZCARD (UZS) |
| CARDUZS | Банковская карта (UZS) |
| CARDKGS | Банковская карта (KGS) |
| ELKGS | Карта Элкарт (KGS) |
| BLIKPLN | BLIK (PLN) |
| CARDPLN | Банковская карта (PLN) |
| IDAMD | Idram (AMD) |
| USDCPOLYGON | USDC (Polygon) |
| BTC | Bitcoin (BTC) |
| ETH | Ethereum (ETH) |
| TUSDTRC | TrueUSD (TRC20) |
| TUSDERC | TrueUSD (ERC20) |
| XMR | Monero (XMR) |
| IYBUSD | Ipak Yuli Bank (USD) |
| MCBUSD | Moldindconbank (USD) |
| BOAUSD | BankofAmerica (USD) |
| ZELLEUSD | ZELLE (USD) |
| LTC | Litecoin (LTC) |
| CARDKZT | Visa/MasterCard (KZT) |
| KSPBKZT | Kaspi Gold (KZT) |
| DOGE | Dogecoin (DOGE) |
| UAHGTRC20 | UAHg TRC20 (UAHG) |
| UAHE | |
| CARDUAH | Visa/MasterCard (UAH) |
| OSDBUAH | Ощад банк (UAH) |
| OTPBUAH | ОТП Банк (UAH) |
| P24UAH | Приват 24 (UAH) |
| PMBBUAH | Пумб (UAH) |
| WHTBTUSDT | WhiteBIT Code USDT |
| BNB | Binance Coin (BNB) |
| CASHUSD | Наличные (USD) |
| CASHEUR | Наличные (EUR) |
| PREXARS | Prex (ARS) |
| PREXUYU | Prex (UYU) |
| PREXCLP | Prex (CLP) |
| PIXBRBRL | Pix (BRL) |
| WIREUYU | Банковский счет (UYU) |
| WIRECLP | Банковский счет (CLP) |
| WIREPEN | Банковский счет (PEN) |
| CARDGEL | Visa/MasterCard (GEl) |
| CARDTRY | Visa/MasterCard (TRY) |
| TRUMP | TRUMP (TRUMP) |
| BPATARSARS | BANCO PATAGONIA (ARS) |
| BPAVARSARS | Banco Provincia (ARS) |
| BNAOARSARS | Banco Nación (ARS) |
| BCIUARSARS | Banco Ciudad (ARS) |
| BBVAARSARS | BBVA (ARS) |
| BSARARSARS | Santander Rio (ARS) |
| BGALARSARS | Galicia Banco (ARS) |
| CASHTRY | Наличные (TRY) |
| CASHTHB | Наличные (BAT) |
| CASHPLN | Наличные (PLN) |
| CASHCZK | Наличные (CZK) |
| CASHGEL | Наличные (GEL) |
| CASHCAD | Наличные (CAD) |
| CASHAZN | Наличные (AZN) |
| CASHMDL | Наличные (MDL) |
| CASHIDR | Наличные (IDR) |
| CASHKGS | Наличные (KGS) |
| CASHAUD | Наличные (AUD) |
| CASHKRW | Наличные (KRW) |
| MGUSD | Moneygram (USD) |
| WUEUR | Western Union (EUR) |
| CARDAED | Visa/MasterCard (AED) |
| CARDUSD | Visa/MasterCard (USD) |
| FRBUSD | Freedom Bank (USD) |
| AYUTHB | Bank of Ayudhya (THB) |
| BKKTHB | Bangkok Bank (THB) |
| Swift | Swift (USD) |
| SEPA | SEPA (EUR) |
| Sepa Instant | Sepa Instant (EUR) |
| M10 | M10 (AZN) |
| BLIK | BLIK (PLN) |
| UZCARD | Uzum Bank (UZS) |
| HUMO | HUMO (UZS) |
| ADVCUSD | Volet (Advcash) (USD) |
| RIA | RIA (USD) |
| OP | Optimism (OP) |
| ARB | Arbitrum (ARB) |
| APT | Aptos (APT) |
| MANA | Decentraland (MANA) |
| NEM | NEM (XEM) |
| OMG | Network (OMG) |
| ZRX | 0x (ZRX) |
| ICX | ICON (ICX) |
| BAT | BAT (BAT) |
| DAI | DAI (USD) |
| LINK | Chainlink (LINK) |
| ATOM | Cosmos (ATOM) |
| SHIB | Shiba Inu (SHIB) |
| ZEC | Zcash (ZEC) |
| NEO | NEO (NEO) |
| DASH | Dash (DASH) |
| 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) |
| BCH | Bitcoin Cash (BCH) |