Hlavní nastavení
Propojení s GP webpay
Po instalaci a aktivaci pluginu budeme pokračovat s napojením na GP WebPay.
Tento návod vás krok za krokem provede nastavením na straně portálu GP WebPay.
Pro správnou implementaci GP WebPay na váš eshop, budete potřebovat mít podepsanou smlouvu s tímto poskytovatelem. V případě, že máte již vše vyřízené, obdržíte emailem přístupy do testovacího rozhraní.
Níže najdete popsané kroky, které potřebujete pro vytvoření, stažení a nahrání klíčů do GP WebPay prostředí a do WordPressu.
Počítejte s tím, že jakmile uděláte testovací platby (číslo testovací karty budete mít v emialu nebo ji najdete zde) a GP WebPay vám potvrdí, že je vše v pořádku, dostanete nové klíče, opět je nahrajete do prostředí GP WebPay a do WordPressu, upravíte nastavení jmen klíčů v pluginu, vypnete checkbox Test v nastavení pluginu a musíte celý proces zopakovat na provozním prostředí. Podrobný návod níže ↓
Přihlášení do testovacího prostředí.
Přihlášení najdete na adrese https://test.portal.gpwebpay.com/portal/anon/login.xhtml, ale i tak vám URL přijde do emailu včetně loginu.
Po přihlášení budete vyzváni k potvrzení údajů a změně vygenerovaného hesla. Na email vám bude zaslán kód pro potvrzení změny.
Pak se znovu přihlásíte a musíte získat veřejný a soukromý klíč.
Soukromý klíč
Vytvoření a nahrání soukromého klíče se skládá z více kroků. Nejprve přejděte do sekce Správa klíčů a klikněte na Vytvořit.
V dalším kroku si ke klíči vytvořte libovolné heslo, které si poznamenejte, budete ho dále potřebovat v účtu GP WebPay a při nastavení pluginu viz. Nastavení a možnosti pluginu.
Po vytvoření se klíč stáhne do počítače.
Nyní můžete rovnou klíč uložit do paměti prohlížeče. Vrátíte se do sekce Správa klíčů a rozkliknete si e.shop.
Poté je nutné vložít klíč, který se stáhl do počítače.
Při vkládání soukromého klíče do paměti prohlížeče je vyberte možnost Trvale → přes tlačítko Vybrat soubor vložte stažený klíč → vyplňte heslo, které jste si v předchozím kroku vytvořili → vložte klíč tlačítkem.
Následně je nutné pomocí FTP klienta nahrát klíč do adresáře WordPressu, tedy tam, kde je soubor wp_config.php. Poté název klíče bez přípony napište do příslušného pole v nastavení pluginu. Pokud se soubor jmenuje gpwebpay-pvk.key, tak napište gpwebpay-pvk
Veřejný klíč
Klíč si stáhnete v sekci Ke stažení pod názvem Testovací veřejný klíč GPE (soubor „GPE_test_public_key.zip“).
Po stažení je nutné pomocí FTP klienta nahrát klíč do adresáře WordPressu, tedy tam, kde je soubor wp_config.php. Poté název klíče bez přípony napište příslušného pole v nastavení pluginu. Pokud se soubor jmenuje pvk.jmenuje gpe.signing_test.pem, tak napište gpe.signing_test
Pokračujte na Nastavení a možnosti pluginu
Nastavení a možnosti pluginu
Po napojení na GP WebPay přejděte do jeho nastavení, které najdete ve WooCommerce → Nastavení → Pokladna → GP WebPay.
Pojďme si podrobněji popsat jednotlivé kroky:
1. Povolit/Zakázat – zaškrtnutím tohoto políčka, určíte, zda budou mít zákazníci tuto platební metodu na stránce Pokladna k dispozici či ne
2. Titulek – zde si můžete upravit název platební metody tak, jak se bude zobrazovat při výběru platební metody na pokladně
3. Popis – v tomto poli můžete pro zákazníka popsat instrukce k platbě
4. Ikona platební metody – pokud chcete vlastní ikonu platební metody, zadejte její URL zde. V Opačném případě je nastavena defaultní ikona z pluginu.
5. Test mód – v tomto checkboxu aktivujete/deaktivuje testovací prostředí
6. Číslo obchodníka – do tohoto pole zadejte číslo obchodníka, které Vám bylo přiděleno
7. Heslo privátního klíče – zde uveďte heslo, které jste si nastavili při vygenerovaní privátního klíče
8. Jméno privátního klíče – nejprve nahrajete privátní klíč do složky, kde máte nainstalovaný WordPress. Poté název klíče bez přípony napište sem do nastavení pluginu. Pokud se soubor jmenuje gpwebpay-pvk.key, tak napište gpwebpay-pvk
9. Jméno veřejného klíče – nejprve nahrajete veřejný klíč do složky, kde máte nainstalovaný WordPress. Poté název klíče bez přípony napište sem do nastavení pluginu. Pokud se soubor jmenuje pvk.jmenuje gpe.signing_test.pem, tak napište gpe.signing_test
10. Povolit způsob dopravy – pokud chcete povolit všechny způsoby dopravy, ponechejte toto pole prázdné. Případně si můžete definovat pro platební bránu jen některé způsoby dopravy.
11. Povolit GP WebPay pro země – specifikujte, pro které země bude brána dostupná
12. Instrukce – zde napište instrukce k platbě, které se budou zobrazovat na Děkovné stránce a potvrzovacím e-mailu
Po vyplnění údajů nezapomeňte kliknout na tlačítko Uložit změny.
Po nastavení integrace a nastavení pluginu můžete provést testovací platbu s testovací platební kartou:
Číslo karty: 4056070000000008
Platnost karty: 12/2020
CVC2: 200
Po úspěšné integraci e.shopu na testovacím prostředí napište na email gpwebpay@gpe.cz, ze strany platební brány Vám bude zaslán email s postupem pro přechod na produkční prostředí, nové integrační klíče budete muset opět nahrát do prostředí GP WebPay a do FTP, upravíte nastavení jmen klíčů v pluginu a vypnete checkbox Test v nastavení pluginu.
Na obrázku níže vidíme, jak se tato platební možnost i s ikonou zobrazuje na stránce Pokladna.
Změna veřejného klíče
Poté, co od poskytovatele služby GP WebPay získáte veřejný klíč, tento bude potřeba změnit. Níže naleznete návod, jak na to.
Testovací platební karta
Číslo karty: 4056070000000008
Platnost karty: 12/2020
CVC2: 200
1. Je nutno požádat o povoleni – změnu veřejného klíče na administraci gpwebpay na https://portal.gpwebpay.com/portal/. Poté napsat e-mail na podporu gpwebpay na stránce http://www.gpwebpay.cz/Contact, že žádáte o odblokování nahrání nového veřejného klíče v administraci gpwebpay. Potom, co Vám nahrání odblokují, přihláste se do portálu gpwebpay a budete moci změnit veřejný klíč na nový (klíč už se neposílá jako v minulosti).
2.Poté, co nám povolili vygenerování nového klíče (informovali nás mailem, že to máme povoleno), přejdeme na https://portal.gpwebpay.com/portal/, kde se přihlásíme a přejdeme do sekce e-shopy viz obrazek:
3.Zde se nám ukáže přehled našich eshopů. Je potřeba rozkliknout ten, u kterého chceme vložit nový veřejný klíč. Tady bude tlačítko button na změnu veřejného klíče/public key
Zde ho budeme moci nahrát.
4.Jestli si chcete vytvořit nový soukromny klíč, toto lze udělat v sekcii správa klíčů. Nahoře je položka: Vytvoření soukromého klíče.
Poté, co si soukromý klíč uložíme do počítače, je nutné jiít do sekce na stáhnutí na portálu gpwebpay, kde si stáhneme software JNLP – Application – GP webpay Keystore Manager, viz obrázek
5. Na spuštění programu je potřebna mit nainstalovanou Javu (https://java.com/en/). Otevřeme program a vyzve nás na povoleni javy. Stiskneme tlačitko RUN, viz obrázek
Otevře se nám Program keystore manager a zvolime režim pro vývojáře : viz obrázek níže
Po otevřeni je potřeba zadat cestu k soukromému klíči .key (pozor,ne public key ale private key ktery nám vygenerovala administrace gpwebpay při vytvoření soukromého klíče) a následně zvolit heslo, které jsme si zvolili při generování soukromého klíče v administraci gpwebpay při jeho vytváření.
Po vyexportovani klíčů z programu keystore do počitače to bude vypadat následovně.
Teď máme vyexportované 4 formáty klíče, mezi nimi je i veřejný klíč.
6. Přejdeme zpět do administrace gpwebpay, sekce e-shopy, rozklikneme si eshop, u kterého chceme nahrát public key (veřejni klíč) a klikneme na tlačítko změnit veřejný klíč. Klíč nahrajeme.
8. Zároveň je nutné nahrát klíče do FTP – do rootu záložky vašeho webu / všechny klíče, které nám vygeneroval GP webpay Keystore Manager.
9. Změníme si v nastavení modulu GPWebpay vasweb.cz na adrese http://www.vasweb.cz/wp-admin/admin.php?page=wc-settings&tab=checkout§ion=gpwebpay (Woocommerce/Nastaveni/Pokladna/gpwebpay) Jméno privátního klíče (program vygeneroval soubor s názvem gpwebpay-pvk), Jméno veřejného klíče (program vygeneroval soubor s názvem gpwebpay-pub). Důležité je mit i nastaveno číslo obchodnika, banku obchodnika a Heslo privátního klíče.
10. Jestli vše funguje, požádáme emailovu podporu GPWebpay o vypnutí změny veřejného klíče (viz krok 1 tohoto návodu), aby se z administrace už nedal změnit veřejný klíč (kvůli bezpečnosti).