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

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

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

Код валюти

Описание

MPARSMERCADO PAGO (ARS)
USDTTRC20USDT (TRC20)
USDTERC20USDT (ERC20)
USDTBEP20USDT (BEP20)
USDTPOLYGONUSDT (Polygon)
USDTSOLUSDT (SOL)
BTCBitcoin (BTC)
USDCPOLYGONUSDC (Polygon)
USDCSOLUSDC (SOL)
USDCBEP20USDC (BEP20)
USDCERC20USDC (ERC20)
USDCTRC20USDC (TRC20)
ETHEthereum (ETH)
XMRMonero (XMR)
ZELLEUSDZELLE (USD)
LTCLitecoin (LTC)
DOGEDogecoin (DOGE)
BNBBinance Coin (BNB)
PREXCLPPrex (CLP)
PREXUYUPrex (UYU)
PREXARSPrex (ARS)
PIXBRBRLPix (BRL)
BNAOARSARSBanco Nación (ARS)
BPAVARSARSBanco Provincia (ARS)
BPATARSARSBANCO PATAGONIA (ARS)
BCIUARSARSBanco Ciudad (ARS)
BBVAARSARSBBVA (ARS)
BSARARSARSSantander Rio (ARS)
BGALARSARSGalicia Banco (ARS)
WUUSDWestern Union (USD)
PPGBPPayPal (GBP)
PPEURPayPal (EUR)
PPUSDPayPal (USD)
SKLEURSkrill (EUR)
SKLUSDSkrill (USD)
USDSDAI (ERC20 )USDS
ATOMCosmos (ATOM)
DASHDash (DASH)
XLMStellar (XLM)
XTZTezos (XTZ)
DOTPolkadot (DOT)
ADACardano (ADA)
XRPRipple (XRP)
ETCEthereum Classic (ETC)
BCHBitcoin Cash (BCH)