> For the complete documentation index, see [llms.txt](https://napoveda.rocketoo.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://napoveda.rocketoo.cz/rocketoo/rozsireni/gp-webpay.md). # GP webpay **Modul GP webpay** je rozšíření, které umožňuje napojení e-shopu na platební bránu **GP webpay**. Umožňuje bezpečné a víceměnové platby přes karty, mobilní aplikace i bankovní převody. Nabízí automatizované zpracování plateb, správu stavů objednávek a bezpečnostní prvky jako validaci podpisů či šifrování komunikace. ## **Hlavní funkce modulu** ### **Správa plateb přes GP webpay** Modul automaticky vytváří platební požadavky při dokončení objednávky. Zákazník si může zvolit preferovaný způsob platby a modul po zaplacení aktualizuje stav objednávky. ### **Podporované metody:** * Platební karty (CARD) * Mastercard Mobile * Masterpass * Google Pay * Apple Pay * Bankovní převody (např. Platba24, ČS, KB aj.) * Víceměnové transakce (např. CZK, EUR) ### **Stavy objednávek dle výsledku platby** Modul rozlišuje a automaticky nastavuje tyto stavy objednávek: * Úspěšná platba (PAID) * Zrušená platba (CANCELLED) * Vytvořená platba (CREATED – čeká na dokončení) * Neúspěšná platba (FAIL) ### **Automatizace a webhook notifikace** Platební požadavky jsou vytvářeny automaticky při objednávce. Modul podporuje webhooky pro okamžité aktualizace stavu platby, takže e-shop vždy pracuje s aktuálními informacemi. * Automatická synchronizace stavů * Okamžité zpracování notifikací přes webhooky * Validace a kontrola proti duplicitám ### **Nastavení a bezpečnost** V administraci Rocketoo lze snadno nastavit přístupové údaje, testovací/produkční prostředí i mapování stavů objednávek. Modul obsahuje bezpečnostní prvky jako validace podpisů a šifrovaná komunikace s bránou. * Číslo obchodníka (Merchant Number) * Privátní a veřejný klíč * Výběr prostředí (testovací / produkční) ## Propojení brány s e-shopem Po [objednání platební brány](https://www.gpwebpay.cz/objednat/) a následném uzavření smlouvy dostanete přístup do testovacího prostředí. To nemusíte v Rocketoo řešit, protože napojení na bránu je již připraveno a otestováno, můžete tedy rovnou požádat o zprovoznění do **ostrého režimu**. ## Nastavení ostrého režimu Přejděte na stránky portálu na . Zde vyplňte **název** vaší společnosti, **uživatelské jméno** a **heslo**. Poté klikněte na tlačítko **Přihlásit** a vstoupíte do administrace.
### **Jak vygenerovat soukromý klíč** Po přihlášení se dostanete na hlavní menu. Zde zvolte možnost **Správa klíčů**, pomocí které vygenerujete váš soukromý klíč.
Stiskem tlačítka **Vytvořit** zahájíte **generování klíče.**
Zobrazí formulář, do kterého uživatel zadá zvolené heslo k soukromému klíči. Délka hesla musí být alespoň 8 znaků, je potřeba použít alespoň 3 z těchto typů znaků: * Velké písmeno * Malé písmeno * Číslice * Speciální znak Po stisku dalšího tlačítka **Vytvořit** se vytvoří soukromý klíč (soubor *gpwebpay-pvk.key*), který je potřeba si uložit (např. na pevný disk počítače).
### **Nahrání soukromého klíče a hesla** V dalším kroku **vyberte váš obchod** a vložte soukromý klíč do paměti prohlížeče. Po stisku tlačítka **Vložit klíče** se zobrazí formulář pro zadání cesty a hesla k soukromému klíči. V dalším kroku budete vyzváni k vložení soukromého klíče na server GP webpay. Použijte tlačítko **Procházet** na vašem počítači k nalezení a vložení certifikátu, který jste si stáhli a uložili v předchozím kroku. Do pole **Heslo k soukromému klíči** vložte heslo, které jste si vytvořili rovněž v předchozím kroku. Po zadání všech údajů stačí stisknout tlačítko **Potvrdit**, čímž dojde k nahrání klíče na server.
### Merchant ID Kromě certifikátu a hesla budete k propojení potřebovat také tzv. **Merchant ID**. Tuto informaci můžete najít například v sekci **E-shopy** pod názvem vašeho obchodu. ### Stažení veřejného klíče Přejdete na hlavní stránku administrace GP webpay a na dlaždicích hlavního menu zvolte **Ke stažení**. Zde vyberte řádek **GPE production public key (soubor „GPE\_production\_public\_key.zip“)** a dejte **Stáhnout**. Stažený soubor rozbalte. Při následujícím nastavování v e-shopu budete potřebovat soubor ***gpe.signing\_prod.pem***. Nebo jej můžete stáhnout zde. {% file src="/files/JqlED75uAAzMrrfiVhoi" %} ## Nastavení v e-shopu V administraci vašeho e-shopu přejdete do části **Nastavení** / **Rozšíření** / **Online platby** a zvolte záložku **GP webpay**.
Do pole **Přidělené číslo obchodníka (Merchant ID)** vložte vaše zkopírované Merchant ID. Pak vyberte váš uložený privátní klíč a vložte jej do pole **Privátní klíč** a následně zadejte heslo k tomuto klíči do pole **Heslo k privátnímu klíči**. Do pole **Veřejný klíč** vyberte veřejný klíč, který jste si stáhli z portálu (*gpe.signing\_prod.pem*). V části **Stavy objednávek po platbě** nastavte, které stavy se mají objednávce nastavit po úspěšné platbě nebo při stornu.