Napojení na platební bránu Comgate

Celkové propojení eshopu s online platební bránou Comgate. V dnešní době nejvíce využívaná a z naší strany nejspolehlivější a nejvýhodnější platební brána.

Základní vlastnosti platební brány

  • Platby kartou  VISA, VISA Electron, MasterCard, Maestro, Diners Club
  • Platby kartou v 7 měnách -  CZK, EUR, PLN, HUF, RON, USD, GBP
  • Všechna dostupná platební tlačítka bank v České republice, Polsku a na Slovensku (seznam bank naleznete zde
  • Peníze Vám budou zasílány denně a zdarma na jakýkoliv bankovní účet
  • Responzivní desing pro platbu z telefonu nebo tabletu

Vedení platební brány v číslech

  • Při měsíčním objemu transakcí do 100 tis. Kč je sazba z transakcí 0,99% a měsíční poplatek za správu platební brány je 149 Kč
  • Při měsíčním objemu transakcí od 100 - 500 tis. Kč je sazba z transakcí 0,89% a měsíční poplatek za správu platební brány je 99 Kč
  • Při měsíčním objemu transakcí do 500 tis. - 3 mil. Kč je sazba z transakcí 0,79% a měsíční poplatek za správu platební brány je 0 Kč
  • Svoji úsporu si můžete spočítat zde: https://www.comgate.cz/cz viz obr. 1.

obr. 1 kalkulačka Comgate

Propojení platební brány comgate s eshopem

  1. Přihlášení do aplikace Comgate

Jakmile budete mít s Comgate podepsanou smlouvu, tak se přihlásíte do klientské zóny na adrese https://portal.comgate.cz/cs/prihlaseni . Od Comgate jste obrželi informace k přihlášení a ty vyplníte. Mají to chráněné pomocí dvoufázového ověření, tedy v prvním kroku se přihlásíte a v druhém kroku zadáte kód, který Vám přišel na Váše telefonní číslo (vyplněné ve smlouvě).
  1. Nastavení obchodů v klientské sekci

Úspěšně jste se dostali do klientské sekce Comgate, odkud budete platební bránu spravovat a uvidíte zde přehled plateb. Nejdůležitěším krokem je nastavit URL adresu stavů a IP adresu. 
Váš eshop naleznete v  Integrace > Nastavení obchodů > "název Vašeho eshopu" viz obr. 2. Zobrazí se Vám stránka Nastavení obchodu "název vašeho eshopu" a kliknete na sekci "Propojení obchodu" viz obr. 3. V propojení klikněte na prostřední obrázek "tužky" nebo-li upravit.
 obr. 2 Nastavení eshopu
obr. 3 Propojení obchodu
  1. Nastavení URL adres a IP adresy

Právě zde se nachází veškeré důležité informace, které budete potřebovat buď zjistit nebo nastavit - viz obr. 4. Do eshopu budete vkládat hodnoty "Identifikátor propojení obchodu" a "heslo".
 
URL adresy stavů, které jsou nastavené jako vychozí v comgate se s těmi níže uvedenými liší a je zapotřebí kompletně je zkopírovat a upravit pouze Vaší doménu.
 
V této sekci musíte nastavit URL adresy stavů, které jsou v tomto tvaru:
Url zaplacený
https://vaše-doména.cz/platby/comgate.php?id=${id}&refId=${refId}&stav=zaplaceno
Url zrušený
https://vaše-doména.cz/platby/comgate.php?id=${id}&refId=${refId}&stav=zruseno
Url nevyřízený
https://vaše-doména.cz/platby/comgate.php?id=${id}&refId=${refId}&stav=nevyrizeno
Url pro předání výsledku
 
ZKONTROLUJTE SI PROSÍM ZDA MÁTE DOMÉNU S WWW NEBO BEZ. POKUD S WWW, TAK JE MUSÍTE DOPLNIT I DO TĚCHTO URL ADRES. Pokud si nejste jistí, tak stačí v prohlížeči zkopírovat URL.
 
 
Poslední důležitý údaje je "Povolené IP adresy", kde zadáte IP adresu. Pokud byste ji nevěděli nebo si nebyli jistý, tak Vám vyskočí chyba při přesměrování a IP adresu z hlášky zkopírujete a vložíte na toto místo. Tvar chyby bude zobrazen v níže. Klientskou zónu si nechte prozatím otevřenou.
 
 
 
obr. 4 Důležité údaje a nastavení URL stavů
 
 
  1. Nastavení v eshopu

Přihlásíte se do administrace eshopu a v nastavení > předvolby > comgate naleznete "Comgate režim", "Comgate merchant" a "Comgate secret" viz obr. 5. 
  • Comgate režim = testovací (pouze pro vyzkoušení a ověření, že to funguje) nebo produkční (ostrá platební brána) 
  • Comgate merchant = Identifikátor propojení obchodu (zjistíte v klientské sekci)
  • Comgate secret = Heslo (zjistíte v klientské sekci)
obr. 5 Nastavení v předvolbách
 
V admin > nastavení > způsob platby přidáte "nový způsob". Důležité je vybrat Script "comgate", nastavit "Maximální cena nákupu" a "přiřadit dopravu" - viz obr. 6. Cenu zde omezujeme z důvodu, aby ji neviděli zákazníci, ale pouze my. Dle pravidel Comgate nesmí být platební brána uvedená jako způsob platby dříve než je všechno schválené, tedy povolené produkční prostředí. Nyní se stále jedná o testovací prostředí.
 
 
 
obr. 6 Přidání způsobu platby
 
Máte nastavený způsob platby a nyní si připravíte nějaký produkt za 10 Kč a provedete objednávku. Testovací produkt je zobrazen na obr. 7. 
 
obr. 7 Testovací produkt
 
Při dokončení objednávky Vám mohou nastat 3 stavy:
  1. Byli jste přesměrováni na platební bránu - viz obr. 8
    • všechno proběhlo v pořádku a dokončete platbu - viz obr. 9 a 10
    • podívejte se do eshopu a u této objednávky by se automaticky mělo zobrazit "zaplaceno" viz obr. 11
  • Vyskočí na Vás pouze "Děkujeme Vaše objednávka byla přijatá"
    • eshop se nepropojil s platební bránou a někde jste tedy udělali chybu
    • podívejte se zejména na nastavení URL, merchant nebo heslo
  • Vyskočí na Vás "Děkujeme Vaše objednávka byla přijatá", Systémová chyba - kontaktujte majitele eshopu, Chyba Comgate - 1400 Acces from unauthorized location [IP adresa]! - viz obr. 12
    • nezadali jste nebo jste zadali špatně IP adresu
    • stačí pouze zkopírovat IP adresu ze složené závorky a vložit ji do klientské sekce Comgate

 

 
obr. 8 Přesměrování na platební bránu
 
obr. 9 Tlačítka comgate
obr. 10 Potvrzení platby v testovacím prostředí
 
obr. 11 Zaplacená objednávka v administraci
 
obr. 12 Nezadaná nebo špatně zadaná IP adresa
  1. Dokončení testovacího prostředí

Proběhlo u Vás všechno v pořádku a stav objednávky se automaticky označil jako "zaplaceno"? Pak zbývá už jen napsat email na " platby-aktivace@comgate.cz ", že jste dokončili testovací prostředí a prosíte o přepnutí o produkčního. Nezapomeňte uvést o jaký eshop se jedná a Váš identifikátor obchodu, aby Vás mohli lépe dohledat. Žádost by měl zaslat majitel eshopu. 
 
  1. Důležité podmínky, které musí eshop splňovat, aby byl přepnut do ostrého prostředí

stránky musí obsahovat:
  • Subjekt provozovatele stránek, který se shoduje se subjektem ve smlouvě - v obchodních podmínkách v úvodním ustanovení musí být uvedená kompletní adresa dle obchodního rejstříku - tedy ulice s číslem popisným i orientačním, prosíme o doplnění
  • Kontaktní údaje
  • Informace o produktu - popis, cena zboží/služeb
  • Všeobecné obchodní podmínky                                     
  • Reklamační podmínky (vrácení zboží, peněz)
  • Dodací a platební podmínky
  • Informace o ochraně osobních údajů a mimosoudním vyrovnání        
  • Web musí být zabezpečený protokolem HTTPS - prosíme o zajištění 
 
  1. Ostré prostředí

Comgate Vám povolil ostré prostředí a z Vaší strany je potřeba přepnout tlačítko "Comgate režim" na "prod" v admin / nastavení / předvolby a nastavit si způsob platby. U způsobu platby nezapomínejte na to, že jste si omezili platbu do 10 Kč.

Nyní tedy máte platební bránu zprovozněnou.

  1. Multijazyčná verze eshopu

U multijazyčné verze eshopu se vše nastavuje stejně, ale pouze to musíte udělat pro každý jazyk zvlášť. V klientské sekci Comgate budete mít připravené domény a v eshopu pouze vyplníte režim, identifikační číslo a heslo pro každou jazykovou mutaci - viz obr. 13. Platba Vám postačí jedna, ale nezapomeňte si vyplnit lokality. 
Testovací objednávku provedete pro každý jazyk.
 
obr. 12 Multijazyčná verze eshopu
 
 
 
 
Napojení na platební bránu Comgate - 2079460 -

Komentáře k Napojení na platební bránu Comgate

1
2.6.2020 21:04
Petr Knor

Super návod, moc děkuji.

2
3.6.2020 08:44
Jana Sladká

Děkujeme za komentář. Jsme rádi, že Vám návod pomohl k nastavení platební brány. :)

