Založení a integrace platební brány GPWebpay

Platební brána je internetové rozhraní pro zpracování online plateb. Umožňuje vašim zákazníkům zaplatit za objednané produkty a služby okamžitě. Kromě zvýšení komfortu pro zákazníka se to pozitivně projevuje také na množství dokončených nákupů.

Následující článek popisuje postup pro integraci platební brány GP webpay do FAPI. Více informací o platební bráně najdete na webových stránkách provozovatele.

Platební brána není součástí FAPI. Veškeré poplatky s ní spojené jsou hrazeny přímo provozovateli brány. Pokud nechcete poskytovat svým zákazníkům možnost platit online, nemusíte ji do FAPI integrovat.

Co je potřeba udělat, než vám zaplatí online první klient přes bránu GP Webpay?

  1. objednat si bránu přes některou se spolupracujících bank, které ji nabízí
  2. uzavřít smlouvu s bankou
  3. vytvořit ve FAPI propojení s platební bránou
  4. nastavit platební bránu GP webpay v prodejním formuláři

Všechny tyto kroky si blíže popíšeme v následujících kapitolách.

1. Objednání brány

Objednejte si platební bránu u vybrané banky.

2. Uzavření smlouvy s bankou

Od banky vám přijde smlouva s konkrétní nabídkou. Následně dostanete přístup do testovacího prostředí. Tím se ve FAPI nemusíte zabývat; můžete rovnou požádat o zprovoznění ostrého režimu.

3. Nastavení platební brány

Pro správné fungování platební brány je potřeba začít prvotním nastavením pár věcí přímo ve GP webpay. V administraci toto nastavení najdete v záložce  E-shopy (nákupní košík), kde vyberete váš eshop.

Nastavte si HTTP metodu pro odpověď jako POST a u poskytovatele dejte povolit Web Services.

Dále si nechte vygenerovat klíče k platební bráně. Na stránce Správa klíčů (ikona klíče) stiskněte na tlačítko VYTVOŘIT.

Zde se vytvoří soukromý klíč, který si stáhněte. Během vytváření klíče budete vyzváni k zadání hesla.

Heslo k soukromému klíči si zapamatujte, budete ho dále potřebovat.

Platební brána GP webpay vám nyní vytvořila nový soukromý klíč. Pro aktivaci nového soukromého klíče je potřeba tento klíč nahrát do platební brány GP webpay. 

Zvolte e-shop, pro který chcete tento klíč nahrát (tzn. FAPI).

Klikněte na tlačítko vložit. Otevře se vám pop-up okno do kterého vložíte soukromý klíč, který jste si před chvílí stáhli. Do kolonky Heslo napíšete heslo, které jste zadali v předchozím kroku.

Po uspěšném uložení si soukromý klíč zálohujte, pomocí tlačítka zálohovat.

Tento zálohovaný soubor poté budete požívat pro propojení FAPI a platební brány GP webpay.

Všechny výše uvedené kroky je potřeba dokončit, jinak vámi vygenerovaný soukromý klíč nebude fungovat.

Klíč nemažte, obsah tohoto souboru je potřeba nahrát do FAPI při vytváření propojení s platební branou.

4. Propojení FAPI s platební bránou

Ve FAPI v nabídce Nastavení –> Propojení aplikací stiskněte tlačítko Nové propojení s GP webpay.

Vyplňte všechna pole:

  • Doména: zvolte doménu, na které budete platební bránu používat (jde o interní pojmenování platební brány ve FAPI)
  • Číslo obchodníka: zjistíte v portálu platební brány v sekci E-shopy
  • Soukromý klíč: pokud ještě nemáte, je potřeba si jej nechat vygenerovat viz. 3. Nastavení platební brány, pokud již máte klič vygenerovaný, stačí ho otevřít v textovém editoru a jeho obsah překopírovat do FAPI
  • Heslo k soukromému klíči: zvolíte si při vytváření soukromého klíče (je nutné si je zapamatovat)
  • Veřejný klíč: nachází se v sekci Ke stažení a slouží k ověření, zda někdo nepodvrhnul odpověď z platební brány, ve stažém zip souboru najděte soubor končící na .pem, otevřete jej v textorém editoru a vykopírujte do FAPI celý jeho obsah.
  • Kód poskytovatele: zjistíte v portálu platební brány v sekci E-shopy

5. Nastavení Platební brány GP webpay v prodejním formuláři

Nakonec zbývá již jen vložit propojení s platební bránou do prodejního formuláře, v němž si bránu přejete využívat.

V nabídce Prodej –> Prodejní formuláře stiskněte tlačítko Upravit u formuláře, u kterého chcete nabídnout online platby zprostředkované platební bránou GP webpay.

Na záložce Platba, doprava a fakturace v úpravě prodejního formuláře vyberte v poli Platební brána příslušné propojení s GP webpay

Změny provedené v nastavení prodejního formuláře uložte tlačítkem Uložit formulář.

Pokud jste úspěšně došli až sem, gratulujeme! Váš prodejní formulář je nyní propojen s platební bránou GP webpay a vaši zákazníci vám mohou začít platit online.