Přidání platební brány¶

Založení nové metody¶

1. V modulu Administrace si spusťte aplikaci Platební brány, kde pomocí tlačítka Nový přidáte novou platební bránu. Případně můžete pouze doplnit nebo přenastavit již existující bránu tím, že upravíte existující nastavení.

2. V okně, které se objeví, vyberete konkrétní platební bránu, kterou chcete na web přidat.

3. V novém tabu se otevře nastavení vybrané platební brány. Vyplňte všechna povinná pole (žlutě podbarvená) a přejděte na tab Platební metody.

4. Na tomto tabu přidáváte konkrétní platební metody, které budou viditelné na webu a zákazník je bude moct vybrat pro provedení platby. Pokud přidáváte online platební bránu, zde přidané platební metody by měly odpovídat nastavení brány (metody, které máte povolené v nastavení platební brány by měly být přidány rovněž na tab Platební metody). Pro každou přidanou Platební metodu zadáte její název a interní název (tyto se mohou objevit na webu, pokud nezadáte jejich označení na dalším tabu).

   

5. V poli Systémová platební metoda vyberete metodu, kterou chcete na webu začít využívat. V nabídce jsou pouze takové metody, které může daná platební brána podporovat.

6. Pokud chcete, aby měla daná metoda na webu zobrazen i obrázek, můžete jej vybrat v poli Malý obrázek.

7. Na tabu Označení pro zákazníky přidáte název, který se bude na webu zobrazovat zákazníkům. Přidat můžete i popisek, který lze rovněž na webu zobrazit (záleží vždy na šabloně daného e-shopu). Novou metodu uložte.

8. Na tabu Nastavení brány přidáte další nastavení dle typu brány – propojení s online bránou, bankovní účet a podobně. Více o konkrétních nastaveních platebních bran najdete níže.

9. Na tabu Pokročilá nastavení můžete vybrat, pro které měny bude brána dostupná (pokud nevyberete žádnou, bude dostupná pro všechny) a také Dobu pro zrušení objednávky (kolik dní po nezaplacení objednávky má dojít k jejímu zrušení) a nastavit, zdali se po selhání platby mají odstranit i rezervace (pokud nastavíte na NE, po neúspěšné platbě zůstanou produkty z objednávky rezervované).

Comgate¶

Pro platební bránu Comgate je potřeba na tabu Nastavení brány nastavit pole Obchodník a Heslo. Oba údaje najdete v portálu Comgate.

V portálu Comgate je nutné nastavit následující:

V nastavení e-shopu (integrace) Comgate je potřeba přidat tyto povolené IP adresy:

• 54.195.249.239

• 54.217.238.82

• 54.246.94.76

• 54.246.92.239

• 212.4.158.4

• 94.113.254.226

A také URL adresy pro notifikace; začátek URL adresy je URL vašeho e-shopu – níže uvedené adresy je tedy potřeba upravit tak, aby místo www.vas-eshop.cz byla skutečná adresa vašeho e-shopu:

• URL zaplacený: https://www.vas-eshop.cz/comgatefinishorder?transId=${id}&refId=${refId}

• URL zrušený: https://www.vas-eshop.cz/comgatefinishorder?transId=${id}&refId=${refId}

• URL nevyřízený: https://www.vas-eshop.cz/comgatefinishorder?transId=${id}&refId=${refId}

• URL pro předání výsledku platby: https://www.vas-eshop.cz/comgatenotificationhandler

Pro Comgate na tabu Platební metody nastavujete konkrétní metody, které máte pro Comgate v portálu povoleny.

Nastavit můžete také systémovou platební metodu Bankovní převod. V takovém případě si zákazník konkrétní platební metodu (svoji banku pro rychlý převod) vybere až přímo na bráně, a ne v e-shopu. Pokud chcete, aby si zákazník platební metodu (například konkrétní rychlý bankovní převod) vybral již v e-shopu, je potřeba každou takovou metodu přidat zvlášť.

ThePay 2.0¶

Pro platební bránu ThePay 2.0 je potřeba na tabu Nastavení brány vybrat Merchant ID, ID projektu a Heslo. Tyto údaje najdete v administraci ThePay 2.0 Rovněž by měly být k dispozici testovací údaje (ty jsou důležité pro testovací platbu objednávky v Náhledu).

Rovněž pro ThePay 2.0 je potřeba v portálu ThePay 2.0 nastavit povolené IP adresy:

• 54.195.249.239

• 54.217.238.82

• 54.246.94.76

• 54.246.92.239

• 212.4.158.4

• 94.113.254.226

Na tabu Platební metody je pak potřeba přidat konkrétní platební metody, které máte pro ThePay 2.0 povolené.

GoPay¶

Pro platební bránu GoPay je potřeba prvně nastavit testovací platební údaje, které vám GoPay poskytne. Tyto údaje nastavíte na tabu Nastavení brány (do polí pro ostrá nastavení zatím napište pomlčky). V sekci Testovací prostředí vyplňte Testovací Target GO ID, Testovací Client ID a Testovací Client Secret. Tyto údaje vám poskytne GoPay.

Následně jděte do náhledu webu a proveďte testovací platby tak, jak požaduje GoPay.

Poté je potřeba se obrátit na GoPay s informací, že jste provedli testovací platby: vytvořte si odkaz na Náhled, který budete posílat do GoPay s informací, že na tomto odkazu mohou na vašem e-shopu vyzkoušet objednávky.

Dále je nutné GoPay předat informaci, že pro testování si musí do URL přidat ten náhledový token (tedy ‘bbToken=XXXXXXXXXXXXXXXXXXXXXXXXX’ – tento token najdete v odkazu na Náhled, který jste vygenerovali výše). GoPay bude totiž při testování plateb přesměrována do náhledu vašeho webu, ovšem bez daného bbTokenu. Je tedy nutné, aby si tam tento token GoPay doplnila.

Je to z toho důvodu, že se jedná pouze o testovací prostředí, kdy se tam již nepředává bbToken pro náhled. V produkci toto bude v pořádku; testovací prostředí není připraveno na notifikační handler, ale pouze na přesměrování uživatele (potřebné údaje jsou drženy v session).

Po schválení vám GoPay pošle ostré údaje pro propojení, které v detailu platební brány GoPay v administraci vložíte do polí na tabu Nastavení brány do sekce Nastavení, kam jste původně vložili pomlčky. Po schválení projektu bude platební brána GoPay dostupná na webu.

Bankovní převod¶

Pro bankovní převod je potřeba na tabu Nastavení brány* zadat povinné údaje:

• Název banky

• Číslo účtu

• Kód banky

Pokud se má generovat i QR kód pro zaplacení objednávky, je potřeba zadat i SWIFT a IBAN.

V případě, že máte FIO banku, je možné nastavit automatické stahování výpisů následovně:

• Do pole Identifikátor banky vyplníte „fio“.

• Do pole Autorizační token vyplníte token z FIO banky, který najdete v administraci.

V případě, že máte banku Creditas, je možné nastavit automatické stahování výpisů následovně:

• Do pole Identifikátor banky vyplníte „creditas“.

• Do pole Autorizační token vyplníte autorizační klíč, který nejdete ve svém bankovnictví.

• Do pole Bank Account ID vyplníte identifikátor účtu, který najdete ve svém bankovnictví.

Stahování výpisů pro banku Creditas probíhá pouze jednou denně v ranních hodinách.