---
site_name: Toret dokumentace
site_url: https://documentation.toret.cz
contact_email: info@toret.cz

title: Dokumentace pluginu Toret GP webpay
url: https://documentation.toret.cz/gp-webpay/
date: 2024-06-21
modified: 2026-07-09
author: tcirkl
type: page
---

# Dokumentace pluginu Toret GP webpay

Nacházíte se na stránkách dokumentace pluginu GP webpay, který **integruje platební bránu GP webpay** do WooCommerce.
Plugin GP webpay zakoupíte zde: [Toret GP webpay pro WooCommerce](https://toret.cz/produkt/woo-gp-webpay/)

Obsah

1. Instalace pluginu
2. Aktivace pluginu
3. Propojení s GP webpay
 - Propojení pluginu s platební bránou
 -
 - 1. Přihlášení do testovacího prostředí.
 -
 - 2. Vytvoření a uložení testovacího klíče
 -
 - 3. Nastavení přístupových údajů v pluginu
 -
 - 4. Nastavení platební metody
 - Nastavení sdružené platební metody
 -
 - Nastavení oddělených platebních metod
 - 5. Testovací platby
 -
 - 6. Přechod na produkční prostředí
4. Automatické načítání stavu plateb
5. Testovací platební karta
6. Časté dotazy
 - Chci mít číslování objednávek po sobě jdoucí
 -
 - Nejde mi propojení, i když jsem zadal vše správně
 -
 - PRCODE=3, SRCODE=7: Nepodporovaná měna
7. Testování pluginu

## Instalace pluginu

Po zakoupení pluginu obdržíte e-mailem licenční klíč a odkaz na stažení zip souboru s pluginem. Detailní návod, jak do WordPress nainstalovat plugin z počítače, najdete [zde](https://documentation.toret.cz/instalace-pluginu/).

## Aktivace pluginu

Po instalaci pluginu si otevřete plugin GP webpay, do příslušného pole vložte licenční klíč a ověřte licenci.

![Plugin Toret GP webpay - aktivace ](https://documentation.toret.cz/wp-content/uploads/2024/07/gp-webpay-licence-2.png "Plugin Toret GP webpay - aktivace ")

## Propojení s GP webpay

Po instalaci a aktivaci pluginu je možné pokračovat s napojením na GP webpay. Pro správnou implementaci GP webpay na váš e-shop budete potřebovat uzavřenou smlouvu s provozovatelem platební brány. V případě, že máte již vše vyřízené, obdržíte od poskytovatele platební brány přístupy do testovacího rozhraní.

Nastavení platební brány najdete v nastavení *WooCommerce → Pokladna → GP webpay.*

### Propojení pluginu s platební bránou

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.

Nejprve je nutné zprovoznit platební bránu v testovacím módu a provést testovací platby. Po provedení testovacích plateb (číslo testovací karty budete mít v e-mailu nebo ji najdete [zde](http://documentation2.toret.cz/gp-webpay/hlavni-nastaveni/#testovaci-platebni-karta)) a úspěšné kontrole za strany GP webpay obdržíte provozní přístupové údaje. Teprve s nimi je možné zahájit ostrý provoz platební brány.

Podrobný návod níže ↓

### **1. Přihlášení do testovacího prostředí.**

Přihlášení najdete na adrese [https://test.portal.gpwebpay.com/](https://test.portal.gpwebpay.com/). Přístupové údaje získáte e-mailem přímo od GP webpay při uzavření smlouvy.

Po přihlášení budete vyzváni k **potvrzení údajů a změně vygenerovaného hesla.** Na e-mail vám bude zaslán kód pro potvrzení změny.

### 2. Vytvoření a uložení testovacího klíče

Znovu se přihlaste. Nyní je třeba **vygenerovat 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**.

![Plugin Toret GP webpay - vytvoření a uložení soukromého klíče](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-woocommerce-gp-webpay-soukromy-klic-980x265-1-1.png "Plugin Toret GP webpay - vytvoření a uložení soukromého klíče")

V dalším kroku si ke klíči vytvořte libovolné heslo, které si poznamenejte. Budete jej dále potřebovat v účtu GP webpay a při nastavení pluginu viz. [Nastavení pluginu](https://documentation.toret.cz/#nastaveni-pluginu).

![Plugin Toret GP webpay - vytvoření a uložení soukromého klíče](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-woocommerce-gp-webpay-vytvoreni-soukromeho-klice-1024x436-1-1.png "Plugin Toret GP webpay - vytvoření a uložení soukromého klíče")

Po vytvoření se klíč stáhne do počítače.

![Plugin Toret GP webpay - vytvoření a uložení soukromého klíče](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-woocommerce-gp-webpay-vytvoreni-soukromeho-klice-2-1-1.png "Plugin Toret GP webpay - vytvoření a uložení soukromého klíče")

Nyní klíč uložíme do paměti prohlížeče: Vraťte se do sekce **Správa klíčů** a rozklikněte si e-shop.

![Plugin Toret GP webpay - vytvoření a uložení soukromého klíče](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-woocommerce-gp-webpay-vytvoreni-soukromeho-klice-3-980x292-1-1.png "Plugin Toret GP webpay - vytvoření a uložení soukromého klíče")

Poté vložte klíč, který se stáhl do počítače.

![Plugin Toret GP webpay - vytvoření a uložení soukromého klíče](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-woocommerce-gp-webpay-vytvoreni-soukromeho-klice-5-1024x450-1-1.png "Plugin Toret GP webpay - vytvoření a uložení soukromého klíče")

Při vkládání soukromého klíče do paměti prohlížeče 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.

![Plugin Toret GP webpay - vytvoření a uložení soukromého klíče](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-woocommerce-gp-webpay-vlozeni-soukromeho-klice-1.png "Plugin Toret GP webpay - vytvoření a uložení soukromého klíče")

Následně je nutné nahrát klíč do adresáře WordPressu. K tomu použijte funkci v nastavení pluginu „Nahrát privátní klíč“ (viz [3. Nastavení pluginu](https://documentation.toret.cz/#nastaveni-pluginu))

### 3. Nastavení přístupových údajů v pluginu

Po vytvoření klíčů v administraci GP Webpay přejděte do nastavení pluginu GP webpay, které najdete v *Toret plugins > GP webpay.* Zde je nutné vložit přístupové údaje pro propojení pluginu s platební bránou.

![Plugin Toret GP webpay - nastavení přístupových údajů](https://documentation.toret.cz/wp-content/uploads/2024/12/gpwebpay-pristupove-udaje-1024x515.png "Plugin Toret GP webpay - nastavení přístupových údajů")

**Testovací mód –** v tomto checkboxu aktivujete/deaktivuje testovací prostředí

**Číslo obchodníka** – do tohoto pole zadejte číslo obchodníka, které vám bylo přiděleno

**Heslo privátního klíče **– zde zadáte heslo, které jste si vytvořili ke klíči

**Nahrát privátní klíč** – přes tlačítko „vybrat soubor“ nahrajete vytvořený soukromý klíč

Na závěr provedené změny nezapomeňte uložit. Následně je možné přejít k nastavení platební metody.

### 4. Nastavení platební metody

Platební metodu nastavíte ve *WooCommerce > Nastavení > Pokladna*. Platební metoda *GP webpay* je sdružená metoda platby, přes kterou lze nastavit všechny platební metody dostupné pro vaši platební bránu. Tato metoda je kompatibilní pouze s výchozí WooCommerce pokladnou.

**Pokud v e-shopu používáte pokladnu s využitím bloků **(Gutenberg pokladna), je třeba nastavit oddělené platební metody (např. GP webpay: Platební karta, GP webpay: Moneta Bank atd.)

#### Nastavení sdružené platební metody

Jedná se o platební metodu *GP webpay*. Tato metoda platby je kompatibilní pouze s výchozí WooCommerce pokladnou a lze přes ni nastavit všechny dostupné metody platby pro tuto platební bránu.

![Plugin Toret GP webpay - nastavení sdružené platební metody](https://documentation.toret.cz/wp-content/uploads/2024/12/gp-webpay-sdruzene-platebni-metody-1024x566.png "Plugin Toret GP webpay - nastavení sdružené platební metody")

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

**Titulek** –  zde si můžete upravit název platební metody tak, jak se bude zobrazovat při výběru platební metody v pokladně

**Popis** – v tomto poli můžete pro zákazníka popsat instrukce k platbě

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

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

**Povolit GP webpay pro země** – specifikujte, pro které země bude brána dostupná

**Povolit platební metody – **nastavte platební metody, které chcete zákazníkovi zobrazit v pokladně

**Instrukce** – zde napište instrukce k platbě, které se budou zobrazovat na Děkovné stránce a v potvrzovacím e-mailu

Po vyplnění údajů nezapomeňte kliknout na tlačítko **Uložit změny.**

#### Nastavení oddělených platebních metod

Oddělené platební metody (např. GP webpay: Platební karta, GP webpay: Moneta Bank ap.) je nutné nastavit, pokud používáte pokladnu s využitím bloků (Gutenberg pokladnu). Nastavení proveďte obdobně pro všechny metody, které chcete v pokladně nabízet.

![Plugin Toret GP webpay - nastavení oddělených platebních metod](https://documentation.toret.cz/wp-content/uploads/2024/12/gp-webpay-oddelene-platebni-metody-1024x431.png "Plugin Toret GP webpay - nastavení oddělených platebních metod")

1. **Titulek** –  zde si můžete upravit název platební metody tak, jak se bude zobrazovat při výběru platební metody na pokladně

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

3. **Popis** – v tomto poli můžete pro zákazníka popsat instrukce k platbě

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

5. **Dostupné země** – specifikujte, pro které země bude brána dostupná

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

Provedené změny nezapomeňte uložit. Toto nastavení proveďte pro všechny metody, které chcete v pokladně nabízet.

### 5. Testovací platby

Po nastavení integrace a nastavení pluginu proveďte testovací platby s testovací platební kartou:

Testovací platba bez autentifikace:
4056070000000016, Exp. 12/33, CVV2 442
5213000000000028, Exp. 12/33, CVV2 365

Testovací platba s autentifikací:
4056070000000008, Exp. 12/33, CVV2 992
5434021016824014, Exp. 12/33, CVC2 277

### 6. Přechod na produkční prostředí

Po provedení testovacích plateb kontaktujte poskytovatele platební brány na e-mailu gpwebpay@gpe.cz. Po kontrole integrace vám ze strany platební brány bude zaslán e-mail s přístupem do produkčního prostředí. Zde si **vytvoříte nový produkční privátní klíč** (obdobně jako v [kroku 2 pro testovací prostředí](https://documentation.toret.cz/#klic)).

![Plugin Toret GP webpay - přechod na produkční prostředí](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gp-webpay-heslo-produkcniho-soukromeho-klice-1024x367-1-1.png "Plugin Toret GP webpay - přechod na produkční prostředí")![Plugin Toret GP webpay - přechod na produkční prostředí](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gp-webpay-generovani-produkcniho-soukromeho-klice-980x213-1-1.png "Plugin Toret GP webpay - přechod na produkční prostředí")![Plugin Toret GP webpay - přechod na produkční prostředí](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gp-webpay-vlozeni-produkcniho-soukromeho-klice-1024x447-1-1.png "Plugin Toret GP webpay - přechod na produkční prostředí")

**Nový privátní klíč budete muset opět nahrát přes nastavení pluginu GP webpay do adresáře WordPressu.** V případě, že jste u soukromého klíče zvolili nové heslo, tak **do pluginu uložte také nové heslo a poté vypněte checkbox Test** v nastavení pluginu. (viz krok 3 [Nastavení pluginu](https://documentation.toret.cz/#nastaveni-pluginu))

## Automatické načítání stavu plateb

V případě dokončení platby je zákazník přesměrován na děkovnou stránku. Zároveň je předána notifikace o tom, že je objednávka uhrazena a dojde ke změně stavu objednávky na Zpracovává se (u fyzických produktů) nebo na Dokončeno (u virtuálních produktů).

Může se však stát, že zákazník z nějakého důvodu nebyl po uhrazení objednávky přesměrován na děkovnou stránku. V tom případě plugin nemá žádnou informaci od platební brány o tom, že je objednávka uhrazena. Aby nedošlo k tomu, že uhrazené objednávky bez notifikace budou funkcí WooCommerce zrušeny, je nutné nastavit funkci automatického načítání plateb.

Nastavení automatického načítání stavu platby najdete po kartou *Toret Plugin → GP webpay. *

![Toret GP WebPay – Automatické načítání stavu platby](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gp-webpay-automaticke-nacitani-stavu-platby-1024x588-1.png "Toret GP WebPay – Automatické načítání stavu platby")

1) Nastavte počet dní pro zpětnou kontrolu stavů plateb u objednávek, tedy v jakém zpětném časovém horizontu se budou objednávky kontrolovat.

![Toret GP WebPay – nastavení počtu dní pro zpětnou kontrolu](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gp-webpay-nastaveni-poctu-dni-pro-zpetnou-kontrolu.png "Toret GP WebPay – nastavení počtu dní pro zpětnou kontrolu")

2) Pokud nechcete kontrolovat stav platby u všech objednávek, je možné vybrat jednotlivé stavy objednávek, které se z kontroly vyřadí. Rozhodně **nedoporučujeme** **vylučovat** stav Čeká na platbu, Selhalo a Zrušeno.

![Toret GP WebPay – nastavení stavů objednávky, které se nebudou kontrolovat](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gp-webpay-nastaveni-stavu-objednavky-ktere-se-nebudou-kontrolovat.png "Toret GP WebPay – nastavení stavů objednávky, které se nebudou kontrolovat")

3) Nastavení změny stavu objednávky podle stavu platby.

Funkci změny stavu objednávky na základě stavu platby je nutné povolit aktivací checkboxu a uložením.

![Toret GP WebPay – aktivace změny stavu objednávky na základě stavu platby](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gp-webpay-aktivace-zmeny-stavu-oabjednavky-na-ziklade-stavu-platby.png "Toret GP WebPay – aktivace změny stavu objednávky na základě stavu platby")

V případě, že chcete po potvrzení úhrady změnit stav objednávky např. na „Zpracovává se“, je třeba jej nastavit u stavu platby „Požadavek na stržení“. **Ve stavu platby „Požadavek na stržení“ se bere objednávka jako uhrazená.**

![ Toret GP WebPay – změna stavu objednávky podle stavu platby](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gp-webpay-zmena-stavu-objednavky-podle-stavu-platby-1024x407-1.png " Toret GP WebPay – změna stavu objednávky podle stavu platby")

4) Aby se stav plateb aktualizoval podle nastavení z předchozích tří bodů, je nutné na hostingu nastavit URL CRONu, která je uvedená v nastavení u vás na webu. CRON doporučujeme pravidelně spouštět, minimálně 1x za hodinu.

![ Toret GP WebPay – nastavení CRONu](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gp-webpay-nastaveni-cronu.png " Toret GP WebPay – nastavení CRONu")

[](http://documentation2.toret.cz/gp-webpay/wp-content/uploads/sites/28/2024/03/toret-gp-webpay-nastaveni-cronu.png)

## Testovací platební karta

Testovací platba bez autentifikace:

- 4056070000000016, Exp. 12/33, CVV2 442
- 5213000000000028, Exp. 12/33, CVV2 365

Testovací platba s autentifikací:

- 4056070000000008, Exp. 12/33, CVV2 992
- 5434021016824014, Exp. 12/33, CVC2 277

## Testování pluginu

Pro účely testování můžete využít:

- subdoménu “dev.doménalicence” (se stejnou licencí jako pro produkční web)
- localhost (127.0.0.1)

Na těchto umístěních budou zakoupené pluginy fungovat také a můžete zde otestovat implementaci a kompatibilitu před ostrým nasazením na web i v průběhu jeho užívání.

## Časté dotazy

### Chci mít číslování objednávek po sobě jdoucí

Plugin je kompatibilní s Custom Order Numbers for WooCommerce.

### Nejde mi propojení, i když jsem zadal vše správně

Zkontrolujte, zda vaše heslo neobsahuje speciální znaky (například < nebo >). WordPress tyto znaky ošetřuje rozložením, což může způsobit neplatné ověření hesla.

V případě hesla se speciálním znakem doporučujeme jeho přegenerování.

### PRCODE=3, SRCODE=7: Nepodporovaná měna

Tato chyba vznikne po přesměrování na platební bránu, pokud u GP webpay nemáte aktivní měnu, ve které byla provedena objednávka.

Kontaktujte podporu GP webpay, aby Vám použitou měnu u vašeho účtu povolila.