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

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

На дадзенай старонцы прыведзена апісанне стандарту для фарміравання экспартнага файла курсаў, які падтрымліваецца маніторынгам абменных пунктаў ExNode.
Асноўныя правілы:
  • Экспартны файл фармуецца ў XML-фармаце;
  • Кожны запіс ідзе з новага радка. Перанос ажыццяўляецца сімвалам \n;
  • Для лікавых значэнняў падзельнікам цэлай часткі з'яўляецца кропка;
  • Карнявы элемент – <rates>;
  • Кожны кірунак абмену апісваецца ў элеменце <item>;
  • Элементы для апісання кожнага напрамку абмену:
  • <from> – код валюты, якую абменны пункт прымае ад кліента. Коды электронных валют прыведзены ў спісе ніжэй;
  • <to> – код валюты, якую абменны пункт адпраўляе кліенту. Коды электронных валют прыведзены ў спісе ніжэй;
  • <in> – колькі валюты from павінен аддаць кліент;
  • <out> – колькі валюты to атрымае кліент;
  • <amount> – памер рэзерву валюты to ў абменніку;
  • <minfee> – мінімальная камісія, якая разлічваецца для розніцы паміж сумай, якая аддаецца, і эквівалентам атрыманай валюты адносна сярэдняга біржавога курсу. Указваецца з кодам нацыянальнай валюты.
  • Прыклад: <minfee>5 USD</minfee>
  • Калі ласка, майце на ўвазе, што да дадатковых камісій fromfee і tofee камісія minfee не мае дачынення, мінімальная камісія для аддаецца ці атрымоўванай камісіі на дадзены момант ніяк не ўлічваецца нашай сістэмай, пазбягайце падобнага фармавання курса. Глядзіце
  • выкарыстання
  • <fromfee> – дадатковая камісія, якая не ўваходзіць у курс абмену і спаганяецца з сумы, якую кліент пераводзіць у абменны пункт. Указваецца з кодам нацыянальнай валюты. Прыклад: <fromfee>2.15 EUR</fromfee> Замест кода нац. валюты магчыма таксама выкарыстанне знака % для абазначэння працэнтнай дадатковай камісіі;
  • <tofee> – дадатковая камісія, якая не ўваходзіць у курс абмену і спаганяецца з сумы, якую абменны пункт пераводзіць кліенту. Указваецца з кодам нацыянальнай валюты. Прыклад: <tofee>30 RUB</tofee> Замест кода нац. валюты магчыма таксама выкарыстанне знака % для абазначэння працэнтнай дадатковай камісіі;
  • <minamount> – мінімальная магчымая да абмену сума валюты, якую абменны пункт прымае ад кліента. Указваецца з кодам нацыянальнай валюты. Прыклад: <minamount>4.1 USD</minamount> Калі абмежаванняў па мінімальнай суме некалькі, напрыклад, асобна на прыём і на выплату, неабходна ўказваць у поле minamount максімальнае значэнне такога абмежавання, сканвертаванае ў валюту from. Калі няма магчымасці выбраць максімальнае значэнне з некалькіх значэнняў мінімальных сум, неабходна ўказаць дадатковыя палі minamount з асобнай мінімальнай сумай у кожным;
  • <maxamount> – максімальная магчымая да разавага абмену сума валюты, якую абменны пункт прымае ад кліента. Указваецца з кодам нацыянальнай валюты. Прыклад: <maxamount>5000 USD</maxamount> Калі абмежаванняў па максімальнай суме некалькі, напрыклад, асобна на прыём і на выплату, неабходна ўказваць у поле maxamount мінімальнае значэнне такога абмежавання, сканвертаванае ў валюту from. Калі няма магчымасці выбраць мінімальнае значэнне з некалькіх значэнняў максімальных сум, неабходна ўказаць дадатковыя палі maxamount з асобнай максімальнай сумай у кожным;
  • <param> – дадзены элемент служыць для ўказання дадатковых пазнак, такіх як:
  • manual – пазнака павінна ўказвацца для напрамкаў абмену, якія апрацоўваюцца праз аператара ўручную, або калі абмен па накіраванні ажыццяўляецца з затрымкамі (не маментальна);
  • juridical – абменны пункт вырабляе пераводы сродкаў на банкаўскі рахунак кліента з рахунку юрыдычнай асобы або ІП. Дадзеная пазнака актуальная да ўстаноўкі толькі ў напрамках * —› Любы Банк;
  • cardverify – пры правядзенні абмену абменны пункт можа патрабаваць ад кліента верыфікаваць банкаўскую картку;
  • verifying – пры правядзенні абмену абменны пункт можа патрабаваць ад кліента дакументы, якія сведчаць яго асобу;
  • floating - плаваючы курс, які не фіксуецца ў заяўцы. Пры гэтым сума абмену можа змяніцца на момант адпраўкі сродкаў кліенту;
  • otherin – прыём грашовых сродкаў ад кліента робіцца на іншую аплатную сістэму, а не на тую, што пазначана ў полі from;
  • otherout – выплата грашовых сродкаў кліенту робіцца з іншай аплатнай сістэмы, а не з той, што пазначана ў полі to;
  • reg – для правядзення абмену карыстальнік абавязкова павінен зарэгістравацца на сайце абменнага пункта;
  • card2card – абменны пункт прымае сродкі ад карыстальнікаў перакладамі Card2Card (не праз картачны мерчант). Дадзеная пазнака актуальная да ўсталёўкі толькі ў кірунках Visa/MasterCard —› *.
  • Калі пазнак некалькі, яны паказваюцца праз коску.
  • Прыклад:<param>manual, floating</param>
  • <city> – для ўказання горада, у якім абменны пункт вырабляе ўвод/вывад электронных грошай на наяўныя грошы. Гэта поле мае сэнс паказваць толькі для кірункаў з наяўнымі. Экспартны файл можа змяшчаць напрамкі абменаў з рознымі названымі гарадамі.Прыклад: <city>MSK</city>
  • Пастаянныя камісіі плацежных сістэм не павінны ўказвацца ў экспартным файле курсаў. Наш маніторынг улічвае іх самастойна.