Chyby a jejich řešení

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

Chyby plateb

Objednávka zůstává ve stavu „Čeká na zaplacení" po úspěšné platbě v ThePay

Příčina: Notifikace o platbě z ThePay nedorazila na váš web, nebo byla přijata, ale aktualizace stavu objednávky selhala.

Řešení:

1. Zkontrolujte, že váš web je veřejně přístupný (není za heslem nebo IP omezením)
2. V detailu WooCommerce objednávky klikněte na tlačítko Zkontrolovat stav platby (pokud je k dispozici) pro ruční ověření platby u ThePay
3. Zkontrolujte logy v WPify → WPify Logs pro plugin wpify-woo-thepay — hledejte záznamy o notifikacích a případné chyby
4. Ověřte, že žádný bezpečnostní plugin nebo firewall neblokuje požadavky na /wp-json/wpify-woo/v1/thepay/notify
5. Pokud používáte cachovací plugin, ujistěte se, že necachuje REST API endpointy

Chyba „Order number mismatch" v logách

Příčina: Číslo objednávky uložené v ThePay platbě se neshoduje s číslem WooCommerce objednávky. K tomu může dojít, když plugin mění čísla objednávek (např. plugin pro sekvenční čísla objednávek) po vytvoření platby.

Řešení:

1. Zkontrolujte, zda používáte plugin, který mění čísla WooCommerce objednávek
2. Plugin se pokouší párovat platby jak podle ID objednávky, tak podle čísla objednávky — tato chyba je obvykle informativní
3. Pokud se stav objednávky neaktualizoval správně, použijte tlačítko Zkontrolovat stav platby v detailu objednávky
4. Pokud se to děje často, kontaktujte podporu

Platební stránka zobrazuje chybu nebo se nenačte

Příčina: Neplatné API přístupové údaje nebo špatné nastavení prostředí.

Řešení:

1. Ověřte Merchant ID, API Heslo a ID Projektu v WPify → ThePay
2. Ujistěte se, že používáte správné údaje pro zvolené prostředí (test vs. produkce)
3. Zkontrolujte, že váš ThePay účet je aktivní
4. Prohlédněte logy pro chybové odpovědi API

Chyby konfigurace

ThePay 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 ThePay je aktivován
2. Přejděte do WPify → ThePay a zkontrolujte stav licence
3. Ujistěte se, že jste zadali API přístupové údaje
4. Přejděte do WooCommerce → Nastavení → Platby a povolte bránu ThePay

Seznam platebních metod je prázdný v nastavení brány

Příčina: Plugin nemohl získat dostupné platební metody z ThePay API.

Řešení:

1. Zkontrolujte, že vaše API přístupové údaje jsou správné
2. Ověřte, že nastavení prostředí (Test/Produkce) odpovídá vašim údajům
3. Znovu uložte nastavení — plugin načítá dostupné metody při uložení
4. Zkontrolujte logy pro chyby komunikace s API

Stržení nebo zrušení předautorizace nefunguje

Příčina: Přechod stavu objednávky neodpovídá nastaveným stavům pro stržení/zrušení.

Řešení:

1. V WooCommerce → Nastavení → Platby → ThePay Karta ověřte nastavení Stržení předautorizované platby na stavech a Zrušení předautorizované platby na stavech
2. Ujistěte se, že měníte objednávku na jeden z nakonfigurovaných stavů
3. Zkontrolujte, zda předautorizace již nevypršela (obvykle 7–30 dní)
4. Prohlédněte poznámky objednávky a logy pro chybové zprávy z ThePay

Problémy s migrací

Přechod z ThePay 1.0 na ThePay 2.0

Příčina: Přecházíte ze staršího pluginu ThePay 1.0 na tuto integraci ThePay 2.0.

Řešení:

1. Deaktivujte a odinstalujte starý plugin ThePay 1.0
2. Nainstalujte a aktivujte WPify Woo ThePay
3. Zadejte vaše přístupové údaje k ThePay 2.0 API (jsou odlišné od ThePay 1.0)
4. Stávající objednávky zpracované přes starou bránu si zachovají svá platební data, ale nové platby půjdou přes ThePay 2.0
5. Pokud potřebujete podporu HPOS (High-Performance Order Storage), povolte ji po odebrání starého pluginu

Často kladené otázky (FAQ)

Jaké platební metody ThePay podporuje?

ThePay podporuje kartové platby (Visa, Mastercard), Apple Pay, Google Pay, tlačítka bankovních převodů (Platba 24, ČSOB, mBank, Fio, MONETA aj.), platby Bitcoinem a PlatimPak (kupte nyní, zaplaťte později). Dostupné metody závisí na konfiguraci vašeho obchodního účtu ThePay.

Mohu používat hlavní bránu ThePay i jednotlivé kanálové brány současně?

Ano, můžete povolit hlavní bránu ThePay (která zobrazí všechny metody na jedné stránce) vedle jednotlivých bran jako ThePay – Karta nebo ThePay – Apple Pay. Zákazníci uvidí každou povolenou bránu jako samostatnou možnost na pokladně. Ujistěte se, že nemáte stejnou platební metodu povolenou v hlavní bráně i v jednotlivém kanálu, aby nedošlo k záměně.

Funguje předautorizace se všemi platebními metodami?

Ne, předautorizace je podporována pouze pro brány Karta, Apple Pay a Google Pay. Bankovní převody, Bitcoin a PlatimPak předautorizaci nepodporují.

Jak mohu testovat platby bez zpracování reálných transakcí?

Nastavte Prostředí na Test v WPify → ThePay a použijte testovací přístupové údaje z vašeho sandbox účtu ThePay. Testovací platby se chovají jako skutečné, ale žádné peníze se ve skutečnosti nepřevádějí.

Mohu pro QR platby použít vlastní bankovní účet?

Ne, všechny platby včetně QR plateb procházejí přes ThePay. Platba je zpracována ThePay a poté vyúčtována na váš obchodní účet dle podmínek vaší smlouvy s ThePay.