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