Chyby a jejich řešení

Tento průvodce obsahuje nejčastější chyby při používání pluginu WPify Woo GP webpay a kroky k jejich vyřešení.

Chyby plateb

Ověření selhalo — neplatný podpis

Příčina: Podpis odpovědi z GP webpay nemohl být ověřen. To obvykle znamená, že veřejný klíč neodpovídá prostředí GP webpay, nebo je soubor klíče poškozený.

Řešení:

1. Ověřte, že Cesta k veřejnému klíči v WooCommerce → Nastavení → Platby → GP webpay ukazuje na správný soubor
2. Ujistěte se, že používáte veřejný klíč odpovídající zvolenému prostředí (Test vs. Produkce) — testovací a produkční prostředí používají různé veřejné klíče
3. Znovu stáhněte veřejný klíč z GP webpay a nahraďte soubor na serveru
4. Zkontrolujte, že soubor klíče nebyl změněn nebo poškozen při nahrávání (použijte binární/FTP režim přenosu)

Platba selhala — transakce odmítnuta GP webpay

Příčina: GP webpay odmítl platbu. K tomu může dojít z různých důvodů včetně nedostatečných prostředků, expirované karty nebo selhání 3D Secure.

Řešení:

1. Zkontrolujte poznámky objednávky ve WooCommerce pro konkrétní chybový kód vrácený GP webpay
2. Požádejte zákazníka, aby zkusil jinou kartu nebo kontaktoval svou banku
3. Ověřte, že Číslo obchodníka je správné
4. Pokud problém přetrvává u více zákazníků, kontaktujte podporu GP webpay

Objednávka zůstává ve stavu „Čeká na zaplacení" po platbě

Příčina: Callback z GP webpay nedorazil na váš web, nebo ověření odpovědi selhalo.

Řešení:

1. Zkontrolujte, že váš web je veřejně přístupný (není za heslem nebo IP omezením)
2. Ověřte, že žádný bezpečnostní plugin nebo firewall neblokuje požadavky na /wp-json/wpify-woo/v1/gpwebpay
3. Pokud používáte cachovací plugin, ujistěte se, že necachuje REST API endpointy
4. Zkontrolujte logy v WPify → WPify Logs pro plugin wpify-woo-gpwebpay — hledejte záznamy o callbacku a případné chyby
5. Ujistěte se, že váš SSL certifikát je platný — GP webpay nemusí přesměrovat na weby s neplatným certifikátem

Chyby konfigurace

GP webpay brána se nezobrazuje v platbách WooCommerce

Příčina: Plugin není aktivován nebo licence není platná.

Řešení:

1. Přejděte do Pluginy a ověřte, že WPify Woo GP webpay je aktivován
2. Přejděte do WPify → WPify Woo GP webpay a zkontrolujte stav licence
3. Přejděte do WooCommerce → Nastavení → Platby a povolte bránu GP webpay

Privátní klíč nenalezen

Příčina: Cesta k souboru privátního klíče je nesprávná, nebo soubor na zadaném místě neexistuje.

Řešení:

1. Ověřte Cestu k privátnímu klíči v nastavení brány — cesta musí být relativní k document rootu (např. wp-content/uploads/private/mykey.key)
2. Zkontrolujte, že soubor na serveru skutečně existuje na zadané cestě
3. Ujistěte se, že webový server má oprávnění ke čtení souboru klíče
4. Pokud jste klíč nahráli přes FTP, ujistěte se, že byl přenesen v binárním režimu

Často kladené otázky (FAQ)

Co je příznak stržení (deposit flag)?

Příznak stržení (deposit flag) určuje, kdy bude částka platby stržena z karty zákazníka:

• Okamžité stržení — celá částka je stržena ihned, jakmile zákazník dokončí platbu
• Autorizace — na kartě zákazníka je pouze vytvořena blokace (autorizace). Skutečné stržení musí být provedeno později přes administrační portál GP webpay. To je užitečné, když potřebujete ověřit objednávku před stržením.

Pokud používáte režim autorizace, nezapomeňte stržení provést v administraci GP webpay před vypršením autorizace (obvykle 7–30 dní v závislosti na vydavateli karty).

Kde získám privátní a veřejný klíč?

Klíče získáte od GP webpay v rámci procesu zřízení obchodního účtu:

1. Privátní klíč — vygenerujete si privátní klíč a žádost o podpis certifikátu (CSR). Privátní klíč zůstává na vašem serveru a nikdy se nesdílí.
2. Veřejný klíč — GP webpay poskytuje svůj veřejný klíč pro ověřování odpovědí na platby. Tento klíč je odlišný pro testovací a produkční prostředí.

Kontaktujte podporu GP webpay nebo svého obchodního zástupce pro podrobné instrukce ke generování klíčů. Obvykle poskytují dokumentaci a nástroje pro vytvoření páru klíčů.

Podporuje plugin refundace?

Ne, plugin nepodporuje automatické refundace přes WooCommerce. Refundace musí být zpracovány ručně v administračním portálu GP webpay.

Podporuje plugin opakované platby?

Ne, plugin nepodporuje opakované nebo předplatné platby. Je určen pouze pro jednorázové kartové platby.

Mohu plugin použít s blokovým checkoutem?

V současné době plugin podporuje pouze klasický WooCommerce checkout. Blokový checkout (WooCommerce Checkout Block) zatím není podporován.