Drupal.cz

Ve spolupráci s Vojtěchem Kusým, vývojářem Drupalu, jsme připravili modul pro integraci platební brány GoPay. Modul je volně ke stažení z Drupal.org: http://drupal.org/…ect/uc_gopay. Momentálně existují verze pro Drupal 6/Übercart 2 a Drupal 7/Übercart 3. Díky platební bráně Gopay můžete zákazníkům zpřístupnit většinu platebních metod běžných v České republice. V článku se dozvíte jak probíhá integrace, jak modul nainstalovat a také jak ho případně podpořit, aby se dále rozvíjel.

Informace o modulu

Modul integruje platební bránu GoPay do Übercartu. GoPay Momentálně podporuje platby v Česku a na Slovensku.

Integrací platební brány GoPay umožníte zákazníkům využít následující platební kanály:

• Platební karty – zprostředkování plateb z karet VISA, VISA Electron, MasterCard, Amex, JCB
• ePlatby – systém bezhotovostních úhrad pro klienty Raiffeisenbank
• MojePlatba – systém bezhotovostních úhrad pro klienty Komerční banky
• mPeníze – systém bezhotovostních úhrad pro klienty mBank
• Banka – standardní bankovní převod
• superCASH – systém hotovostních plateb prostřednictvím terminálů společnosti Sazka a České Pošty
• GoPay peněženka – elektronická peněženka vhodná pro mikroplatby
• MoneyBookers – elektronická peněženka vhodná pro mezinárodní platby a převody peněz
• Premium SMS – systém plateb prostřednictvím SMS z mobilních telefonů

Podpořte vývoj registrací svého e-shopu

I když motivace k vytvoření modulu pro Drupal 7 vycházela z vlastní potřeby, od začátku jsme chtěli modul udělat univerzálně použitelný a dát ho veřejně k dispozici. To samozřejmě navýšilo náklady, o které jsme se chtěli zprvu podělit s poskytovatelem platební brány, firmou GoPay s.r.o. Tato jednání však nedopadla podle našich představ, dohodli jsme se „jen“ na finančních příspěvcích odvislých od počtu e-shopů, které budou daný modul používat. Kromě toho jsme se rozhodli modul zpřístupnit v typickém opensource modelu jako donationware.

Pokud modul používáte a chcete nás podpořit, můžete svůj e-shop (dobrovolně a bezplatně) zaregistrovat do naší databáze (neexistuje bohužel žádná cesta, jak zjistit použitý modul přímo na straně poskytovatele). Registrací pomůžete dalšímu vývoji modulu. Kromě toho nás můžete podpořit i přímo – posláním libovolné částky na účet nebo darovací SMS. Peníze budou vynaloženy na další vývoj modulu. Např. v tomto roce chystáme vydat ještě verzi pro Drupal Commerce. Více ohledně sponzoringu se dozvíte na http://www.stepankorcak.cz/…pro-sponzory.

A nyní již k samotné integraci a instalaci modulu.

Návod na instalaci

Prvním krokem je ujednání podmínek a uzavření smlouvy se společností GoPay, kde vám vznikne unikátní účet, přes který budou probíhat platby. www.gopay.cz Po tomto kroku vám GoPay zašle e-mail s názvem Test – integrační soupis, kde najdete vaše GoID a klíč Secret, jež vložíte do modulu (viz. níže popisky v obrázku). Dostanete také přístupy do monitoru, kde budete sledovat stav peněženky a plateb. Pokud toto máte, pokračujte instalací modulu.

Použijte Drush nebo stáhněte soubor s modulem z adresy http://drupal.org/…ect/uc_gopay.

Rozbalte archiv a nahrajte složku uc_gopay na ftp do adresáře s moduly (standartně …/sites/all/mo­dules/). Máte-li přístup přes SSH, můžete použít drush: „drush dl uc_gopay“ – stáhne modul uc_gopay z drupal.org a „drush en uc_gopay -y“ – zapne modul.

Na stránce s moduly (…/admin/modules) najděte v sekci ÜBERCART – PLATBA řádek GoPay a zaškrtněte. Na konci stránky potvrďte tlačítkem Uložit nastavení. Modul se nainstaluje.

Přejděte na stránku pro nastavení modulu Obchod → Způsoby platby a na řádku GoPay platby přes webové rozhraní klikněte na Nastavení (admin/store/set­tings/payment/met­hod/gopay_wps).

Stránka s nastavením platebních kanálů:

Pokračujte nastavením předdefinované platby:

Následuje řada nastavení důležitých k funkčnosti modulu.

Spolu s notifikační adresou zašlete do GoPay e-mailem také IP adresu(-y) vašeho e-shopu, aby vám povolili přístup na stránky, kde se budou uskutečňovat samotné platby. (Platby probíhají na serveru GoPay pod bezpečnostním protokolem, proto je potřeba povolit přístup serveru, na kterém máte e-shop.) IP adresa je potřeba také pro testování modulu viz. Integrační e-mail:

IP adresu vašeho e-shopu zjistíte pomocí dotazu WHOIS, např. na stránce whois.smartweb.cz:

Nebo pomocí příkazu PING v příkazovém řádku. Spusťte příkazový řadek a napište: ping www.nejakastranka.cz:

Vyplňte kolonky s identifikačními klíči:

Integrační e-mail:

Proveďte další nastavení a uložte:

Nezapomeňte na stránce Obchod → Způsoby platby (admin/store/set­tings/payment) zaškrtnout políčko u řádku GoPay platby přes webové rozhraní a uložit potvrzovacím tlačítkem Uložit nastavení.

Na stránce https://www.gopay.cz/styl-go-pay si vygenerujte odpovídající logo s obrázky plateb, které zákazníkům nabízíte a přes Struktura → Bloky si vytvořte blok s logem, který umístíte na titulní stránku. Toto je podmínkou úspěšné integrace GoPay platební brány.

To je konec instalace. Po odeslání testovací platby by měla být integrace úplná. Před nasazením do ostrého provozu nezapomeňte v nastavení platební metody přepnout platební bránu na produkční „ostrou“ platební bránu!

Poté co dokončíte integraci, můžete vyplnit registrační formulář, kterým zaregistujete adresu e-shopu do naší databáze uživatelů modulu UC Gopay.

K registračnímu formuláři se dostanete přes stránku nastavení platební metody GoPay:

Formulář s registrací:

Registrací nebo sponzorským darem pomůžete dalšímu vývoji.

Další informace ohledně sponzoringu a darovací tlačítko najdete zde: http://www.stepankorcak.cz/…pro-sponzory. V případě, že potřebujete s čímkoliv pomoci nebo bližší informace, můžete mne kontaktovat na e-mailu strep@stepankorcak.cz.

Upozornění: modul UC Gopay pro Drupal není oficiálně podporovaný modul společnosti GoPay s.r.o.