# 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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://napoveda.rocketoo.cz/rocketoo/rozsireni/gp-webpay.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.