Modul PrestaShop verze 1.7 Uživatelská dokumentace VIKIPID a.s. Modul pro PrestaShop 1.7 Uživatelská dokumentace Stránka 1 z 10
Obsah VIKIPID a.s.... 3 Instalace modulů VIKIPID do PrestaShopu... 3 Nastavení modulu VIKIPID... 4 Sekce Nastavení... 4 Popis sekce Nastavení... 5 Sekce Potvrzení platby... 6 Seznam objednávek... 7 Objednávka zaplacená... 7 Objednávka nezaplacená... 8 Objednávka s chybou... 8 Detail objednávky... 9 VIKIPID a.s. Modul pro PrestaShop 1.7 Uživatelská dokumentace Stránka 2 z 10
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.7. 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 Nahrát 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 Pokud se zobrazí informace, že byl modul úspěšně nainstalován (Obrázek 3), můžete přímo kliknutím na tlačítko Konfigurovat přejít k nastavení platebního modulu VIKIPID. VIKIPID a.s. Modul pro PrestaShop 1.7 Uživatelská dokumentace Stránka 3 z 10
Obrázek 3 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 (Obrázek 4). Obrázek 4 Sekce Nastavení V této sekci naleznete nastavení modulu VIKIPID (Obrázek 5). Každé nastavení, 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. VIKIPID a.s. Modul pro PrestaShop 1.7 Uživatelská dokumentace Stránka 4 z 10
Obrázek 5 Popis sekce Nastavení Uživatelské jméno 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 heslo určené pro zasílání objednávek 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). 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 VIKIPID a.s. Modul pro PrestaShop 1.7 Uživatelská dokumentace Stránka 5 z 10
zobrazí v menším oknu s pozadím eshopu (Obrázek 6Chyba! Nenalezen zdroj odkazů.). 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 7) Obrázek 6 Obrázek 7 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 8) 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. VIKIPID a.s. Modul pro PrestaShop 1.7 Uživatelská dokumentace Stránka 6 z 10
Obrázek 8 Seznam objednávek V seznamu objednávek (Obrázek 9) 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 9 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 10). VIKIPID a.s. Modul pro PrestaShop 1.7 Uživatelská dokumentace Stránka 7 z 10
Obrázek 10 Objednávka nezaplacená Objednávka, která má oranžově podbarvené pole Kód (Obrázek 11 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 13), lze aktualizovat zjistit stav uhrazení objednávky. Obrázek 11 Objednávka s chybou Objednávka, která má červeně podbarvené pole Kód (Obrázek 12) 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 14) 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 14). V případě, že chyba nebyla odstraněna, klikněte na tlačítko Zobrazit komunikaci (Obrázek 14) a zkopírujte obsah zobrazeného pole, který předejte IT podpoře společnosti VIKIPID. VIKIPID a.s. Modul pro PrestaShop 1.7 Uživatelská dokumentace Stránka 8 z 10
Obrázek 12 Detail objednávky V detailu objednávky se nachází sekce s názvem Platba (Obrázek 13), 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 13 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). 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. VIKIPID a.s. Modul pro PrestaShop 1.7 Uživatelská dokumentace Stránka 9 z 10
Obrázek 14 VIKIPID a.s. Modul pro PrestaShop 1.7 Uživatelská dokumentace Stránka 10 z 10