Hlavní nastavení
Poznámka: Pro implementaci platební brány potřebuje mít dokončenou registraci u Comgate.
Propojení Comgate s WooCommerce
Comgate payment je platební brána nabízející několik platebních metod. Toret plugin Woo Comgate propojuje tuto platební bránu s Vaším e-shopem, resp. WooCommerce.
V přní řadě je nutné v administraci účtu platební brány Comgate povolit IP adresy serveru, kde je web hostován. Pokud nebudou IP adresy povoleny, v pluginu se po vložení implementačních údajů nenačtou jednotlivé platební metody a platby přes platební bránu nebudou fungovat!
IP adresy se nemusí definovat jednotlivě, ale mohou být zapsány jako rozsah. Tedy IP adresa následována lomítkem a číslem určujícím počet uzamknutých bitů adresy (tzv. maskou sítě). Například tedy zápis 192.168.1.0/24 vám tedy povolí IP adresu začínající 192.168.1. s libovolným posledním číslem.
Další důležitou věcí než spustíte „ostrou“ verzi plateb přes ComGate je, že budete muset provádět tzv. testovací platby. Seznam všech testovacích plateb naleznete pod Technické připojení – Testovací platby. Máte možnost zadát specifické údaje pro filtraci, pokud nechcete zobrazit všechny, ale hledáte jen nějaké/nějakou konkrétní.
Pro správné fungování pluginu musíme nejprve získat ID obchodu, Secure key a propojit obchod s platební bránou na klientském portálu Comgate. Poté jak ID obchodu, tak Secure key zadáme při nastavení platebních metod ve WooCommerce v administraci e-shopu, viz články Nastavení platební metody Comgate a Nastavení Comgate – bankovní převod.
Pojďmě si tedy říci, co je nutné nastavit na portálu Comgate poté, co jste již od společnosti obdrželi ID, secure key a přihlašovací údaje.. Po přihlášení přejděte v menu po levé straně do záložky Nastavení obchodů a vyberte ten, který chcete spravovat (v případě, že je více jak jeden), poté klikněte na Propojení obchodu a nakonec na ikonu oka Náhled.
Objeví se nová obrazovka s následujícím menu.
Jak už jsem zmínili výše, jak identifikátor obchodu, tak heslo (secure key) se nastavuje také ve WooCommerce.
Povolený způsob založení platby zvolte buď BACKEND nebo SIMPLE_REDIRECT.
Velmi důležitá jsou následující pole, kde je potřeba doplnit tyto URL adresy:
URL zaplacený:
http://vas-eshop.cz/?comgate=paid&id=${id}&refId=${refId}
URL zrušený:
http://vas-eshop.cz/?comgate=delete&id=${id}&refId=${refId}
URL nevyřízený:
http://vas-eshop.cz/?comgate=failed&id=${id}&refId=${refId}
URL pro předání výsledku platby:
http://vas-eshop.cz/?comgate=notify
Pod záložkou Testovací logy bude také záznam plateb, ale navíc tam můžete najít chyby, kvůli kterým se platba nezdařila.
Nastavení platebních metod
Poté, co jsme plugin aktivovali, více v článku Aktivace pluginu, je nutné ho nastavit pro jeho správné fungování.
Plugin Woo Comgate je platební brána, která umožňuje Vašim zákazníkům platbu pomocí kterékoliv platební metody, kterou Comgate nabízí. Platba bankovním převodem bude v budoucnu zrušena.
V Nástěnce WordPress přejděte do záložky WooCommerce – Nastavení. Zobrazí se Vám tabulka, kde ve vrchní liště v menu klikněte na Pokladna a poté v podmenu na Comgate. K dispozici budete mít menu s možnostmi nastavení.
Pojďme si podrobněji popsat jednotlivé kroky:
1. Povolit /Zakázat – zaškrtnutím tohoto políčka, určíte, zda budou mít zákazníci tuto platební metodu k dispozici či ne
2. Titulek – zde je nutné zadat název platební metody tak, jak se bude zobrazovat při výběru platební metody na pokladně
3. Popis – v tomto poli můžete popsat platební metodu pro zákazníka, to, co má udělat
4. Ikona platební metody – pokud chcete, aby se u platební metody na pokladně objevila i příslušná ikona, zadejte její url zde
5. ID obchodu – zde zadejte ID obchodu z portálu Comgate
6. Secure key – do tohoto pole zkopírujte secure key, který Vám byl přidělen od Comgate
7. Test mód – checkbox pro aktivaci a desaktivaci testovacího prostředí platební brány
8. Povolit Comgate platební metody – zde se zadají veškeré platební metody, které platební brána Comgate poskytuje!!
9. Povolit způsob dopravy – v případě, že chcete povolit všechny způsoby dopravy, ponechte toto pole prázdné. Pokud máte aktivní platbu na dobírku, zde můžete definovat způsob dopravy
10. Povolit ComGate pro země – sem zadejte všechny země, pro které má být povolena tato platební metoda
Po vyplnění údajů nezapomeňte kliknout na tlačítko Uložit změny.
Na obrázku níže vidíme, jak se tato platební možnost i s ikonou a nabídkou jednotlivých platebních metod zobrazuje na stránce Pokladna.
Nastavení Comgate – URL
Pro správné fungování pluginu je potřeba ve Vašem zákaznickém účtu u Comgate nastavit 4 následující URL adresy:
Url zaplacený:
https://vas-eshop.cz/?comgate=paid&id=${id}&refId=${refId}
Url zrušený:
https://vas-eshop.cz/?comgate=delete&id=${id}&refId=${refId}
Url nevyřízený:
https://vas-eshop.cz/?comgate=failed&id=${id}&refId=${refId}
Url pro předání výsledku platby:
https://vas-eshop.cz/?comgate=notify
Filtry v pluginu
$account = apply_filters( ‚toret_comgate_send_account‘, “, $order );
includes/class-wc-gateway-comgate.php
$account = apply_filters( ‚toret_comgate_send_account_bank‘, “, $order );
includes/class-wc-gateway-comgate-bank.php
Změna stavu zaplacené objednávky s fyzickým produktem na vlastní stav
add_filter("toret_comgate_custom_status_paid", "toret_comgate_custom_status_paid_fce", 10, 1 );
if ( !function_exists( "toret_comgate_custom_status_paid_fce" ) ) {
function toret_comgate_custom_status_paid_fce( $status) {
return "slug vlastního stavu";
}
}
Změna stavu zaplacené objednávky s virtuálním produktem na Zpracovává se (processing)
add_filter("toret_comgate_custom_status_paid_virtual", "toret_comgate_custom_status_paid_virtual_fce", 10, 1 );
if ( !function_exists( "toret_comgate_custom_status_paid_virtual_fce" ) ) {
function toret_comgate_custom_status_paid_virtual_fce( $status) {
return "processing";
}
}
Platby na splátky
Platby na splátky jsou dostupné pouze pro Českou republiku a u objednávek nad 2000 Kč.
Jak aktivovat nové platební metody z Comgate ve WooCommerce?
Nejprve musíte kontaktovat Comgate.cz a požádat o aktivaci plateb na splátky. Po jejich povolení můžete jít do nastavení platební metody ve WooCommerce (WooCommerce → Nastavení → Pokladna → Comgate) a zde si je v poli Povolit Comgate platební metody aktivovat.