# 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 <https://portal.gpwebpay.com/portal/anon/login.xhtml>. 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.

<figure><img src="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2FLLEdvqt0rU4FmqmNppcc%2Fgpwp01.png?alt=media&#x26;token=5f2632be-4199-4a57-89c2-f3d56f116272" alt=""><figcaption></figcaption></figure>

### **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íč.

<figure><img src="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2F2EZjimSF0YeWypJRgkxU%2Fgpwp03.png?alt=media&#x26;token=d551ae9c-0bb4-48cf-9dac-c310c412a913" alt=""><figcaption></figcaption></figure>

Stiskem tlačítka **Vytvořit** zahájíte **generování klíče.**

<figure><img src="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2F54vV82EJeFHmtpRR7N3m%2Fgpwp02.png?alt=media&#x26;token=f42db365-6e2c-4954-97eb-b8b85e05c60b" alt=""><figcaption></figcaption></figure>

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).

<figure><img src="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2FWwGcqHwxBIBoZDrcmGVf%2Fgpwp04.png?alt=media&#x26;token=7d8eec68-2876-4f93-b8de-7d78bfc1cf42" alt=""><figcaption></figcaption></figure>

### **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.

<figure><img src="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2Fl5ukTwlj3dhjTIiWa2UK%2Fgpwp05.png?alt=media&#x26;token=095c152d-5f9d-4500-872b-71b063eaca35" alt=""><figcaption></figcaption></figure>

### 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="<https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2FNBlchbRRKrNPPRWAvRfO%2Fgpe.signing_prod.pem?alt=media&token=1b640dda-79d1-4ebc-bbf2-7b52feb30d9d>" %}

## 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**.

<figure><img src="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2FFusy9JEGIcTOyypf5npu%2Fgpwp06.png?alt=media&#x26;token=17e7a226-fa7a-4b9f-affc-d5ed8f3f8a00" alt=""><figcaption></figcaption></figure>

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.