Modul PrestaShop verze 1.6 Uživatelská dokumentace VIKIPID a.s. Modul pro PrestaShop 1.6 Uživatelská dokumentace Stránka 1 z 13
Obsah VIKIPID a.s.... 3 Instalace modulů VIKIPID do PrestaShopu... 3 Nastavení modulu VIKIPID... 6 Sekce Nastavení... 7 Popis sekce Nastavení... 8 Sekce Potvrzení platby... 9 Seznam objednávek... 10 Objednávka zaplacená... 10 Objednávka nezaplacená... 11 Objednávka s chybou... 11 Detail objednávky... 12 VIKIPID a.s. Modul pro PrestaShop 1.6 Uživatelská dokumentace Stránka 2 z 13
VIKIPID a.s. Společnost VIKIPID a.s. pro Vás připravila modul garanční platební brány VIKIPID pro e-shopovou platformu PrestaShop 1.6. Instalace modulů VIKIPID do PrestaShopu Pro přidání nového modulu do Vašeho Prestashopu je nutné v administraci eshopu vybrat záložku Moduly a Služby kde kliknete na tlačítko Přidat nový modul (Obrázek 1). Obrázek 1 Zobrazí se Vám nabídka, ve které kliknete na tlačítko Vybrat soubor (Obrázek 2) a zvolíte umístění modulu (soubor ve tvaru.zip), který jste získali od společnosti VIKIPID a.s. Obrázek 2 VIKIPID a.s. Modul pro PrestaShop 1.6 Uživatelská dokumentace Stránka 3 z 13
Pro nahrání modulu do Vašeho e-shopu je nutné kliknout na tlačítko Nahrát tento modul (Obrázek 3). Obrázek 3 Pokud se zobrazí informace, že byl modul úspěšně stažen (Obrázek 4), najdete modul VIKIPID pomocí filtru, ve kterém zadáte Nenainstalované moduly, Povolené a zakázané moduly od autora Pavel Strejček v seznamu modulů (Obrázek 5). Obrázek 4 VIKIPID a.s. Modul pro PrestaShop 1.6 Uživatelská dokumentace Stránka 4 z 13
Obrázek 5 Pro instalaci modulu VIKIPID je nutné kliknout na tlačítko Nainstalovat (Obrázek 6) a potvrdit instalaci prostřednictvím tlačítka Pokračovat v instalaci (Obrázek 7) Obrázek 6 Obrázek 7 VIKIPID a.s. Modul pro PrestaShop 1.6 Uživatelská dokumentace Stránka 5 z 13
Po úspěšném instalaci budete přesměrování přímo do administrace modulu VIKIPID (Obrázek 8). Obrázek 8 Kliknutím na tlačítko Konfigurace (Chyba! Nenalezen zdroj odkazů.) přejdete do nastavení příslušného modulu. Vyplnění tohoto nastavení je nutné pro plnou funkčnost napojení do systému VIKIPID. Nastavení modulu VIKIPID V modulu VIKIPID naleznete nastavení, které je nutné pro správnou funkci modulu. Kliknutím na tlačítko Konfigurace se zobrazí nastavení modulu (Chyba! Nenalezen zdroj odkazů.). VIKIPID a.s. Modul pro PrestaShop 1.6 Uživatelská dokumentace Stránka 6 z 13
Obrázek 9 Sekce Nastavení V této sekci naleznete nastavení modulu VIKIPID (Obrázek 10). Každé nastaveni, nebo změnu je nutné potvrdit kliknutím na tlačítko Uložit, které se nachází v pravém dolním rohu příslušné sekce. Obrázek 10 VIKIPID a.s. Modul pro PrestaShop 1.6 Uživatelská dokumentace Stránka 7 z 13
Popis sekce Nastavení Uživatelské jméno do toho pole vyplňte uživatelské jméno určené pro zasílání objednávek do systému VIKIPID, které získáte od obchodního zástupce VIKIPID při registraci do systému VIKIPID (toto přihlašovací jméno je odlišné od jména, které se využívá pro přihlášení do VIKIPID Účtu). Heslo do tohoto pole vyplňte heslo určené pro zasílání objednávek do systému VIKIPID (toto přihlašovací heslo je odlišné od hesla, které se využívá pro přihlášení do VIKIPID Účtu!). Zpráva při problému do tohoto pole vyplňte zprávu, která se zákazníkovi zobrazí, pokud se nepodařilo úspěšně zaslat objednávku do systému VIKIPID. V případě nevyplnění zprávy se uživateli nic nezobrazuje. Použít testovací prostředí při výběru možnosti ANO se budou data o objednávce odesílat do testovacího prostředí systému VIKIPID. Pro tento režim je nutné použít testovací přístupové údaje pro zasílání objednávek, které Vám při registraci přidělí obchodní zástupce společnosti VIKIPID a.s. Tento režim slouží pro otestování korektního napojení Vašeho e-shopu do systému VIKIPID. V tomto režimu lze realizovat platbu prostřednictvím testovací platební brány, kde je možné platit pouze testovacími platebními kartami (tyto karty lze získat od obchodního zástupce společnosti VIKIPID a.s.). V případě výběru hodnoty NE budou objednávky odesílány do produkčního prostředí systému VIKIPID. Pro tento režim je nutné použít přístupové údaje, které Vám při registraci přidělí obchodní zástupce společnosti VIKIPID a.s. V tomto režimu probíhají reálné platby přes platební bránu. Použít In-line platební bránu - při výběru možnosti ANO se bude platební brána zobrazovat v in-line verzi. Tato verze platební brány se liší od klasického zobrazení platební brány. In-line platební brána se zobrazí v menším oknu s pozadím eshopu (Obrázek 11). In-line zobrazení je podmíněno SSL zabezpečením eshopu. V případě výběru možnosti hodnoty NE se platební brána VIKIPID zobrazí ve standartním formátu (Obrázek 12). Obrázek 11 VIKIPID a.s. Modul pro PrestaShop 1.6 Uživatelská dokumentace Stránka 8 z 13
Obrázek 12 Tajný klíč pro potvrzení platby a cron toto pole bude vyplněno automaticky při instalaci modulu. Tento klíč je použit například v sekci Potvrzení platby. Sekce Potvrzení platby V této sekci (Obrázek 13) se nachází automaticky vygenerovaná URL adresa (využívá hodnoty pole Tajný klíč pro potvrzení platby a cron ), díky které bude objednávka ihned po zaplacení zákazníkem označena v administraci jako zaplacená. Tuto URL adresu prosím předejte obchodnímu zástupci společnosti VIKIPID a.s. Obrázek 13 VIKIPID a.s. Modul pro PrestaShop 1.6 Uživatelská dokumentace Stránka 9 z 13
Seznam objednávek V seznamu objednávek (Obrázek 14) máte přehledně zobrazeny všechny vytvořené objednávky od zákazníků včetně informace o stavu zaplacení prostřednictvím platební brány VIKIPID nebo o chybném zaslání dat do systému VIKIPID. Obrázek 14 Objednávka zaplacená Objednávka, která byla zákazníkem řádně zaplacena je v poli Stav označená zeleně s popisem VIKIPID platba přijata (Obrázek 15). Obrázek 15 VIKIPID a.s. Modul pro PrestaShop 1.6 Uživatelská dokumentace Stránka 10 z 13
Objednávka nezaplacená Objednávka, která má oranžově podbarvené pole Kód (Obrázek 16) byla přijatá do systému VIKIPID, ale nebyla zaplacena zákazníkem, nebo nebyla přijatá informace o zaplacení prostřednictvím chybně zadané notifikační adresy. Kliknutím na tlačítko Aktualizovat stav, které se nachází v Detailu objednávky (Obrázek 18), lze aktualizovat zjistit stav uhrazení objednávky. Obrázek 16 Objednávka s chybou Objednávka, která má červeně podbarvené pole Kód (Obrázek 17) se úspěšně neodeslala do systému VIKIPID. U této objednávek je nutné v Detailu objednávky kliknout na tlačítko Aktualizovat stav (Obrázek 19) a následně kliknou na zobrazené tlačítko Znovu odeslat do služby. Pokud se k objednávce opět nepřiřadí číslo objednávky přidělované systémem VIKIPID a červené pole nezmizí, jedná se o chybu, která bude uvedena v Detailu objednávky, kolonka Zprávy (Obrázek 19). V případě, že chyba nebyla odstraněna, klikněte na tlačítko Zobrazit komunikaci (Obrázek 19) a zkopírujte obsah zobrazeného pole, který předáte IT podpoře společnosti VIKIPID. VIKIPID a.s. Modul pro PrestaShop 1.6 Uživatelská dokumentace Stránka 11 z 13
Obrázek 17 Detail objednávky V detailu objednávky se nachází sekce s názvem Platba (Obrázek 18), ve které lze získat informace o stavu objednávky vzhledem k systému VIKIPID (zda byla odeslána do systému VIKIPID, zda je zaplacena nebo nastala chyba ap.). Obrázek 18 Tlačítko Aktualizovat stav kliknutím na toto tlačítko aktualizujete stav platby za objednávku. Tlačítko Znovu odeslat do služby kliknutím na toto tlačítko znovu odešlete objednávku do systému VIKIPID, přičemž se objednávce přiřadí nový objednávkový VIKIPID kód (UPOZORNĚNÍ je možné zaslat i již přijatou objednávku, čímž může dojít k situaci, že budou ve VIKIPID Účtu přítomny dvě stejné objednávky, s jiným VIKIPID kódem). VIKIPID a.s. Modul pro PrestaShop 1.6 Uživatelská dokumentace Stránka 12 z 13
Tlačítko Zobrazit komunikaci kliknutím na toto tlačítko se zobrazí požadavek s objednávkou, který byl odeslán do systému VIKIPID. Tato informace je zásadní při identifikaci problému komunikace mezi systémem VIKIPID a systémem e-shopu. Pole Zprávy v tomto poli naleznete zprávy o zpracování objednávky v systému VIKIPID. Pokud nastane chyba, bude v tomto poli její popis a příčina. Obrázek 19 VIKIPID a.s. Modul pro PrestaShop 1.6 Uživatelská dokumentace Stránka 13 z 13