Формат экспортного файла курсов

Формат экспортного файла курсов

На данной странице приведено описание стандарта для формирования экспортного файла курсов, поддерживаемого мониторингом обменных пунктов BestChange. Для добавления обменного пункта, вместе с остальной информацией для включения, необходимо предоставить администрации BestChange ссылку на экспортный файл, размещенный на вашем сайте. Пример содержимого подобного файла можно увидеть ниже.

  • Экспортный файл формируется в XML-формате;
  • Каждая запись идет с новой строки. Перенос осуществляется символом \n ;
  • Для числовых значений разделителем целой части является точка;
  • Корневой элемент – <rates> ;
  • Каждое направление обмена описывается в элементе <item> ;
  • Элементы для описания каждого направления обмена:
    • <from> – код валюты, которую обменный пункт принимает от клиента. Коды электронных валют приведены в списке ниже;
    • <to> – код валюты, которую обменный пункт отправляет клиенту. Коды электронных валют приведены в списке ниже;
    • <in> – сколько валюты from должен отдать клиент;
    • <out> – сколько валюты to получит клиент;
    • <amount> – размер резерва валюты to в обменнике;
    • <minfee> – минимальная комиссия, которая рассчитывается для разницы между отдаваемой суммой и эквивалентом получаемой валюты относительно среднего биржевого курса. Указывается с кодом национальной валюты. Пример: <minfee>5 USD</minfee>Пожалуйста, имейте в виду, что к дополнительным комиссиям fromfee и tofee комиссия minfee не имеет отношения, минимальная комиссия для отдаваемой или получаемой комиссии на данный момент никак не учитывается нашей системой, избегайте подобного формирования курса. Смотрите примеры использования.

    • manual – метка должна указываться для направлений обмена, которые обрабатываются через оператора вручную, либо если обмен по направлению производится с задержками (не моментально);
    • juridical – обменный пункт производит переводы средств на банковский счет клиента со счета юридического лица или ИП. Данная метка актуальна к установке только в направлениях * —› Любой Банк;
    • verifying – при проведении обмена обменный пункт может требовать от клиента документы, удостоверяющие его личность;
    • cardverify – при проведении обмена обменный пункт может требовать от клиента верифицировать банковскую карту;
    • floating – плавающий курс, который не фиксируется в заявке. При этом сумма обмена может измениться на момент отправки средств клиенту;
    • otherin – прием денежных средств от клиента производится на стороннюю платежную систему, а не на ту, что указана в поле from;
    • otherout – выплата денежных средств клиенту производится со сторонней платежной системы, а не с той, что указана в поле to;
    • reg – для проведения обмена пользователь обязательно должен зарегистрироваться на сайте обменного пункта;
    • card2card – обменный пункт принимает средства от пользователей переводами Card2Card (не через карточный мерчант). Данная метка актуальна к установке только в направлениях Visa/MasterCard —› *;
    • delivery – обменный пункт не имеет офиса в выбранном городе, оплата курьерской доставки включена в курс обмена или отображена посредством метки "Дополнительная комиссия".

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

    Коды национальных валют

    Код валютыОписаниеADACardano AEDДирхам ОАЭ ALGAlgorand AMDАрмянский драм ATMCosmos AVXAvalanche BATBAT BCHBitcoin BCH BGNБолгарский лев BNBBinance Coin BSVBitcoin SV BTCBitcoin BTGBitcoin Gold BTTBitTorrent BYNБелорусский рубль CADКанадский доллар CNYЮань CROCronos CZKЧешская крона DOTPolkadot DSHDash EOSEOS ETCEthereum Classic ETHEthereum EURЕвро GBPФунт стерлингов GELГрузинский лари HUFФоринт ICXICON IDRИндонезийская рупия INRИндийская рупия IOTIOTA JPYЯпонская иена KGSКиргизский сом KMDKomodo KZTКазахстанский тенге LNKChainlink LSKLisk LTCLitecoin LUNTerra MATPolygon MDLМолдавский лей MKRMaker MNADecentraland MYRМалайзийский ринггит NEANEAR Protocol NEONEO NGNНигерийская найра NOKНорвежская крона OMGOMG Network ONTOntology PLNПольский злотый QTMQTUM RUBРоссийский рубль RVNRavencoin SEKШведская крона SHIShiba Inu SOLSolana THBТайский бат TONTON TRXTRON TRYТурецкая лира UAHГривна UNIUniswap USDДоллар США UZSУзбекский сум VETVeChain VNDВьетнамский донг WAVWAVES WMXWMX (0.001 BTC) XDGDogecoin XEMNEM XLMStellar XMRMonero XRPRipple XTZTezos XVGVerge YFIYearn.finance ZECZcash ZRX0x

    Коды городов

    Пример

    FAQ по экспортным курсам

    1. Скрипт, который при каждом его запросе генерирует новые экспортные данные;
    2. Статичный экспортный файл, который будет программно пересоздан каждый раз, когда какое-либо изменение курсов/резервов/комиссий произойдет на сайте обменного пункта.
    1. Все затраты, связанные с отправкой средств со стороны обменного пункта взимаемые с суммы, получаемой пользователем;
    2. Все затраты, связанные с отправкой средств со стороны клиента, за исключением комиссий, взимаемых ПС если оплата производится внутри этой ПС.
    1. Настроить скрипт генерации экспортных курсов так, чтобы файл курсов автоматически очищался (либо в нем обнулялись курсы или резервы) в то время, когда вы не работаете;
    2. Вручную каждый раз включать и выключать присутствие обменника в мониторинге при помощи ссылки Включить/Выключить в вашем аккаунте на bestchange.org

    Если у вас возникли вопросы, вы можете задать их, связавшись с нами одним из способов, указанных на странице контактов.