Инструкция по формированию экспортного файла курсов валют

На этой странице представлена информация о требованиях к формату экспортного файла курсов. Внимание к этим правилам необходимо для безошибочного отображения курсов валют на мониторинге обменников 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

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

Код валюти

Описание

ALPCNYAlipay (CNY)
MPARSMERCADO PAGO (ARS)
USDTBEP20USDT (BEP20)
USDTERC20USDT (ERC20)
USDTTRC20USDT (TRC20)
USDTSOLUSDT (SOL)
USDTPOLYGONUSDT (Polygon)
USDTTONUSDT (TON)
USDTOPTMUSDT (Optimism)
USDT ARBTMUSDT (Arbitrum)
USDCTRC20USDC (TRC20)
USDCERC20USDC (ERC20)
USDCBEP20USDC (BEP20)
USDCSOLUSDC (SOL)
WIREILSБанковский счет (ILS)
HUMOUZSКарта HUMO (UZS)
UZCUZSКарта UZCARD (UZS)
CARDUZSБанковская карта (UZS)
CARDKGSБанковская карта (KGS)
ELKGSКарта Элкарт (KGS)
BLIKPLNBLIK (PLN)
CARDPLNБанковская карта (PLN)
IDAMDIdram (AMD)
USDCPOLYGONUSDC (Polygon)
BTCBitcoin (BTC)
ETHEthereum (ETH)
TUSDTRCTrueUSD (TRC20)
TUSDERCTrueUSD (ERC20)
XMRMonero (XMR)
IYBUSDIpak Yuli Bank (USD)
MCBUSDMoldindconbank (USD)
BOAUSDBankofAmerica (USD)
ZELLEUSDZELLE (USD)
LTCLitecoin (LTC)
CARDKZTVisa/MasterCard (KZT)
KSPBKZTKaspi Gold (KZT)
DOGEDogecoin (DOGE)
UAHGTRC20UAHg TRC20 (UAHG)
UAHE
CARDUAHVisa/MasterCard (UAH)
OSDBUAHОщад банк (UAH)
OTPBUAHОТП Банк (UAH)
P24UAHПриват 24 (UAH)
PMBBUAHПумб (UAH)
WHTBTUSDTWhiteBIT Code USDT
BNBBinance Coin (BNB)
CASHUSDНаличные (USD)
CASHEURНаличные (EUR)
PREXARSPrex (ARS)
PREXUYUPrex (UYU)
PREXCLPPrex (CLP)
PIXBRBRLPix (BRL)
WIREUYUБанковский счет (UYU)
WIRECLPБанковский счет (CLP)
WIREPENБанковский счет (PEN)
CARDGELVisa/MasterCard (GEl)
CARDTRYVisa/MasterCard (TRY)
TRUMPTRUMP (TRUMP)
BPATARSARSBANCO PATAGONIA (ARS)
BPAVARSARSBanco Provincia (ARS)
BNAOARSARSBanco Nación (ARS)
BCIUARSARSBanco Ciudad (ARS)
BBVAARSARSBBVA (ARS)
BSARARSARSSantander Rio (ARS)
BGALARSARSGalicia 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)
MGUSDMoneygram (USD)
WUEURWestern Union (EUR)
CARDAEDVisa/MasterCard (AED)
CARDUSDVisa/MasterCard (USD)
FRBUSDFreedom Bank (USD)
AYUTHBBank of Ayudhya (THB)
BKKTHBBangkok Bank (THB)
SwiftSwift (USD)
SEPASEPA (EUR)
Sepa Instant Sepa Instant (EUR)
M10M10 (AZN)
BLIKBLIK (PLN)
UZCARDUzum Bank (UZS)
HUMOHUMO (UZS)
ADVCUSDVolet (Advcash) (USD)
RIARIA (USD)
OPOptimism (OP)
ARBArbitrum (ARB)
APTAptos (APT)
MANADecentraland (MANA)
NEMNEM (XEM)
OMGNetwork (OMG)
ZRX0x (ZRX)
ICXICON (ICX)
BATBAT (BAT)
DAIDAI (USD)
LINKChainlink (LINK)
ATOMCosmos (ATOM)
SHIBShiba Inu (SHIB)
ZECZcash (ZEC)
NEONEO (NEO)
DASHDash (DASH)
XTZTezos (XTZ)
UNIUniswap (UNI)
AVAXAvalanche (AVAX)
NEARNear (NEAR)
KSMKusama (KSM)
DOTPolkadot (DOT)
ADACardano (ADA)
XRPRipple (XRP)
TRXTron (TRX)
TONToncoin (TON)
BCHBitcoin Cash (BCH)