2.0 Implementační manuál PayU pro e-shopy s využitím šablony www.payu.cz
Obsah 1. Úvod 2. Od registrace po spuštění PayU 2.1 Obecné informace 2.2 Popis jednotlivých kroků 3. Implementace PayU 3.1 Obecné informace 3.2 Termíny a ustálené výrazy používané v aplikaci 3.3 Integrace s PayU 3.3.1 Konfigurační data 3.3.2 URL adresy aplikace PayU a dostupné procedury 3.3.3 Kódování 3.3.4 Formát dat 3.3.5 Vytvoření nové platby 3.4 Výměna informací o transakcích 3.4.1 Oznámení změny statusu transakce Obchodu 3.4.2 Rozeznávání statusu transakce 3.4.3 Přijetí platby 3.4.4 Zamítnutí platby 3.4.5 Status dokončení operace 3.5 Struktura návratových adres UrlPositive a UrlNegative 3.6 Kontrolní součty MD5 3.6.1 Kontrolní součet parametrů předávaných do nové platby 3.7 Testování 4. Vzhled platební brány PayU na e-shopu 4.1 Vizualizace a popis platebních metod 4.2 Implementace 4.3 Nákupní proces a uživatelsky přívětivá implementace 4.4 Optimalizace nákupního procesu 4.5 Navigace a vizualizace 4.6 Rychlost a konverze 4.7 Funkční šablona 4.8 Edukace zákazníků a marketing 5. Povinné parametry implementace 6. Administrace PayU účtu 6.1 Obecné informace 6.2 Uživatelské rozhraní PayU 6.3 Vytvoření Obchodu a POSu 6.4 Transakce 6.5 Vyúčtování, Výběry a Vrácené platby 6.6 Výběry 6.7 Výpisy PDF/CSV/ABO 6.8 Statistiky 6.9 Nastavení oznámení 6.10 Uživatelské účty 4 5 6 7 13 14 14 15 15 15 15 16 16 21 21 22 25 25 25 27 28 29 30 31 32 32 33 33 34 34 35 35 37 39 40 40 41 47 54 56 59 65 67 67
7. Přílohy Příloha 1 Typy plateb Příloha 2 Statusy transakcí Příloha 3 Přechody mezi statusy transakce Příloha 4 Kódy chyb Příloha 5 Příloha 5 Ukázka php skriptu, který zjišťuje stav transakce Příloha 6 PayU šablony (templates) Příloha 7 Ukázka implementace PayU Příloha 8 Změny v manuálu podle verzí 70 71 72 73 75 76 80 81 83
Úvod 1 PayU je nejrychleji rostoucí poskytovatel on-line plateb v České republice. Je českou verzí úspěšné služby, která funguje v Evropě již od r. 2005. Využívá jedinečné know-how a několikaletou zkušenost z e-commerce trhu ve střední a východní Evropě. Společnost PayU Czech Republic, s.r.o. byla založena v roce 2011 technologickou společností Naspers, která působí na on-line trhu v USA, Číně, Brazílii, Africe, Rusku nebo Polsku a mnoha dalších zemích včetně České republiky. Díky tomuto silnému mezinárodnímu zázemí nabízí PayU kompletní platební služby spojené se zpracováním transakcí, přináší inovativní technologie, bezpečnost a kontinuální vývoj služeb. Cílem PayU je neustále přinášet rychlé a bezpečné platební řešení, které umožní zjednodušovat proces platby pro nakupující a přispívat tak k zvyšování konverze na prodejních platformách. Tato příručka má usnadnit e-shopům a partnerům implementaci platební brány PayU. V několika jednoduchých krocích je zde vysvětleno jak se do PayU registrovat, jak probíhá technická integrace, jaké jsou možnosti vizualizace nabízených platebních metod, popisuje a vysvětluje funkce a administraci PayU účtu. Cílem této příručky je dát návod k co nejlepší implementaci platební brány PayU. Ta je předpokladem k tomu využít všech vlastností a funkcí, které Vám PayU na Vaši obchodní platformu přináší. Příručka je složena ze sedmi barevně odlišených částí. Každá část přináší ucelený set informací o konkrétní oblasti implementace nebo práce se systémem PayU. 4
Od registrace po 2 spuštění PayU
2.1 Obecné informace 2 V této části je v jednoduchých krocích popsán proces zavedení platební brány od registrace až po úspěšné spuštění. Schéma na obrázku přehledně znázorňuje kroky potřebné k zavedení platební brány PayU na e-shop: registrace na www.payu.cz smlouva technická implementace dle technické dokumentace Implementace platební brány PayU spuštění ostrého provozu aktivace platebních metod dle smlouvy testovací platba 6
2.2 Popis jednotlivých kroků 2 Zákazník (e-shop) PayU obchodní oddělení PayU zákaznický servis 1. informace o PayU www.payu.cz 2. registrace, vytvoření účtu PayU (login a heslo) 5. login do účtu PayU, založení SHOP a POS a implementace 3. zaslání smlouvy a smluvních podmínek 4. aktivace účtu a testovací platby 6. podpis smlouvy a zaslání do PayU AML identifikace 7. nastavení nasmlouvaných platebních metod na založený POS a aktivace 8. testovací platba 9. žádost o aktivaci platebních metod obchodní oddělení 10. ověření testovací platby, aktivace a kontrola 1. 2. 3. 4. 5. Webové stránky www.payu.cz obsahují všechny důležité informace týkající se společnosti PayU a jejího platebního řešení. Nezávazná registrace na http://registrace.payu.cz/?p=6 Tato registrace slouží k získání informací pro pozdější vytvoření uživatelského účtu a první kontakt. Je důležité uvést firemní údaje podle obchodního rejstříku a správné kontaktní informace. Na základě rozhovoru Vám obchodní zástupce připraví nabídku provizních hladin pro jednotlivé typy plateb. Poté, co jsou Vámi odsouhlaseny, je zaslán návrh smlouvy k podpisu. Kopie smlouvy je zaslána na zákaznický servis PayU, který zkontroluje údaje ve smlouvě oproti registraci. Pokud údaje souhlasí, může být aktivován PayU účet. Údaje pro první přihlášení Vám budou zaslány emailem. Následně je možné nastavit potřebné parametry účtu pro implementaci. Zároveň můžete také využít funkce testovací platby. Správně provedená testovací platba je nedílnou součástí implementace a bez ní není možné implementaci úspěšně dokončit. Nyní je možné přihlásit se do účtu PayU a začít s implementací. 7
Základní nastavení PayU účtu pro spuštěni implementace: 2 5.1 Nastavení Obchodu (Shopu) Zvolte Platby online > Můj Obchod > Přidat obchod V prvním kroku je potřeba definovat webovou adresu Obchodu, uvést název Obchodu (případně také jeho popis) a vybrat požadovanou měnu, ve které budou platby procesovány. Máte-li zájem zpracovávat ve svém Obchodu platby v eurech, musí být tato skutečnost uvedena ve smlouvě s PayU. Pokud máte zájem využívat platební systém PayU na jiné webové adrese, než jaká je uvedena během registrace, můžete tuto adresu v účtu nastavit. V takovém případě je však nutné, aby byl vytvořen dodatek ke smlouvě s PayU, kde bude preferována nebo nová webová adresa definována. 8
2 5.2 Nastaveni POSu ( point of sale, platební místo) Pro nastavení hodnot nového POSu je potřeba zadat následující údaje: a) Název platebního místa b) Chybová návratová adresa (URL adresa, kam bude plátce přesměrován, pokud se transakci nepodaří autorizovat) c) Správná návratová adresa (URL adresa, kam bude plátce přesměrován, pokud se prvotní autorizace transakce jeví jako úspěšná) d) Adresa pro oznámení o statusu (URL adresa, kam bude zasílána informace o změně statusu platby prostřednictvím metody POST) e) Kódování dat (způsob kódování znaků) 9
2 5.3 Konfigurace platebního místa Jakmile máte přidaný POS, klikněte na něj v seznamu POS. Otevře se vám konfigurace platebního místa. V této konfiguraci jsou některé velmi důležité údaje, které budete potřebovat pro implementaci platební brány. Jedná se o tyto údaje: 10
Po absolvování tohoto kroku můžete začít implementovat, jak je popsáno v kapitole 3 za podmínek uvedených v kapitole 5, a provádět testovací transakce, jak je popsáno v kapitole 3.7. 2 6. Zkontrolujte smlouvu od PayU, podepište a odešlete na adresu: PayU Czech Republic, s. r. o. Karolinská 650/1 186 00, Praha Karlín Dodejte také požadované údaje o identifikaci firmy nebo fyzické osoby podle zákona č. 253/2008 Sb., o některých opatřeních proti legalizaci výnosů z trestné činnosti a financování terorismu. 7. Ve chvíli, kdy obdrží PayU podepsanou smlouvu, přidá zákaznický servis smluvené platební metody k vašemu obchodnímu místu. V seznamu POS to bude vypadat takto: 11
8. Dokončete implementaci. Proveďte testovací platbu. Nesmí se zobrazovat žádné chybové hlášky. Seznam chybových hlášek najdete v příloze č. 4. Nahlaste úspěšné zakončení implementace zákaznickému servisu PayU pomocí kontaktního formuláře ve Vašem PayU účtu: 2 9. Pro aktivaci platebních metod uvedených ve smlouvě kontaktujte svého obchodního zástupce v PayU nebo zašlete požadavek na obchod@payu.cz. 10. Na základě Vašeho požadavku na obchodní oddělení a kontroly implementace dle kapitoly 5 Vám budou na Vašem POSu aktivovány jednotlivé platební metody. Můžete začít přijímat platby přes platební bránu PayU. 12
Implementace 3 PayU
3.1 Obecné informace 3 Tento praktický průvodce implementací platební brány PayU obsahuje informace pro technickou integraci s obchodní platformou. 3.2 Termíny a ustálené výrazy používané v aplikaci PayU Aplikace na zpracování plateb. Společnost Společnost používající aplikaci PayU pro příjem plateb od Zákazníků. Obchod Online obchod přijímající platby; jedna Společnost může provozovat několik Obchodů. POS Platební místo (point of sale) zpracovávající obdržené platby; pro daný POS jsou definovány všechny parametry služby; jeden Obchod může provozovat několik POS. Zákazník Osoba vykonávající platbu. UrlPayU URL adresa, na které je nainstalována aplikace PayU: https://secure.payu.com/paygw/ UrlPositive URL adresa aplikace Obchodu, kam bude Zákazník přesměrován po úspěšném zahájení transakce. UrNegative URL adresa aplikace Obchodu, kam bude Zákazník přesměrován po neúspěšném zahájení transakce. UrlOnline URL adresa aplikace Obchodu, kam budou zasílány oznámení o změně statusu platby prostřednictvím metody POST. 14
3.3 3.3.1 Integrace s PayU Konfigurační data 3 V aplikaci PayU může mít každý Obchod několik POS. Pro každý POS mohou být definovány následující URL adresy: UrlPositive (Správná návratová adresa), UrlNegative (Chybná návratová adresa) a UrlOnline (Adresa pro oznámení). PayU přiděluje každému vytvořenému POSu sadu konfiguračních klíčů, která se skládá z identifikátoru POSu (pos_id), řetězců kódů key1 a key2 (viz kapitola 3.6) a autorizačního klíče (pos_auth_key). Všechny tyto údaje jsou dostupné v uživatelském rozhraní PayU po vytvoření POSu. Uvedené konfigurační klíče můžete nalézt po kliknutí na: Moje obchody > Název obchodu > Seznam POS > Název POSu 3.3.2 URL adresy aplikace PayU a dostupné procedury URL adresa aplikace PayU se tvoří tímto způsobem: URL = UrlPayU/Kodovani/NazevProcedury kde UrlPayU základní adresa aplikace PayU, tj. https://secure.payu.com/paygw/ Kodovani jedna z následujících hodnot: ISO, UTF, WIN NazevProcedury jedna z následujících hodnot: NewPayment, Payment/get, Payment/confirm, Payment/cancel 3.3.3 Kódování V závislosti na znakové sadě, kterou používá aplikace Obchodu, volí Obchod kódování znaků také při odkazování na procedury PayU: název v PayU použité kódování ISO ISO-8859-2 UTF UTF-8 WIN Windows-1250 15
3.3.4 Formát dat 3 Pro následující procedury: Payment/get, Payment/confirm a Payment/cancel může být níže uvedeným způsobem specifikován také formát odesílaných údajů. URL = UrlPayU/Kodovani/NazevProcedury/Format Format může nabývat hodnot xml nebo txt. Výchozí hodnotou je xml. 3.3.5 Vytvoření nové platby Zjednodušeně probíhá platba prostřednictvím systému PayU způsobem, který je zobrazen na níže uvedeném schématu: 7. PayU informuje e-shop o změně statusu transakce PayU 3. E-shop zasílá do PayU formulář nové platby E-shop 1. Výběr zboží/služby na stránkách e-shopu 2. Výběr platební brány v šabloně PayU 6. Banka informuje PayU o provedení platby Banka 4. Zákazník je přesměrován do banky, kde zaplatí 5. Po provedení platby je zákazník přesměrován zpět na stránku e-shopu K vytvoření nové platby je na webovou stránku Obchodu potřeba umístit formulář, který přesměruje Zákazníka na PayU na proceduru NewPayment (seznam procedur PayU viz kapitola 3.3.2). Doporučuje se použití metody POST; není-li to možné, lze použít také metodu GET. 16
Parametry nové platby jsou následující: 3 parametr povinné pole typ dat popis pos_id ano INT hodnota, kterou přidělilo PayU pos_auth_key ano STR {7,7} hodnota, kterou přidělilo PayU session_id ano STR {1,1024} ID platby musí být pro každou transakci jedinečné amount ano NUM {1,10} částka v haléřích desc ano STR {1,50} krátký popis objevuje se Obchodu ve výpisech transakcí order_id ne STR {1,1024} číslo objednávky desc2 ne STR {0,1024} libovolná informace first_name ano STR {0,100} jméno last_name ano STR {0,100} příjmení street ne STR {0,100} ulice street_hn ne STR {0,10} číslo popisné street_an ne STR {0,10} číslo orientační city ne STR {0,100} město post_code ne STR {0,20} PSČ country ne STR {0,100} kód krajiny zákazníka (2 písmena) dle ISO-3166 http:www.chemie.fu-berlin.de/diverse/doc/iso_3166.html email ano STR {0,100} e-mailová adresa phone ne STR {0,100} language ne ENUM client_ip ano STR {7,15} js ne ENUM ( 0, 1 ) telefonní číslo, je možné zadat několik čísel oddělených čárkami kód jazyka dle ISO-639 http:www.ics.uci.edu/pub/ietf/http/related/iso639.txt (aktuálně je možné uvádět buďto kód cs anebo en ) IP adresa zákazníka v následujícím formátu D{1,3}.D{1,3}.D{1,3}.D{1,3} tato hodnota definuje, jestli má prohlížeč zákazníka povolený JavaScript sig ano STR {32} kontrolní součet parametrů odesílaných ve formuláři ts ano STR časová známka použitá na výpočet hodnoty parametru sig 17
Ve formuláři nové platby není povinné uvádět parametry obsahující údaje o adrese plátce, pokud je to však možné, doporučujeme tyto parametry používat. Uvádění těchto informací totiž umožňuje jednodušší identifikaci plátce v případě, že je nutné spárovat platbu manuálně. Identifikace plátce má v konkrétních případech nespárování platby vliv na konverzi. Po vytvoření platby bude zákazník metodou GET přesměrován na adresu UrlPositive nebo UrlNegative. Jelikož se může stát, že se zákazník zpátky na webové stránky Obchodu nevrátí (např. zavře-li okno svého prohlížeče dříve, než může dojít k přesměrování), informace získané prostřednictvím těchto URL adres nejsou závazné a není možné na jejich základě vyvozovat žádné závěry ohledně výsledných statusů plateb. 3 Pozor! Někdy může dojít k tomu, že Zákazník omylem zvolí nevhodnou platební metodu (např. vybere banku, ve které nevlastní účet, rozhodne se pro platbu kartou, kterou ale nemá u tu chvíli u sebe atp.). Chybu si Zákazník často uvědomí až ve chvíli, kdy je přesměrován na stránku banky či zprostředkovatele karetních transakcí. V takové chvíli se Zákazník často pokusí vrátit o krok nazpět s použitím příslušného tlačítka svého internetového prohlížeče a následně zvolit jinou platební metodu. V těchto případech je nutné zajistit, aby před tím, než je na PayU odeslán nový požadavek typu NewPayment, byla vygenerována nová hodnota parametru session_id (a to navzdory tomu, že z pohledu Obchodu jde stále o jednu a tutéž objednávku). Vytvoření nového session_id je nezbytné, jelikož před přesměrováním Zákazníka do banky vytváří systém PayU transakční záznam, který obsahuje také tento parametr. Opakované použití stejné hodnoty session_id způsobí v systému chybu, která vede k zamítnutí transakce. Před odesláním požadavku typu https://secure.payu.com/paygw/encoding/newpayment je tak nutné zajistit, aby použité session_id bylo jedinečné také v těch případech, kdy Zákazník změnil zvolenou metodu platby pro realizaci téže objednávky. Jednoduchým mechanismem, zajišťujícím jedinečnost hodnoty parametru session_id, může být např. propojení interního čísla objednávky z příslušného Obchodu s časovým razítkem vygenerovaným s milisekundovou přesností (session_id = order_id + - + časové razítko). Standardní způsob vytvoření platebního formuláře využívá tzv. PayU šablony (templates). Systém PayU umožňuje výběr ze dvou typů předdefinovaných šablon. Vytvoření formuláře nové platby prostřednictvím těchto šablon je velice jednoduché a může být provedeno ve třech krocích: 1. 2. 3. Vložení JavaScript knihoven do <head> sekce HTML dokumentu Vytvoření jednoduchého formuláře s odpovídajícími parametry Vložení úryvku JavaScriptu do formuláře platby Knihovna JavaScript může být ze systému PayU načtena z této lokace: UrlPayU/Encoding/js/pos_id/KK/template:x/ext_calc:y/paytype.js 18
kde příslušné parametry znamenají následující: 3 UrlPayU Encoding pos_id KK základní adresa aplikace PayU jedna z následujících hodnot: ISO, UTF, WIN hodnota, kterou přidělilo PayU, číslo (ID) POSu první dva znaky z klíče Key1 template:x identifikátor šablony, kde x znamená číselnou hodnotu z množiny {3,4,5,6} ext_calc:y informace o tom, jestli do kalkulace hodnoty parametru sig má nebo nemá být zahrnut parametr pay_type: 1 = ano, 0 = ne Parametr template označuje, který typ předdefinované šablony bude použit. V případě potřeby je Obchodu povoleno užívanou šablonu upravit tak, aby vyhovovala jeho specifickým požadavkům. Jakékoliv úpravy šablony musí být schváleny ze strany provozovatele platebního systému PayU. Názvy a loga jednotlivých platebních kanálů a logo PayU není možné odstraňovat ani jakkoliv měnit. Parametr ext_calc označuje, jestli do kalkulace hodnoty parametru sig má být zahrnut parametr pay_type. Pokud je hodnota parametru ext_calc 0, pak parametr pay_type není zahrnutý do kalkulace parametru sig a jeho hodnota není zasílána. Pokud je hodnota parametru ext_calc 1, pak parametr pay_type je zahrnutý do kalkulace parametru sig a jeho hodnota v podobě parametru pay_ type zasílána je. JavaScript knihovny by měly být umístěny do <head> sekce HTML dokumentu (krok č. 1. uvedený výše) následujícím způsobem: <head> <script language= JavaScript type= text/javascript src= https://secure.payu.com/jsgenerator/js/ jquery-latest.js ></script> <script language= javascript type= text/javascript src= https://secure.payu.com/paygw/utf/js/pos_ id/kk/template:3/ext_calc:1/paytype.js > </script> </head> V tomto případě bude použita šablona číslo 3 (viz Příloha 6), jelikož parametru definujícímu typ šablony byla přisouzena hodnota 3. Šablona číslo 4 nabízí seznam platebních metod v tzv. drop-down variantě (viz rovněž Příloha 6). Tato šablona je dostupná po vložení následujícího odkazu do pole <head>: <head> <script language= JavaScript type= text/javascript src= https://secure.payu.com/jsgenerator/js/ jquery-latest.js ></script> 19
<script language= javascript type= text/javascript src= https://secure.payu.com/paygw/utf/js/pos_ id/kk/template:4/ext_calc:1/paytype.js > </script> </head> 3 Anglická verze šablony číslo 3 má číslo 5, anglická verze šablony číslo 4 je označena číslem 6. Rovněž anglické verze šablon naleznete v Příloze 6. V souladu s krokem 3 uvedeným výše by měl být do platebního formuláře vložen tento úryvek JavaScriptu: <script language= JavaScript type= text/javascript > PlnPrintTemplate(); </script> Příklad platebního formuláře s vloženým úryvkem: <form action= https://secure.payu.com/paygw/utf/newpayment method= POST name= payform > <input type= hidden name= pos_id value= 12345 > <input type= hidden name= pos_auth_key value= wq2io3q > <input type= hidden name= session_id value= 1234565 > <input type= hidden name= amount value= 1000 > <script language= JavaScript type= text/javascript > PlnPrintTemplate(); </script> <input type= hidden name= desc value= Payment description > <input type= hidden name= client_ip value= 123.123.123.123 > <input type= hidden name= js value= 0 > <input type= hidden name= email value= example@example.cz > <input type= hidden name= first_name value= Petr > <input type= hidden name= last_name value= Novák > <input type= submit value= Pay with PayU.cz > </form> <script language= JavaScript type= text/javascript > <!-- document.forms[ payform ].js.value=1; --> </script> 20
3.4 3.4.1 Výměna informací o transakcích Aplikace Obchodu je povinna ověřovat kontrolní součty přenášených informací. Oznámení změny statusu transakce Obchodu Každá změna statusu transakce se oznamuje aplikaci Obchodu. Na danou adresu UrlOnline pošle PayU požadavek POST včetně následujících parametrů: 3 pos_id session_id ts hodnota, kterou přidělilo PayU, identifikátor (ID) POSu hodnota zadaná Obchodem při vytvoření platby časová známka, hodnota potřebná k ověření kontrolního součtu sig kontrolní součet přenášených informací (viz kapitola 3.6) Hodnota sig počítá následujícím vzorcem: sig = md5(pos_id + session_id + ts + key2) Zpráva o změně statusu transakce neobsahuje žádné další informace. Podrobnosti transakce a její současný status MUSÍ být přečten a analyzován aplikací Obchodu mechanismy popsanými v kapitole 3.4.2. Po obdržení zmíněného požadavku MUSÍ aplikace Obchodu poslat v odpovědi nazpět řetězec OK. Pokud aplikace PayU obdrží jinou odpověď než tuto, uloží se odpověď do databáze a oznámení o změně statusu transakce se považuje za nedoručené. Aplikace Obchodu by měla počítat se situacemi, kdy je oznámení týkající se jedné transakce odesláno několikrát navzdory tomu, že se status transakce nezměnil. Odpověď OK by měla být standardně odeslána na každé takto opakovaně přijaté oznámení. Na konkrétní POS bývá v jednu chvíli zasílán vždy jeden požadavek POST, může ale dojít také k odeslání několik požadavků stejnému POS najednou. 21
Oznámení se posílají okamžitě po změně statusu transakce. Jestliže aplikace Obchodu nepotvrdí přijetí oznámení požadovaným způsobem, bude oznámení zasláno aplikaci Obchodu znovu v těchto časových periodách: 3 pokus prodleva 0-10 1 minuta 11-15 3 minuty 16-20 5 minut 21-25 10 minut 26-50 15 minut 51-75 30 minut 75-99 60 minut >=100 odesílání zastaveno 3.4.2 Rozeznávání statusu transakce Pro čtení aktuálního stavu transakce je nutné prostřednictvím metody POST vyvolat proceduru Payment/get (seznam procedur PayU viz kapitola 3.3.2) s následujícími parametry: pos_id session_id ts hodnota, kterou přidělilo PayU, identifikátor (ID) POSu hodnota zadaná Obchodem při vytvoření platby časová známka, hodnota potřebná k ověření kontrolního součtu sig kontrolní součet přenášených informací (viz kapitola 3.6) Hodnota sig se v tomto případě počítá následujícím vzorcem: sig = md5(pos_id + session_id + ts + key1) 22
V odpovědi obdrží aplikace Obchodu následující informace: 3 Formát txt : status: OK trans_id: 7 trans_pos_id: 1 trans_session_id: 417419 trans_order_id: trans_amount: 200 trans_status: 5 trans_pay_type: t trans_pay_gw_name: pt trans_desc: Platba pro shop.cz trans_desc2: trans_create: 2012-12-21 10:39:52 trans_init: 2012-12-21 10:41:03 trans_sent: 2012-12-21 10:41:44 trans_recv: trans_cancel: trans_auth_fraud: 0 trans_ts: 1094205761232 trans_sig: b6d68525f724a6d69fb1260874924759 Formát xml : <?xml version= 1.0 encoding= UTF-8?> <response> <status>ok</status> <trans> <id>7</id> <pos_id>1</pos_id> <session_id>417419</session_id> <order_id></order_id> <amount>200</amount> <status>5</status> <pay_type>t</pay_type> <pay_gw_name>pt</pay_gw_name> <desc>platba pro shopcz</desc> <desc2></desc2> <create>2012-12-21 10:39:52</create> <init>2012-12-21 10:41:03</init> <sent>2012-12-21 10:41:44</sent> <recv></recv> <cancel></cancel> <auth_fraud>0</auth_fraud> <ts>1094205828574</ts> <sig>a95dc2145079b16a3668175279c35736</sig> </trans> </response> 23
Co se týče údajů, které posílá zpátky PayU, počítá se hodnotu sig následujícím vzorcem: 3 sig = md5(pos_id + session_id + order_id + status + amount + desc + ts + key2) Popis jednotlivých polí oznámení je následující: Základní pole: pole txt pole xml popis Status responsetatus označuje stav zpracování - správně OK trans_id response/trans/id jedinečné id transakce, které přiděluje PayU trans_pos_id response/trans/pos_id id POSu, pro který byla transakce vytvořena trans_session_id trans_order_id response/transession_id response/transorder_id hodnota přidělena aplikací Obchodu při vytvoření transakce hodnota přidělena aplikací Obchodu při vytvoření transakce trans_amount response/transmount aktuální hodnota transakce v haléřích trans_status response/transtatus aktuální stav transakce v souladu s Přílohou 2 trans_pay_type response/trans/pay_type typ platby v souladu s Přílohou 1 trans_pay_gw_name trans_desc trans_desc2 response/trans/pay_gw_ name response/trans/desc response/trans/desc2 název brány vykonávající transakci interní informace aplikace PayU hodnota přidělena aplikací Obchodu při vytvoření transakce hodnota přidělena aplikací Obchodu při vytvoření transakce trans_create response/trans/create datum vytvoření transakce trans_init response/trans/init datum začátku transakce trans_sent response/trans/sent datum, kdy byla transakce předána k vybrání trans_recv response/trans/recv datum přijetí transakce trans_cancel response/trans/cancel datum zrušení transakce trans_auth_fraud response/trans/auth_fraud interní informace aplikace PayU trans_ts response/trans/ts hodnota potřebná na výpočet kontrolního součtu trans_sig response/trans/sig kontrolní součet přenášených informací 24
Další pole pro vybrané metody plateb: 3 testovací platba pole txt pole xml popis add_test response/trans/add_test vždy hodnota 1 add_testid response/trans/add_testid id transakce 3.4.3 Přijetí platby Pro přijetí platby, tj. potvrzení transakce, je potřeba vyvolat proceduru Payment/confirm použitím metody POST a zadat stejné parametry jako v případě rozeznávání statusu transakce (viz kapitola 3.4.2). Platby je nutné přijímat tehdy, je-li funkce automatického přijímání plateb vypnuta (v opačném případě probíhá přijímání plateb automaticky). Přijímat je tímto způsobem možné také platby, které mají status 5 pro přijetí. Alternativně je možné platby přijímat také prostřednictvím uživatelského rozhraní PayU na stránce nazvané Seznam transakcí. 3.4.4 Zamítnutí platby Pro zamítnutí platby je potřeba vyvolat proceduru Payment/cancel a zadat stejné parametry jako v případě rozeznávání statusu transakce (viz kapitola 3.4.2). Zamítání plateb je používáno tehdy, pokud je funkce automatického přijímání plateb vypnuta. Není-li platba zamítnuta v čase kratším než jaký je čas automatického zrušení platby (viz Příloha 1), dojde ke zrušení automaticky. Zamítat tímto způsobem je možné také platby, které mají status 5 pro přijetí. Platby je možné zamítat také prostřednictvím uživatelského rozhraní PayU, na stránce nazvané Seznam transakcí. 3.4.5 Status dokončení operace Odpovědi, které obdrží aplikace Obchodu po vyvolání procedur Payment/confirm a Payment/cancel vypadají následovně: Správné vykonání formát txt : status: OK trans_id: 7 trans_pos_id: 1 trans_session_id: 417419 trans_ts: 1094206530505 trans_sig: 9da7c868407fedae6f1b6aca9054632b 25
Správné vykonání formát xml : 3 <?xml version= 1.0 encoding= UTF-8?> <response> <status>ok</status> <trans> <id>7</id> <pos_id>1</pos_id> <session_id>417419</session_id> <ts>1094205828574</ts> <sig>a95dc2145079b16a3668175279c35736</sig> </trans> </response> Obdržení statusu OK v těchto případech neznamená, že transakce byla úspěšně potvrzena/zrušena. Tyto odpovědi pouze potvrzují přijetí žádosti ke zpracování. Potvrzení o změně statusu transakce je posíláno zvlášť standardním způsobem prostřednictvím adresy UrlOnline. Co se týče údajů, které posílá zpátky PayU, počítáme hodnotu sig následujícím vzorcem: Chyba formát txt : status: ERROR error_nr: 503 error_message: Chyba formát xml : <?xml version= 1.0 encoding= UTF-8?> <response> <status>error</status> <error> <nr>503</nr> <message></message> </error> </response> sig = md5(pos_id + session_id + ts + key2) 26
3.5 Struktura návratových adres UrlPositive a UrlNegative 3 Po dokončení platby je možné přesměrovat Zákazníka na URL adresu uvedenou v nastavení příslušného POSu. V závislosti na aktuálním statusu transakce je pro toto přesměrování použita buď adresa UrlPositive anebo UrlNegative. Na UrlPositive je Zákazník přesměrován poté, co úspěšně zadá platbu na stránkách svého internetového bankovnictví (v případě tzv. rychlých online převodů) anebo na stránce zpracovatele karetních transakcí (při platbě kartou). Jedná-li se o platbu převodem nebo složenkou, je Zákazník na UrlPositive přesměrován poté, co obdrží informace potřebné k provedení platby. K přesměrování na adresu UrlNegative dojde v případě, že platba není zahájena správně. Návratové adresy UrlPositive a UrlNegative slouží pouze pro informativní účely, na základě přesměrování na tyto adresy tak není možné vyvozovat žádné závěry ohledně výsledných statusů plateb. I v případě přesměrování na UrlPositive může totiž platba zůstat nedokončená (Zákazník např. nemusí mít na účtu dostatek prostředků pro provedení platby; v případě platby převodem anebo složenkou nemusí Zákazník vygenerované platební údaje vůbec použít atd.). Pro zjištění statusu transakce je tak vždy nutné vyvolat proceduru Payment/get (viz kapitola 3.4.2). Informace o aktuálních statusech transakcí je případně možné nalézt také v uživatelském rozhraní PayU. Návratové adresy mohou obsahovat následující konstanty, které jsou po přesměrování nahrazeny odpovídajícími hodnotami dle následující tabulky: konstanta %transid% %posid% %paytype% %sessionid% %amountps% %amountcs% %orderid% %error% popis identifikátor nové transakce vytvořený v aplikaci PayU hodnoty pos_id hodnoty pay_type hodnoty session_id hodnoty částky oddělovač je tečka hodnoty částky oddělovač je čárka hodnoty order_id Číslo chyby dle tabulky (viz Příloha 4), používá se pouze v případě UrlNegative Příklady: http://www.shop.cz/status_ok.html?pos_id=%posid%&session_id=%sessionid% http://www.shop.cz/status_error.html?pos_id=%posid%&session_id=%sessionid%&error=%error% 27
Informace o hodnotách výše uvedených konstant mohou být aplikací Obchodu využity mnoha různými způsoby. Podle informací o použitém typu platby (pay_type) je například možné specifikovat oznámení zobrazované Zákazníkovi na adrese URLPositive pro jednotlivé platební kanály. Na základě hodnoty parametru session_id může zase aplikace Obchodu vytvořit Zákazníkovi odkaz na novou platbu za tutéž objednávku (ovšem s použitím nové hodnoty session_id, protože ta musí být vždy jedinečná)v případech, kdy původní platba zůstane nedokončena. Číslo chyby (viz Příloha 4) umožňuje zjistit, z jakého důvodu nebyla platba vytvořena (funkci doporučujeme využívat např. ve fázi testování, kdy je jejím prostřednictvím možné velmi rychle nalézt a odstranit příčiny nejčastějších problémů při vytváření nových plateb) atd. Třetí adresou, kterou je možné definovat pro daný POS, je UrlOnline. Na tuto adresu jsou ze strany PayU odesílány oznámení o změně statusu transakce (viz kapitola 3.4.1). 3 3.6 Kontrolní součty MD5 Po každém odeslání požadavku aplikací Obchodu a každém vytvoření odpovědi na straně PayU je vytvořen kontrolní součet MD5, který umožňuje ověřit integritu dat. Kontrolní součty se vytvářejí podle následujícího vzorce ( + znamená operaci spojení řetězců znaků): sig = md5(pos_id + session_id + value1 + value2 + + valuen + ts + key) kde: pos_id session_id value1...valuen ts key hodnota, kterou přidělilo PayU ID platby jedinečné pro každou transakci seznam dalších hodnot uvedených v popisech konkrétních metod libovolný řetězec znaků, např. aktuální čas v sekundách (doporučujeme) řetězec znaků, který zná PayU a Obchod 28
V aplikaci PayU jsou ke každému pos_id přiřazeny dvě hodnoty klíče: 3 key1 (Klíč) používá se pro vytvoření kontrolního součtu, který je odesílán ze strany Obchodu key2 (Druhý klíč) používá se pro vytvoření kontrolního součtu, který je odesílán ze strany PayU 3.6.1 Kontrolní součet parametrů předávaných do nové platby Aplikace Obchodu je povinna ve formuláři nové platby (NewPayment) uvádět kontrolní součet všech přenášených parametrů. Označování nových plateb kontrolními součty představuje mechanismus, který zvyšuje bezpečnost systému proti napadení zvnějšku a zajišťuje hladký a bezproblémový průběh transakcí. Pro vytvoření kontrolního součtu je ve formuláře nové platby nutné uvádět tyto dva parametry: ts časová značka, hodnota potřebná na ověření kontrolního součtu, libovolný řetězec znaků, např. aktuální čas v sekundách (doporučujeme) sig kontrolní součet přenášených informací Hodnota sig se počítá následujícím vzorcem: sig = md5(pos_id + pay_type + session_id + pos_auth_key + amount + desc + desc2 + order_id + first_name + last_name + street + street_hn + street_an + city + post_code + country + email + phone + language + client_ip + ts + key1) Není-li daná hodnota přenášena ve formuláři používaném na vytvoření nové platby, použijeme prázdný řetězec znaků. Pokud v okamžiku kalkulace hodnoty parametru sig není známa hodnota parametru pay_type, měl by být parametr ext_calc v URL adrese PayU šablony (viz kapitola 3.3.5) nastaven na hodnotu 0. Není-li hodnota parametru sig vypočtena správně anebo pokud se hodnoty ostatních přenášených parametrů změní, nová platba se nevytvoří (Zákazník bude přesměrován na adresu UrlNegative s kódem chyby 103). Používání kontrolního součtu tak funguje jako bezpečnostní pojistka, která zajišťuje, že žádná neautorizovaná změna hodnot parametrů platby nezůstane nepovšimnuta. 29
3 3.7 Testování K otestování implementace platebního systému PayU slouží tzv. testovací platby (typ platby t, viz Příloha 1). Tyto platby se chovají stejně jako skutečné transakce, ovšem s tím rozdílem, že při nich nedochází k manipulaci s žádnými reálnými finančními prostředky. Testovací platby umožňují zkontrolovat integritu údajů předávaných aplikaci PayU ze strany Obchodu. Pomocí testovacích plateb je možné ověřit přesměrování na návratové adresy UrlNegative a UrlPositive, stejně jako komunikaci na UrlOnline. Kromě procedury NewPayment je s testovacími platbami možné provádět také procedury Payment/get, Payment/confirm a Payment/cancel. S použitím testovacích plateb lze vytvářet různé statusy transakcí (viz Příloha 2) a přechody mezi nimi (viz Příloha 3). Při testovacích platbách se nemění zůstatek Obchodu, lze jich proto vytvářet libovolné množství. Dochází-li při vytváření testovacích plateb k přesměrování na UrlNegative, je možné umístěním konstanty %error% do této adresy (viz kapitola 3.5) zjistit číslo chyby. Na základě tabulky umístěné v Příloze 4 je pak možné zjistit příčinu problému a následně problém odstranit. Jelikož testovací platby fungují na stejném principu jako platby skutečné, je v případě jejich bezproblémového fungování možné přistoupit ke spuštění platebního systému PayU v ostrém provozu. 30
Vzhled platební 4 brány PayU na e-shopu
V této části implementačního manuálu se dočtete o tom, jak správně nastavit ukončení nákupu s PayU, jak správně zobrazovat jednotlivé platební metody. 4 4.1 Vizualizace a popis platebních metod Společnost PayU dlouhou dobu analyzovala srozumitelnost popisů platebních metod. Výsledkem jsou následující instrukce, jejichž cílem je dosáhnout rychlé orientace zákazníka při výběru platební metody. K dispozici jsou 2 možnosti zobrazení platebních metod: 1. Statická JavaScript šablona 2. Dynamická JavaScript šablona (tzv. drop-down varianta) JavaScript platební šablona PayU umožňuje využít zkušeností PayU v oblasti nákupního procesu a nabídnout zákazníkům přehledné a vizuálně příjemné zobrazení platebních metod a jejich jasnou identifikací s logy bank a platebních institucí, které znají. Obě šablony jsou k dispozici v české a anglické verzi (viz Příloha 6). Příklady implementace šablon na konkrétních e-shopech jsou zobrazeny v Příloze 7. 4.2 Implementace Implementace platební šablony PayU obnáší umístění JavaScript kódu do zdroje vašich webových stránek. Můžete volit mezi statickou a rozbalovací šablonou podle toho, která se bude více hodit do vašeho nákupního procesu. Platební šablona umožňuje výběr platební metody zákazníkem na stránce e-shopu, uložení vybraných dat a odeslání zákazníka přímo do banky. E-shop může umístit šablonu do některé části nákupního procesu, poté je možno nechat zákazníka přejít na další kroky nákupního procesu jako je např. potvrzení zadané objednávky apod. Přesný návod, jak implementovat JavaScript šablonu PayU, naleznete v kapitole 3.3.5. Možnosti úprav Platební šablonu je možno upravit pomocí CSS stylů. Je možné měnit šířku šablony, barevné pozadí, barvy a styl textů. Není možno měnit popis platebních metod, obrázky, pořadí platebních metod, patičku PayU ani počet platebních metod na řádku. Doporučujeme, pokud to bude možné, ponechat pozadí šablony bílé nebo jen velmi světlé barvy. Čím tmavší barvu zvolíte, tím větší je možnost, že obrázky a použité prvky šablony budou tzv. okousané a šablona nebude působit profesionálním dojmem. Může to ovlivnit důvěryhodnost plateb a následně konverzi vašeho e-shopu. V případě vlastního zobrazení platebních metod (bez využití šablony) dodržujte tyto pravidla: 1. Platební metody prezentujte v oddělených celcích a to následovně: a. platební tlačítka a standardní bankovní převod b. platební karta a mobito c. platba složenkou 32
2. V případě, že kromě platebních metod zprostředkovaných platební bránou PayU máte naimplementované / zobrazené jiné platební metody, zobrazujte tyto taktéž odděleně. To znamená platební metody PayU odděleně od ostatních platebních metod. 3. Jako dělící znak může posloužit linka nebo prostor mezi jednotlivými skupinami platebních metod. 4. Platební metody PayU musí být vždy prezentovány s následujícími symboly: a. PayU Bezpečné a rychlé platby bannery ke stažení na stránce http://www.payu.cz/ke-stazeni b. V případě využití platebních karet bezpečnostní loga ke stažení na stránce http://www.payu.cz/ke-stazeni 5. Platební tlačítka jednotlivých bank nazývejte rychlé bankovní převody 6. U každé platební metody je nutné zobrazit příslušné logo a název platební metody tak, jak jsou zobrazeny v šabloně PayU (viz Příloha 6). 4 4.3 Nákupní proces a uživatelsky přívětivá implementace Podle některých studií online nákupního chování až 75 % kupujících opustí e-shop, aniž za zboží zaplatí. Než totiž zákazník v e-shopu zboží koupí a zaplatí, je nucen proklikat se či projít celou řadou mnohdy zbytečných úkonů. Na vině je špatně nastavené ukončení nákupního procesu takzvaný checkout. E-shop zákazníkovi často nevědomě komplikuje cestu k dokončení nákupu, potvrzení objednávky a platbě. Proces bývá zdlouhavý, nepřehledný, e-shop chce po zákazníkovi celou řadu věcí nutí jej do registrace, vyžaduje vyplnění osobních údajů. Správně nastavený checkout v kombinaci s okamžitým placením zboží přitom výrazně přispívá k vyšší konverzi nákupu a tedy ke zvýšení objemu prodeje. Konverzí nákupu rozumíme potvrzení objednávky a zaplacení zboží. 4.4 Optimalizace nákupního procesu Celý nákupní proces by měl být ideálně nastaven tak, aby vedl k jedinému cíli: úspěšnému dokončení transakce, a tedy k zaplacení zboží. Obecně platí zásada, čím je proces intuitivnější a rychlejší, tím je menší pravděpodobnost, že jej zákazník předčasně opustí. 33
Zjednodušení nákupního procesu vyžaduje optimalizaci tří základních klíčových prvků: navigace, vizualizace a rychlosti. 4 4.5 Navigace a vizualizace Zákazník má dnes při nakupování spousty příležitostí, jak vybrat pro něj tu nejlepší nabídku. Využívá možnosti srovnávat zboží, třeba na Heureka.cz. Často proto během nákupu e-shop opouští, aby porovnal parametry, ceny, reference a kvalitu různých obchodů. Proto je velmi důležité poskytnout nakupujícímu co nejvíce informací přímo v e-shopu během nákupu a provést jej nákupním košíkem (checkoutem) co nejrychleji. Ideální checkout by měl mít maximálně čtyři kroky. Odbavení zákazníka na jedné stránce má určitě vyšší konverzi, ale pouze pokud se v celém procesu dokáže zákazník dobře orientovat. Nutností je navigační lišta, výrazná tlačítka pro pokračování, nebo možnost košík opustit a vrátit se zpět k předchozímu kroku. Velkou výhodou pro zákazníka je možnost se vrátit přímo na popis produktu nebo možnost srovnat podobné produkty přímo v nákupním košíku. Z pohledu nakupujících má e-shop vždy větší věrohodnost, jestliže spolupracuje se známými a důvěryhodnými institucemi. Jakákoliv loga bank, bezpečnostních systémů, certifikátů a poskytovatelů platebních metod reprezentujících tuto kredibilitu jsou vždy pro e-shop přínosem, a proto je ideální je mít přímo jako součást procesu dokončení nákupu. Zvyšuje to pocit bezpečí a důvěru k obchodu. Neméně důležitým prvkem vizualizace jsou fotografie. Kvalitní a dostatečně detailní fotografie kupovaného produktu můžou snížit míru opuštění až o 20 %. Nejčastější důvod opuštění e-shopu bez dokončení nákupu je však neúměrně vysoké poštovné. Pokud není z jakýchkoliv důvodů možné cenu poštovného snížit, snažte se prezentovat jeho předpokládanou výši hned na začátku nákupního procesu. 4.6 Rychlost a konverze Pro zrychlení celého nákupního procesu je dobré se soustředit na odstranění nadbytečných kroků a bariér, které jej zákazníkovi znesnadňují. Sem patří například nutnost registrace a zadávání osobních informací pro nákup. Umožnění nákupu bez registrace je zajímavým způsobem jak zvýšit počet dokončených a zaplacených objednávek. Čím rychleji zákazníka provedeme nákupním košíkem, tím vyšší konverze nákupu dosáhneme. Snad nejvíce podceňovaným a přitom nejlépe dostupným způsobem pro optimalizaci nákupního procesu jsou jednoduché a rychlé platby. Pro české prostředí jsou relativně novým nástrojem, přitom však klíčovým pro vyšší konverzi nákupu. Na rozdíl od dobírky nebo standardního bankovního převodu totiž zákazník před zaplacením neopouští e-shop. K objednávce i platbě dochází v rámci jednoho procesu: zákazník prochází e-shopem od rozhodnutí koupit až po zaplacení v krátkém časovém úseku a samotná platba v případě rychlých on-line plateb netrvá déle než pár sekund. Naopak v případě dobírky nebo standardního bankovního převodu se může stát, že si zákazník nákup rozmyslí anebo nakoupí u konkurence. Čím jednodušší je odbavení a platby, tím vyšší konverze a obrat pro e-shop. 34
4.7 Funkční šablona 4 Již řadu let se věnujeme optimalizaci platebního procesu. Na základě analýz nákupního chování jsme vyvinuli funkční šablonu pro placení předem. Šablona slouží e-shopům, které chtějí zvyšovat konverzi nákupu pomocí rychlých online plateb. Po dohodě s bankami jsme upravili vizualizaci a popis platebních metod tak, aby byly pro nakupující co nejvíce srozumitelné. Jejich řazení je nastavené tak, aby byli nakupující nejdříve směřováni na platbu rychlým převodem z jejich banky a až poté na platbu kartou, která má vyšší náklady na jednu transakci. Šablona je přehledná, dobře čitelná a dá se umístit přímo na e-shop. 4.8 Edukace zákazníků a marketing Každý zákazník ocení, pokud je dostatečně informován o průběhu platby a samotném zaplacení za zboží či služby. U platebních metod Standardní bankovní převod a Platba složenkou přes Českou poštu PayU nabízí možnost aktivace služby pro zasílání e-mailů s údaji o platbě přímo na e-mail zákazníkům. Díky tomu je zákazník ujištěn, že zadané údaje jsou správné a zároveň se tím snižuje případná chybovost. Pokud máte zájem vyzkoušet si šablonu PayU, pak můžete navštívit náš testovací e-shop na této webové stránce http://payu.fcostry.cz/ 35
4 Součástí úspěšné implementace je také vložení loga nebo banneru PayU, která jsou k dispozici ke stažení webu PayU na adrese http://www.payu.cz/ke-stazeni PayU poskytuje také edukační mailing pro klienty. Informuje tak o tom, jak snížit chybovost při placení on-line a zvýšit tak konverzi. Pro podrobnější informace neváhejte kontaktovat náš tým obchodníků a pracovníků zákaznické podpory. 36
Povinné 5 parametry implementace
Před spuštěním ostrého provozu platebního systému PayU na e-shopu musí být splněny následující požadavky: 5 1. Nasazení všech platebních metod dle smlouvy. 2. Správný popis a vizualizace platebních metod (viz kapitola 4). 3. Správně naimplementované návratové adresy (viz. kapitola 3.5) 4. Správně naimplementovaný kontrolní součet (viz kapitola 3.6). 5. Pozitivní výsledek testovací platby. 6. Umístění loga PayU (případně také bannerů a další grafiky) na hlavní stránce e-shopu a na stránce výběru platebních metod. 38
Administrace 6 PayU účtu
6.1 Obecné informace 6 Tato část příručky se věnuje nastavení a práci s PayU účtem. Pomůže vám nastavit vše potřebné od prvního přihlášení k vašemu účtu a pohybovat se v uživatelském rozhraní PayU. 6.2 Uživatelské rozhraní PayU Do uživatelského rozhraní PayU je možné se přihlásit po kliknutí na odkaz Přihlášení do nového PayU účtu, který je umístěný na hlavní stránce PayU (http://www.payu.cz). Po kliknutí na uvedený odkaz je uživatel přesměrován na stránku https://secure.payu.pl/user/ start?lang=cs, kde je potřeba uvést uživatelské jméno a heslo a poté kliknout na tlačítko Přihlásit se. 40
6 6.3 Vytvoření Obchodu a POSu Po prvním přihlášení do uživatelského rozhraní je uživatel vyzván k vytvoření Obchodu (ve stručnosti je založení Obchodu a POSu popsáno také v kapitole 2.2). Po kliknutí na tlačítko Přidat obchod je v prvním kroku potřeba zvolit webovou adresu Obchodu, uvést název Obchodu (případně také jeho popis) a vybrat požadovanou měnu. Má-li uživatel zájem zpracovávat ve svém Obchodu platby v eurech, musí být tato skutečnost uvedena ve smlouvě s PayU. 41
6 Pokud má uživatel zájem využívat platební systém PayU na jiné webové adrese, než jakou uvedl během registrace, může tuto adresu uvést. V takovém případě je však nutné, aby byl vytvořen dodatek ke smlouvě s PayU. 42
Ve druhém kroku je třeba zadat jméno POSu a zvolit požadované kódování dat. Rovněž je zde možné definovat chybnou návratovou adresu (UrlNegative), správnou návratovou adresu (UrlPositive) a adresu pro oznámení (UrlOnline) pro tento POS. Pole Kontroloval platnost SIGu je potřeba nechat zakliknuté, aby byla při vytváření nové platby ověřována správná hodnota kontrolního součtu. 6 Po kliknutí na tlačítko Přidat obchod se zobrazí stránka s konfiguračními údaji vytvořeného POSu, potřebnými pro naimplementování platebního systému na stránku Obchodu (pos_id, první a druhý MD5 klíč a autorizační klíč pos_auth_key). 43
6 Po kliknutí na tlačítko Dokončení je Obchod přidán do seznamu Obchodů, který se nachází v záložce Platby Online pod odkazem Můj obchod. Přidání dalšího Obchodu je možné provést kliknutím na tlačítko Přidat obchod. 44
6 Přidání dalšího POSu do již existujícího Obchodu je možné kliknutím na odkaz Seznam POS u příslušného Obchodu 45
6 a poté na tlačítko Přidat nový POS. Podrobnosti o Obchodu je možné zobrazit kliknutím na název Obchodu, podrobnosti o POSu zase kliknutím na název POSu. 46
6 V informacích o POSu jsou zobrazeny také typy plateb dostupné pro daný POS včetně nastavených provizí (před spuštěním ostrého provozu je k dispozici pouze testovací platba). Uživatel může v nastavení POSu vypínat či zapínat funkci automatického přijímaní plateb a to buď pro každý typ platby jednotlivě anebo hromadně pro všechny typy plateb. 6.4 Transakce Seznam transakcí se nachází v záložce Platby online pod odkazem Transakce. Transakce je v seznamu možné vyhledávat podle mnoha různých kritérií. 47
6 Podrobnosti o každé transakci je možné zobrazit kliknutím na popis transakce. 48
Stránka s podrobnostmi o transakci vypadá takto 6 Po kliknutí na tlačítko Historie oznámení, je možné manuálně odeslat oznámení o změně statusu transakce na adresu UrlOnline příslušného Obchodu. Funkce má své využití zejména během fáze implementace a testování platebního systému. Odesílání oznámení jinak probíhá zcela automaticky a není nutné jej iniciovat tímto ani žádným jiným způsobem. 49
6 Prostřednictvím stránky Seznam transakcí je možné přijímat nebo rušit transakce se statusem pro přijetí, přijímat nebo rušit transakce se statusem odmítnuta, případně rušit transakce se statusem nová. 50
6 Ze stránky Seznam transakcí je možné provádět také vrácení plateb. Vrátit lze pouze takovou platbu, která má status skončena. Po kliknutí na odkaz Vrátit a kliknutí na tlačítko Další na následující stránce je možné zadat částku vrácené platby (vrátit lze celou výši transakce nebo její část), uvést zprávu pro příjemce do pole Název vrácené platby a zvolit jeden ze tří typů ručních (manuálních) způsobů vrácení platby bankovní převod, bankovní převod do zahraničí nebo platbu prostřednictvím poštovní poukázky. 51
6 Na základě zvoleného způsobu vrácení platby je poté nutné vyplnit pole v části Údaje příjemce vrácené platby a kliknout na tlačítko Vrátit platbu. 52
U vybraných typů plateb lze v části Způsob vrácení platby zvolit možnost automaticky (stejné jako platební metoda). Při výběru této možnosti není potřeba zadávat žádné další údaje po kliknutí na tlačítko Vrátit platbu je platba vrácena na účet, ze kterého byla odeslána. 6 Alternativně je možné vrácení platby iniciovat ze stránky Platby online > Transakce > Vrácené platby kliknutím na tlačítko Nová vrácená platba. 53
a uvedením čísla transakce, která má být vrácena, na následující straně. 6 6.5 Vyúčtování, Výběry a Vrácené platby Seznam Historie vyúčtování a transakcí se nachází v záložce Platby online pod odkazem Transakce > Vyúčtování. Na stránce lze vyhledávat podle různých kritérií, podobně jako na stránce Seznam transakcí. Výsledky hledání se však liší v tom, že vedle informací o transakcích uvádějí také údaje týkající se naúčtovaných provizí. Zároveň je zde uváděna i aktuální výše zůstatku Obchodu po každé operaci (tj. po přijetí transakce, po naúčtování provize atd.) 54
6 Stránka Výběry ( Platby online > Transakce > Výběry ) umožňuje vyhledávat v historii výběrů (převodů zůstatků jednotlivých Obchodů na bankovní účty, které jsou k těmto Obchodům přiřazené). Stránka Vrácené platby ( Platby online > Transakce > Vrácené platby ) zase umožňuje vyhledávat v historii vrácených plateb. Prostřednictvím tlačítka Nová vrácená platba je možné iniciovat vrácení platby, jak již bylo uvedeno výše. 55
6 6.6 Výběry O převod aktuálního zůstatku Obchodu na bankovní účet, který je k tomuto Obchodu přiřazený, je možné kdykoliv požádat kliknutím na tlačítko Vyplatit zůstatek, které se nachází na stránce Platby online > Můj obchod. Výběry ale není nutné zadávat vždy pouze tímto manuálním způsobem. V uživatelském rozhraní lze definovat také pravidla pro provádění výběrů automaticky. Po kliknutí na odkaz Automatické výběry u příslušného Obchodu na stránce Platby online > Můj obchod 56
6 a zvolení možnosti Upravit automatické výběry se automatické výběry aktivují zakliknutím možnosti Ano u možnosti Automatické výběry jsou aktivní. Poté je nutné zadat Minimální částku k výběru (pokud je zůstatek obchodu menší než tato částka, výběr se neuskuteční) a zvolit jednu ze tří nabízených Frekvencí výběrů (např. Periodicky, tj. vždy po uplynutí zadaného počtu dnů). Nastavení výběru se poté potvrdí tlačítkem Uložit změny. 57