Dokumentace pluginu Toret ThePay 2.0

Nacházíte se na stránkách dokumentace pluginu ThePay 2.0, který do WooCommerce integruje platební bránu ThePay 2.0.

Pro implementaci platební brány potřebuje mít dokončenou registraci ThePay 2.0.

Obsah
  1. Instalace pluginu
  2. Aktivace pluginu
  3. Základní nastavení pluginu
  4. Implementační údaje ThePay 2.0
  5. Povolení IP adresy pro komunikaci s API
  6. Časté dotazy
  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.

Aktivace pluginu

Po instalaci pluginu si otevřete plugin ThePay 2.0, do příslušného pole vložte licenční klíč a tlačítkem aktivujte.

Základní nastavení pluginu

Po nainstalovaní a aktivaci pluginu pokračujte na jeho nastavení. To se nachází v sekci WooCommerce → Nastavení → Pokladna → ThePay 2.0

Po rozkliknutí detailu platební metody ThePay 2.0 můžete začít s nastavováním.

Nastavení pluginu obsahuje následující položky:

  • Povolit/Zakázat: Zaškrtnutím aktivujete platební metodu.
  • Titulek: Zadejte název platební metody, který se bude zobrazovat v pokladně a košíku.
  • Popis: Zde je možné přidat poznámku k platební metodě ThePay, která se zobrazí v pokladně.
  • Ikona platební metody: Pokud chcete na stránce pokladny zobrazovat vlastní ikonu pro platební metodu ThePay, zadejte sem celou URL obrázku.
  • ID obchodníka: Zadejte implementační údaj získaný z účtu ThePay.
  • ID projektu: Zadejte implementační údaj získaný z účtu ThePay.
  • Heslo: Zadejte implementační údaj získaný z účtu ThePay pod kartou Implementace. Nejedná se o přihlašovací heslo do účtu ThePay!
  • Povolit způsob dopravy: Vyberte pro jaké dopravy chcete mít tuto platební bránu dostupnou. Pro povolení všech způsobů dopravy nechte pole prázdné.
  • Povolit ThePay platební metody: Vyberte jaké ThePay platební metody chcete mít v pokladně dostupné.
  • Povolit ThePay pro země: Vyberte pro jaké země se bude platební brána používat.
  • Instrukce: Zde lze napsat dodatečné informace o platební metodě pro uživatele. Zobrazí se v e-mailu zákazníkovi.

Implementační údaje ThePay 2.0

Po uzavření smlouvy s poskytovatelem platební brány ThePay najdete implementační údaje ve svém ThePay účtu pod kartou Implementace.

Tyto údaje si zkopírujte a následně vložte do stejnojmenných polí v nastavení pluginu.

Povolení IP adresy pro komunikaci s API

Posledním krokem je povolení IP adres v administraci účtu ThePay. Toto nastavení najdete pod kartou Implementace.

Jedná se o IP adresy serveru, kde hostujete web. Pro získání těchto IP adres se obraťte na svůj hosting.

V případě potřeby specifikace subnetu je možné využít hvězdičkovou konvenci.

Například. 19.2.168.* pro subnet 192.168.00 -192.168.255.255

Po povolení všech IP adres použijte samotnou *.

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

Po dokončení objednávky není zákazník přesměrován na platební bránu ThePay

Pokud si zákazník vybere platební metodu ThePay, dokončí objednávku, objednávka se vytvoří ve WooCommerci, ale zákazník není přesměrován na platební bránu, může se jednat o následující problémy:

  1. Špatně zadané implementační údaje v pluginu z administrace ThePay.  
  2. Desynchronizaci času. Kontaktujte podporu ThePay a nechte si chybnou platbu prověřit. Jejich podpora Vám případně potvrdí desynchronizaci času se serverem, kde hostujete web. V tomto případě bude nutné synchronizovat čas serveru.  

Úprava stavu zaplacené objednávky

Po uhrazení objednávky přes ThePay plugin změní její stav z „Čeká na platbu“ (Pending) na „Zpracovává se“ (Processing) v případě, že objednávka obsahuje fyzické produkty, nebo plugin změní objednávku na stav „Dokončeno“ (Completed), pokud je tvořená pouze z virtuálních produktů.

V případě, že vám stav objednávky po uhrazení nevyhovuje, můžete jej upravit pomocí filtru.

Objednávka virtuálních produktů:

add_filter(‚toret_thepay20_virual_paied_product_status‘,’cutom_toret_thepay20_virual_paied_product_status‘,10,2);
function cutom_toret_thepay20_virual_paied_product_status($status,$order_id){
return ‚processing‘;
}

Objednávka fyzických produktů:

add_filter(‚toret_thepay20_paied_product_status‘,’custom_toret_thepay20_paied_product_status‘,10,2);
function custom_toret_thepay20_paied_product_status($status,$order_id){
return ‚processing‘;
}

Příklad je uveden pro změnu stavu objednávky na „Zpracovává se“.

Filtr vložíte do child šablony functions.php nebo do prázdného pluginu např.: https://toret.cz/produkt/boilerplate/

Přejít nahoru