Technická dkumentace Varianta Standard mbank S.A., se sídlem ul. Senatrska 18, 00-950 Warszawa, Plsk, zapsaná v Celstátním sudním rejstříku (KRS) Rejstříku pdnikatelů vedeném u Obvdníh sudu hl. m. Varšavy, XII. hspdářské ddělení, pd číslem KRS0000025237, REGON: 001254524, vyknávající bankvní činnst na území České republiky prstřednictvím pbčky banky mbank S.A., rganizační slžka, se sídlem Sklvská 668/136d, 186 00 Praha 8, IČ: 27943445, zapsaná v bchdním rejstříku vedeném Městským sudem v Praze, ddíl A, vlžka 58319
Obsah Ppis dkumentu... 3 Obecné infrmace službě mtransfer... 3 Jak funguje služba mtransfer... 3 Zabezpečení... 3 Varianty... 3 Technický ppis systému... 3 Definice pjmů... 4 Aktivace a nastavení služby mtransfer... 4 Definice rzhraní a umístění dkazu... 6 Vstupní parametry... 8 Příklad zdrjvéh kódu... 8 Ppis prvádění plateb... 9 Přihlášení d internetvéh bankvnictví... 9 Zbrazení detailů transakce... 10 Autrizace platby SMS... 10 Výsledek platby... 11 Přesměrvání na návratvu stránku... 11 Pzitivní URL... 12 Negativní URL... 12 Testvání a uvedení d prvzu... 12 mbank S.A., se sídlem ul. Senatrska 18, 00-950 Warszawa, Plsk, zapsaná v Celstátním sudním rejstříku (KRS) Rejstříku pdnikatelů vedeném u Obvdníh sudu hl. m. Varšavy, XII. hspdářské ddělení, pd číslem KRS0000025237, REGON: 001254524, vyknávající bankvní činnst na území České republiky prstřednictvím pbčky banky mbank S.A., rganizační slžka, se sídlem Sklvská 668/136d, 186 00 Praha 8, IČ: 27943445, zapsaná v bchdním rejstříku vedeném Městským sudem v Praze, ddíl A, vlžka 58319
Ppis dkumentu Tent dkument bsahuje pdrbné infrmace službě mtransfer včetně pstupu implementace na webvu stránku a ppisu běžnéh užívání systému. Dkument je určen sbám dpvídajícím za tázky z blasti bchdu a infrmatiky spjené se zavedením a údržbu služby mtransfer. Obecné infrmace službě mtransfer Jak funguje služba mtransfer Služba mtransfer umžňuje zákazníkům mbank dispnujícím účtem mknt či mknt Business realizvat nline platby na účet bchdníka prstřednictvím platebníh tlačítka umístěnéh na webvé stránce internetvéh bchdu případně v e-mailu. Platby zákazníků uskutečněné prstřednictvím služby mtransfer se připisují na speciální účet bchdníka mkntbusiness se službu mtransfer v případě varianty PRO, neb na pdnikatelský účet mknt Business s aktivvanu službu mtransfer v případě varianty Standard. Transakce z účtu zákazníka na účet bchdníka je prvedena kamžitě p dknčení platby. Celá transakční částka je připsána na účet bchdníka. Úrk na účtu bchdníka se řídí stávající úrkvu sazbu k tmut typu účtu. Infrmace prvedené transakci jsu dstupné v transakční histrii účtu. Pplatek za vedení služby se zapčítává d data aktivace účtu mknt Business se službu mtransfer v případě varianty PRO, resp. d data aktivace služby mtransfer na pdnikatelském účtu mknt Business v případě varianty Standard. Zabezpečení Prvádění transakcí ze strany zákazníka je zabezpečen internetvu relací šifrvanu prtklem SSL přístupnu na základě správné kmbinace identifikačníh čísla klienta a hesla a dále ptvrzením transakce prstřednictvím SMS. P přihlášení d internetvéh bankvnictví nemá zákazník přístupné jiné perace krmě příslušné transakce. Varianty V rámci systému mtransfer mbank má bchdník na výběr dvě varianty služeb, umžňující nline platby: a) Varianta Standard b) Varianta Pr S hledem na ptřeby menších internetvých bchdů mbank nabízí jedndušší variantu služby Standard. Varianta Pr je určena především velkým internetvým bchdům, které mají zájem širší splupráci, vyžadují pkrčilejší kntrlu nad platbami, případně ptřebují platební systém integrvat s dalšími systémy. Varianta Pr zahrnuje navíc bchdníkům umžňuje: Definvat vlastní návratvé stránky (pzitivní a negativní URL) Přijímat nline servervé ntifikace (NPM) Přijímat CSV výpisy desílané každu hdinu frmu šifrvaných subrů bsahujících údaje veškerých transakcích v daný den. Tent dkument ppisuje způsb implementace pr variantu Standard. Technický ppis systému Aby bchdník mhl prstřednictvím služby mtransfer přijímat platby ve variantě Standard, musí splnit následující pdmínky: 1) Otevřít si v mbank pdnikatelský účet mknt Business 2) Aktivvat v internetvém bankvnictví službu mtransfer 3) Umístit na svůj internetvý bchd speciální dkaz pr prvedení platby mbank S.A., se sídlem ul. Senatrska 18, 00-950 Warszawa, Plsk, zapsaná v Celstátním sudním rejstříku (KRS) Rejstříku pdnikatelů vedeném u Obvdníh sudu hl. m. Varšavy, XII. hspdářské ddělení, pd číslem KRS0000025237, REGON: 001254524, vyknávající bankvní činnst na území České republiky prstřednictvím pbčky banky mbank S.A., rganizační slžka, se sídlem Sklvská 668/136d, 186 00 Praha 8, IČ: 27943445, zapsaná v bchdním rejstříku vedeném Městským sudem v Praze, ddíl A, vlžka 58319
Definice pjmů Obchdník = Osba, která v systému mtransfer přijímá platby d zákazníků na svůj účet mknt Business se službu mtransfer. Zákazník = Osba, která se službu mtransfer desílá platby ze svéh účtu mknt neb mknt Business na účet bchdníka. Úspěšné prvedení platby = Krektní dknčení platby se službuu mtransfer, p kterém se klientvi zbrazí pzitivní URL Neúspěšné prvedení platby = Chybné dknčení platby, kdy zákazník: Pužil chybný autrizační SMS kód. Stiskl tlačítk Strn neb Knec. Pzitivní URL = Adresa webvé stránky na níž je zákazník přesměrván p úspěšném prvedení platby Negativní URL = Adresa webvé stránky na níž je zákazník přesměrván p neúspěšném prvedení platby, například když se dhlásí z internetvéh bankvnictví před dknčením platby. Dispnent účtu pužívá stejné identifikační čísl klienta a přístupvé hesl bez hledu na pčet účtů, kterými v mbank dispnuje. Aktivace a nastavení služby mtransfer Pr registraci služby mtransfer se přihlaste d internetvéh bankvnictví mbank a jděte d firemníh prfilu. V menu zvlte mžnst Mje Finance > Účty > mknt Business > mtransfer (zaregistrvat službu) Zřízení služby mtransfer Standard, krk 1/6: Detail účtu mknt Business p přihlášení d internetvéh bankvnictví ve firemním prfilu.: Zřízení služby mtransfer Standard, krk 2/6 Vyberte Mje Finance. mbank S.A., se sídlem ul. Senatrska 18, 00-950 Warszawa, Plsk, zapsaná v Celstátním sudním rejstříku (KRS) Rejstříku pdnikatelů vedeném u Obvdníh sudu hl. m. Varšavy, XII. hspdářské ddělení, pd číslem KRS0000025237, REGON: 001254524, vyknávající bankvní činnst na území České republiky prstřednictvím pbčky banky mbank S.A., rganizační slžka, se sídlem Sklvská 668/136d, 186 00 Praha 8, IČ: 27943445, zapsaná v bchdním rejstříku vedeném Městským sudem v Praze, ddíl A, vlžka 58319
Zřízení služby mtransfer Standard, krk 3/6 Vyberte Účty. Zřízení služby mtransfer Standard, krk 4/6 Klikněte myší na zeleně pdsvícené mknt Business. Zřízení služby mtransfer Standard, krk 5/6. Vyberte Zaregistrvat službu. mbank S.A., se sídlem ul. Senatrska 18, 00-950 Warszawa, Plsk, zapsaná v Celstátním sudním rejstříku (KRS) Rejstříku pdnikatelů vedeném u Obvdníh sudu hl. m. Varšavy, XII. hspdářské ddělení, pd číslem KRS0000025237, REGON: 001254524, vyknávající bankvní činnst na území České republiky prstřednictvím pbčky banky mbank S.A., rganizační slžka, se sídlem Sklvská 668/136d, 186 00 Praha 8, IČ: 27943445, zapsaná v bchdním rejstříku vedeném Městským sudem v Praze, ddíl A, vlžka 58319
Zřízení služby mtransfer Standard, krk 6/6 Uveďte infrmaci d části Pevná část ppisu převdu. Pté ptvrďte. Jak pevnu část ppisu transakce dpručujeme uvést dménu bchdu, např. bchdxyz.cz. P zadání infrmace d ple Pevná část ppisu převdu a ptvrzení bdržíte Vaše ID služby, které budete ptřebvat dále. Definice rzhraní a umístění dkazu Transakci zahajuje server bchdníka prstřednictvím dkazu na webvé stránce neb v e-mailu. Příklad dkazu: https://cz.mbank.eu/paymentselectinscreen?serviceid=12345678&amunt=49.99&trdate=now&descriptin=ppis%2 0bankvn%ED%20transakce&SessinId=xyz0123&OrderId=zyx3210&VS=0123456789&SS=9876543210&KS=0558 mbank S.A., se sídlem ul. Senatrska 18, 00-950 Warszawa, Plsk, zapsaná v Celstátním sudním rejstříku (KRS) Rejstříku pdnikatelů vedeném u Obvdníh sudu hl. m. Varšavy, XII. hspdářské ddělení, pd číslem KRS0000025237, REGON: 001254524, vyknávající bankvní činnst na území České republiky prstřednictvím pbčky banky mbank S.A., rganizační slžka, se sídlem Sklvská 668/136d, 186 00 Praha 8, IČ: 27943445, zapsaná v bchdním rejstříku vedeném Městským sudem v Praze, ddíl A, vlžka 58319
Odkaz se skládá z knstantních a definvaných parametrů (query string) Parametry pr query string jsu shdné s těmi, které se následně psílají d internetvéh bankvnictví mbank. Význam, délka a frmát přenášených parametrů je následující: Pvinné parametry: ServiceId = Identifikační čísl služby Řetězec slžený přesně z 8 číslic. ServiceId je genervané při registraci služby mtransfer. K jednmu účtu lze aktivvat až 50 ServiceId. Amunt = Převáděná částka Řetězec slžený maximálně z 10 znaků. Pvlenými znaky jsu číslice [0-9], (\) a (.). Desetinným separátrem je tečka. TrDate = Datum transakce Nepvinné parametry: Dpručená hdnta parametru je NOW, kdy se vlží systémvé datum serveru mbank. Frmát DDMMYYYY. Descriptin = Ppis transakce Řetězec slžený maximálně ze 140 znaků. Kódván standardní metdu URL Encde, udaná délka je před zakódváním. Pvlené znaky jsu [a-z], [A-Z], [0-9]. Pevná část ppisu transakce Mezera, 1 znak. Řetězec slžený maximálně z 35 znaků. Tat část je pr každé ServiceId vždy stejná. Jak vstupní parametr jej dplní server mbank na základě nastavení služby mtransfer v internetvém bankvnictví (viz část Chyba! Nenašiel sa žiaden zdrj dkazv. Chyba! Nenašiel sa žiaden zdrj dkazv.). Prměnná část ppisu transakce SessinId = Identifikace relace Řetězec slžený maximálně ze 104 znaků (69 před zakódváním). D tht řetězce lze zahrnut všechny ddatečné infrmace, které nemhu být začleněny d jiných parametrů dkazu, neb tat část může zůstat zcela prázdná. Řetězec slžený maximálně ze 64 znaků. Pvlené znaky jsu [a-z], [A-Z], [0-9]. OrderId = Identifikace transakce Řetězec slžený maximálně ze 32 znaků. Pvlené znaky jsu [a-z], [A-Z], [0-9]. VS = Variabilní symbl bankvní transakce. Řetězec slžený maximálně z 10 znaků. Pvlené znaky jsu [0-9]. KS = Knstantní symbl bankvní transakce. Řetězec slžený maximálně z 4 znaků. Pvlené znaky jsu [0-9]. SS = Specifický symbl bankvní transakce. Řetězec slžený maximálně z 10 znaků. mbank S.A., se sídlem ul. Senatrska 18, 00-950 Warszawa, Plsk, zapsaná v Celstátním sudním rejstříku (KRS) Rejstříku pdnikatelů vedeném u Obvdníh sudu hl. m. Varšavy, XII. hspdářské ddělení, pd číslem KRS0000025237, REGON: 001254524, vyknávající bankvní činnst na území České republiky prstřednictvím pbčky banky mbank S.A., rganizační slžka, se sídlem Sklvská 668/136d, 186 00 Praha 8, IČ: 27943445, zapsaná v bchdním rejstříku vedeném Městským sudem v Praze, ddíl A, vlžka 58319
Pvlené znaky jsu [0-9]. URI = <knstantní_část_uri>?<query_string> Všechny jedntlivé parametry v dkazu jsu ddělené prstřednictvím separátru & a následují p části adresy paymentselectinscreen?. Na přadí parametrů v dkazu nezáleží. Parametry dkazu jsu přenášeny metdu HTTP GET přes prtkl HTTPS na stránku mtransfer.asp umístěnu na serveru mbank. Hdnty všech přenášených parametrů se kódují standardní metdu URLEncde, udaná délka parametrů je před zakódváním. Názvy parametrů query stringu dpručujeme zadávat jak case-sensitive. Výstupní parametry budu stejné jak vstupní, pkud je zákazník v průběhu platby nezměnil. Parametry lze regulérně měnit prstřednictvím frmuláře v prvním krku platby. Upzrnění: Pkud zákazník prvede změnu parametrů v dkazu, platba se prvede, prt je třeba všechny parametry plateb na straně bchdníka kntrlvat. Vstupní parametry V dkazu na stránku mbank jsu přenášeny následující parametry: ServiceId Amunt TrDate Descriptin SessinId OrderId VS KS SS Příklad: https://cz.mbank.eu/paymentselectinscreen?serviceid=12345678&amunt=49.99&trdate=now&descriptin=ppis %20bankvn%ED%20transakce&SessinId=xyz0123&OrderId=zyx3210&VS=0123456789&SS=9876543210&KS=0558 Příklad zdrjvéh kódu Pstup implementace: 1) Aktivace služby, definující adresu pr NPM ntifikaci, pzitivní a negativní návratvu stránku 2) Vytvření webvé stránky bsahující dkaz pr přesměrvání na platbu s příslušným ServiceID pr danu dménu (mtransfer_start.asp) 3) Otevření stránky s dkazem pr přesměrvání na platbu v prhlížeči a prvedení testvací transakce. Příklad: mtransfer_start.asp <%@LANGUAGE="VBScript"%> <% '----------------------------------------------------- ' mtransfer link example - ASP '----------------------------------------------------- Dim ADDRESS mbank S.A., se sídlem ul. Senatrska 18, 00-950 Warszawa, Plsk, zapsaná v Celstátním sudním rejstříku (KRS) Rejstříku pdnikatelů vedeném u Obvdníh sudu hl. m. Varšavy, XII. hspdářské ddělení, pd číslem KRS0000025237, REGON: 001254524, vyknávající bankvní činnst na území České republiky prstřednictvím pbčky banky mbank S.A., rganizační slžka, se sídlem Sklvská 668/136d, 186 00 Praha 8, IČ: 27943445, zapsaná v bchdním rejstříku vedeném Městským sudem v Praze, ddíl A, vlžka 58319
ADDRESS="https://cz.mbank.eu/" Dim SessinNum Applicatin.Lck Applicatin("SessinNum")=Applicatin("SessinNum")+1 SessinNum=Applicatin("SessinNum") Applicatin("Sessin"&SessinNum)="START" Applicatin.UnLck VariableDescriptin="Any descriptin yu wish." OrderId="Any rderid yu are able t generate." VS="Any bank indetifier yu wish." SS="Input crrect bank identifier." KS="Input crrect bank identifier." %> <a href=" <% Respnse.Write (ADDRESS&"/paymentSelectinScreen?ServiceId=12345678&Amunt=0.01&TrDate="nw"&Descriptin="& VariableDescriptin"&SessinId="&SessinNum"&OrderId="&OrderId"&VS="&VS"&SS="&SS"&KS="&KS) ) %>"> Zaplatit přes mtransfer </a> <br> <% Respnse.Write "<br>--------------------------------<br>sessin:"&sessinnum %> Ppis prvádění plateb Zákazník prvádí platby prstřednictvím internetvéh bankvnictví mbank, kam je přesměrván speciálním dkazem bsahujícím parametry dané platby. Přihlášení d internetvéh bankvnictví Pté je přesměrván na přihlašvací stránku internetvéh bankvnictví mbank, kde se přihlásí prstřednictvím identifikačníh čísla klienta a hesla. mbank S.A., se sídlem ul. Senatrska 18, 00-950 Warszawa, Plsk, zapsaná v Celstátním sudním rejstříku (KRS) Rejstříku pdnikatelů vedeném u Obvdníh sudu hl. m. Varšavy, XII. hspdářské ddělení, pd číslem KRS0000025237, REGON: 001254524, vyknávající bankvní činnst na území České republiky prstřednictvím pbčky banky mbank S.A., rganizační slžka, se sídlem Sklvská 668/136d, 186 00 Praha 8, IČ: 27943445, zapsaná v bchdním rejstříku vedeném Městským sudem v Praze, ddíl A, vlžka 58319
Zbrazení detailů transakce P přihlášení se zákazníkvi zbrazí stránka s detaily transakce. Zákazníkvi je nabídnut k transakci seznam účtů, které splňují následující pdmínky: Jedná se mknt neb mknt Business Zákazník je majitelem, splumajitelem neb všebecným dispnentem účtu Pr každý z účtů zákazníka je uveden jeh druh a čísl včetně dstupných finančních zdrjů. V nastavení služby mtransfer je mžné zákazníkvi pvlit editaci následujících plí: Ppis transakce (prměnná část ppisu transakce) a Částka Datum perace (zákazník může libvlně změnit datum platby) Zákazníkvi jsu dstupné tyt funkce: Strn Pkračvat V případě stisknutí tlačítka Strn je zákazník přesměrván na negativní URL a transakce se neprvede. Autrizace platby SMS Při vlbě Pkračvat se zbrazí stránka, kde je nutné platbu ptvrdit unikátním SMS kódem zaslaným na mbilní telefn registrvaný v mbank. Zákazník má dstupné tyt funkce: Zpět, Upravit, Ptvrdit, Ptvrdit pzději. V prvních dvu uvedených případech je zákazník přesměrván na předcházející stránku. V případě, že zákazník zvlí pslední mžnst, platba není prvedena a je na jeh účtu v internetvém bankvnictví zařazena mezi Operace k autrizaci. mbank S.A., se sídlem ul. Senatrska 18, 00-950 Warszawa, Plsk, zapsaná v Celstátním sudním rejstříku (KRS) Rejstříku pdnikatelů vedeném u Obvdníh sudu hl. m. Varšavy, XII. hspdářské ddělení, pd číslem KRS0000025237, REGON: 001254524, vyknávající bankvní činnst na území České republiky prstřednictvím pbčky banky mbank S.A., rganizační slžka, se sídlem Sklvská 668/136d, 186 00 Praha 8, IČ: 27943445, zapsaná v bchdním rejstříku vedeném Městským sudem v Praze, ddíl A, vlžka 58319
Pkud zákazník zadá Ptvrdit, zbrazí se výsledek platby. Výsledek platby P autrizaci transakce je klient přesměrván na stránku s ptvrzením prvedení transakce a platba je bezprstředně realizvána neb je v případě pzdější splatnsti naplánvána jak buducí perace. Peníze jsu převedeny na účet bchdníka kamžitě v den splatnsti, tat perace se pvažuje za standardní transakci zpplatněnu dle sazebníku mbank. Pkud se zákazník nedhlásí vlbu Odhlásit se, je p stanveném časvém intervalu autmaticky dhlášen a přesměrván na návratvu stránku. Přesměrvání na návratvu stránku Jak p prvedení transakce tak případně p předčasném strnvání je zákazník dhlášen a přesměrván na návratvu stránku bchdníka (pzitivní neb negativní URL). Implicitní návratvé stránky mbank jsu: http://inf.mbank.cz/mtransfer_pzitivni.html http://inf.mbank.cz/mtransfer_negativni.html Ve variantě Standard jsu tyt stránky předdefinvané a nelze je měnit. mbank S.A., se sídlem ul. Senatrska 18, 00-950 Warszawa, Plsk, zapsaná v Celstátním sudním rejstříku (KRS) Rejstříku pdnikatelů vedeném u Obvdníh sudu hl. m. Varšavy, XII. hspdářské ddělení, pd číslem KRS0000025237, REGON: 001254524, vyknávající bankvní činnst na území České republiky prstřednictvím pbčky banky mbank S.A., rganizační slžka, se sídlem Sklvská 668/136d, 186 00 Praha 8, IČ: 27943445, zapsaná v bchdním rejstříku vedeném Městským sudem v Praze, ddíl A, vlžka 58319
Pzitivní URL Negativní URL Testvání a uvedení d prvzu Před spuštěním d stréh prvzu dpručujeme prvést testvání. Testvání prbíhá na prvzním účtu bchdníka, pr tyt účely nejsu mbank zřizvány testvací účty. Pr testvací bjednávku dpručujeme nastavit parametr Amunt=0.01. Dpručený pstup testvání: 1) Kntrla iniciace platby přes mtransfer z webvé stránky bchdníka za pužití sbníh účtu mknt 2) Kntrla správnsti vstupních parametrů a krektníh dknčení transakce 3) Kntrla testvacích plateb v transakční histrii účtu Pravidla pr umístění prpagační ikny služby mtransfer Pr realizace prpagace je nutné bchd značit pdle stanvených pdmínek iknu dkazující na infrmační stránky http://www.mbank.cz/firemni/sluzby/mtransfer/ Pr umístění prpagační ikny služby mtransfer pžijte následující HTML kód: <a href="http://www.mpenize.cz/" title="www.mpenize.cz"> <img src="http://www.mbank.cz/mpenize.gif" alt="ikna mpeníze" brder="0"> </a> Jakákliv změna grafické pdby neb pužití iknky jak platebníh dkazu není dvlena. Nepužívejte prpagační iknu jak platební dkaz. K tmut účelu prsím pužijte text, který bude bsahvat název platebníh systému mtransfer například Zaplatit přes mtransfer, viz příklad v části Chyba! Nenašiel sa žiaden zdrj dkazv.. mbank S.A., se sídlem ul. Senatrska 18, 00-950 Warszawa, Plsk, zapsaná v Celstátním sudním rejstříku (KRS) Rejstříku pdnikatelů vedeném u Obvdníh sudu hl. m. Varšavy, XII. hspdářské ddělení, pd číslem KRS0000025237, REGON: 001254524, vyknávající bankvní činnst na území České republiky prstřednictvím pbčky banky mbank S.A., rganizační slžka, se sídlem Sklvská 668/136d, 186 00 Praha 8, IČ: 27943445, zapsaná v bchdním rejstříku vedeném Městským sudem v Praze, ddíl A, vlžka 58319