3
14.8.2020 13:38
Tomáš

Dobrý den,

bezva návod, už máme aktivní.

Bohužel na platební bránu se importuje ID objednávky a nikoliv VS. Takto nelze v účetním SW automaticky párovat platby.

Jak to máme vyřešit?

Děkuji.

4
17.8.2020 09:09
Martin Březovský

Dobrý den,
ID objednávky je interní číslo objednávky, které se nedá zaměnit. VS si můžete například ručně změnit a již by to byl technický i účetní problém. Každopádně VS se do systému Comgate odesílá také, takže si myslím, že by to určitě mělo jít dohledat. Dejte dotaz na Comgate a pak mi dejte prosím vědět, jak jste dopadli.

5
18.8.2020 23:56
Tomáš

Dobrý den,

Kontaktoval jsem Comgate a z jejich odpovědi jsem pochopil, že pro automatické párování platbeb je nutné zasílat VS objednávky jako refID.

Zde je celá odpověď.

platby vám zasíláme pod naším variabilním symbolem. Pro párování transakcí s danou objednávkou (váš interní VS) však lze použít parametr refID, který se zobrazuje v CSV souboru v kolonce "ID od klienta". Pokud si přejete slovní popis ve sloupci "Produkt" CSV., zadejte, prosím, v nastavení údaj "name".

Přikládám odkaz na technickou dokumentaci:

https://www.comgate.cz/cz/protokol-api

Konec odpovědi z Comgate.

Platby se v účetním SW párují dle VS a částky. Je možné zasílat na Comgate refID VS objednávky?

Děkuji.

6
22.9.2021 17:55
BestPet

Dobrý den,
odpověděl Vám pan Březovský ohledně variabilního symbolu? Již přes rok zde není odpověď.
Děkuji

Vložit komentář

Jméno
Email ( email není zveřejněn )
Váš příspěvek   ( Fotky můžete vložit po odeslání příspěvku. )
opiště kód
antispam
     Více informací