Platební modul eKonto

Tento dokument představuje uživatelskou dokumentaci modulu eKonto. Naleznete zde popis funkcí, návod na instalaci a použití modulu. Více informací o internetových platbách přes eKonto lze získat přímo u Raiffeisenbank a.s.

Licence modulu

Modul je poskytován s licencí  OSL v 3.0.

Stažení modulu

• Vyberte si verzi modulu, která je kompatibilní s verzí Magenta, kterou používáte:

Magento verze	Verze modulu	Datum vydání modulu
1.4.x CE*	3.0.1.1	3. 1. 2011
1.3.x CE*	3.0.1.1	3. 1. 2011

* Community edition

Dokumentace modulu

Podpora modulu je realizována prostřednictvím fóra na Magento.CZ:

•  České moduly pro Magento zdarma @ Magento.CZ

1. Funkce modulu

Modul eKonto doplňuje dnes již poměrně širokou škálu platebních metod pro Magento. Tento platební modul je určen obchodníkům, kteří mají u Raiffeisenbank a.s. (dále jen RB) otevřený Firemní nebo Transparentní účet, vedený v tzv. Transakčním systému. Zákazník, který chce tuto metodu využít k zaplacení, musí být též majitelem účtu otevřeného u RB.

• Systémové poždavky:
  • PHP 5.2.11
  • rozšíření openssl pro php

Technické podmínky naleznete v dokumentu od RB  zde.

Další informace ohledně plateb přes eKonto jsou k dispozici  zde.

2. Stažení a instalace modulu

• Stažení, instalace a aktualizace modulu je popsána zde.

3. Nastavení a použití modulu

Modul z pohledu provozovatele e-shopu Magento:

Pro správné fungování modulu je třeba po úspěšné instalaci provést také několik dalších nastavení. Nastavení modulu najdete v záložce Systém → Konfigurace → Prodeje → Způsob platby → eKonto:

Obrázek 1: Nastavení modulu eKonto v back-end.

• Aktivní - povolit eKonto ano či ne
• Nadpis - název platební metody zobrazený ve front-end
• URL platební služby – URL platební služby, poskytne RB
• URL služby verifikace plateb – adresa serveru ověřujícího platby, poskytne RB
• Jméno obchodu - identifikační řetězec prodejce, slouží k přiřazení platby konkrétnímu prodejci z databáze. Poskytne RB.
• Číslo účtu – číslo účtu prodejce
• Kód banky – kód banky, u níž je účet založen
• Heslo – heslo prodejce pro přístup k přehledu plateb, poskytne RB
• Zpoždění verifikace – hodnota v sekundách, Pro případ, že by při převodu mezi účtem zákazníka a účtem prodejce docházelo k malému zpoždění, je možné zde nastavit dobu, po kterou modul počká, než začne platbu ověřovat. Jedná se zde o ověřování prováděné okamžitě po potvrzení platby zákazníkem a po dobu čekání nebude zákazník přesměrován zpět na stránky obchodu. Proto se nedoporučuje nastavovat víc než několik sekund. Horní limit je 60 sekund.
• Konstantní symbol platby – maximálně 4 číslice
• Specifický symbol platby – maximálně 10 číslic
• Poznámka pro prodejce - krátký text, který bude uveden při informacích o platbě v přehledu plateb v systému Raiffeisenbank.
• Nový stav objednávky - stav objednávky po úspěšné platbě
• Pořadí - pořadí metody v seznamu při procesu platby
• Placení pro použitelné země – vybrat všechny země nebo následně povolit jen některé
• Výběr povolených zemí - omezení platební metody na státy (všechny, vybrané)
• Volitelný text - popisek, který se zobrazuje při zvolení této metody při platebním procesu

Poté, co zákazník úspěšně zaplatil za objednané zboží, můžete objednávku v back-end dále zpracovat a vyexpedovat. Zaplacená objednávka má stav, který jste prve zvolili při nastavení. Platbu si můžete též ověřit přes Prodeje → Objednávky v rámečku Platební údaje tlačítkem Ověřit platbu – obdržíte informaci o úspěšné/neúspěšné verifikaci. Po odeslání a označení faktury jako 'zaplacené se ve stavu zásilky objeví Hotovo. Ve chvíli, kdy je objednávka považována za vyřízenou (Hotovo) nebo zrušenou (Zrušeno), již není možno Ověřit platbu.

Obrázek 2: Ověření platby v back-end.

I v případě nedostatku finančních prostředků na účtu zákazníka zůstává platební příkaz po určitou dobu v platnosti. Pokud na účet zákazníka v době platnosti platebního příkazu přibude dostatečná částka, platba se okamžitě zrealizuje. Proto pokud byl pravděpodobným důvodem neúspěšné verifikace platby nedostatek finančních prostředků, bude v poznámce při objednávce uvedeno datum konce platnosti platebního příkazu. Po jeho uplynutí již nemá smysl se dále o verifikaci pokoušet.

Obrázek 3: Verifikace ukazující neúspěšnou platbu.

Prodejce i zákazník jsou o úspěšné či neúspěšné verifikaci, resp. o stavu objednávky informováni prostřednictvím poznámek a stavu zobrazovaných u objednávky. Prodejce je navíc informován i o pravděpodobné příčině neúspěšné verifikace, pokud je známa.

Obrázek 4: Sledování stavu objednávky.

Modul z pohledu zákazníka:

• Zákazník vloží zboží do košíku.
• Pokračuje k pokladně a volí jako platební metodu eKonto.

Obrázek 5: Volba platby přes eKonto ve front-end.

• Po potvrzení objednávky bude zákazník přesměrován z obchodu do platební brány RB, kde se přihlásí (přihlašovací údaje k účtu poskytuje RB)

Obrázek 6: Platební brána RB. a posléze se mu zobrazí stránka s příkazem k úhradě. Zde již budou předvyplněny všechny informace potřebné pro uskutečnění platby (číslo účtu prodejce, částka, variabilní symbol a pod.) s výjimkou certifikačního kódu.

• Po zadání platného certifikačního kódu a potvrzení platby bude zákazník přesměrován zpět na stránky internetového obchodu, kde se mu zobrazí informace o úspěšném či neúspěšném přijetí platebního příkazu RB.

Obrázek 7: Úspěšná objednávka po proběhnutí platby.

• Raiffeisenbank platební příkaz nepřijme pokud zákazník platební příkaz záměrně nepotvrdí (například kliknutím na tlačítko "Zpět") nebo se chybně certifikuje. V takovém případě je objednávka automaticky zrušena a zboží se vrátí na sklad. Zákazník je ale přesměrován zpět na svůj nákupní košík (s jeho původním obsahem) a v případě opětovného potvrzení objednávky bude vytvořena objednávka nová.

Obrázek 8: Navrácení do košíku a upozornění na neúspěšnou platbu.

• V případě, že má zákazník na účtu dostatek finančních prostředků k úhradě požadované částky, platba zpravidla proběhne okamžitě. Proto jakmile je platební příkaz zákazníkem potvrzen, modul eKonto se pokusí ověřit, zda již byla částka převedena na účet prodejce (verifikovat platbu).
• V ideálním případě je tak během několika sekund po potvrzení platebního příkazu zákazníkem platba úspěšně ověřena a objednávka je ve stavu "Hotovo".

V případě problémů s dostatkem finančních prostředků atd. – viz výše v sekci Modul z pohledu provozovatele e-shopu Magento.

Testovací provoz

Pro účely testování poskytuje Raiffeisenbank testovací platební bránu. Díky ní je možno jednoduše otestovat funkčnost platebního modulu eKonto. Testování je vhodné provádět v testovací a nikoli plně využívané produkční instalaci e-shopu Magento. Testovací konfigurace modulu jsou následující (v případě potíží s nastavením požádejte o aktuální informace Raiffeisenbank):

Obrázek 9: Nastavení testovacího provozu v back-end.

• Aktivní - Ano
• URL platební služby – https://klient2.rb.cz/test_shop/owa/shop.payment
• URL služby verifikace plateb – https://klient2.rb.cz/test_shop/owa/shop.getpayments
• Jméno obchodu - EKONTO
• Číslo účtu – 1212121001
• Kód banky – 5500
• Heslo – EPLATBY
• Konstantní symbol platby – 8

Po uložení je možné přejít na stránky obchodu a vytvořit testovací objednávku. Pro platby již bude k dispozici eKonto.

Po potvrzení objednávky (v tomto okamžiku by se měl produkt odečíst ze skladu) bude tester přesměrován na stránky RB, kde se musí přihlásit pod testovací identitou (klientské číslo a autentizační kód) k testovacímu zákaznickému účtu. V současnosti jsou k dispozici následující účty:

Číslo účtu	Klientské číslo	Autentizační kód
1007001	adam	a
1015001	borivoj	b
1023001	cecilie	c
1090001	daniela	d

Následně se zobrazí předvyplněný platební příkaz. Certifikační kód je vždy číslo "1122".

Obrázek 10: Testovací provoz - fiktivní platba přes bránu RB.

Po zadání certifikačního kódu a potvrzení platebního příkazu se zobrazí text "Platební příkaz byl Raiffeisenbank v pořádku přijat." a posléze je prohlížeč přesměrován na stránky obchodu, kde se zobrazí informace o úspěšném zadání objednávky.

Stejný průběh by měly mít platby ze všech účtů. Rozdíl mezi platbou z účtu "daniela" a ostatních účtů je v tom, že při platbě z účtu "daniela" bude objednávka uvedena po zadání platebního příkazu do stavu Pozastavit, jelikož ověření platby nemohlo být úspěšné kvůli nedostatku finančních prostředků. V případě ostatních účtů by měla objednávka přejít do stavu Hotovo. V obou případech by u objednávky měly být uvedeny příslušné poznámky.

V případě, že při potvrzování platebního příkazu na stránkách Raiffeisenbank klikne tester na tlačítko "Zpět", bude přesměrován zpět na nákupní košík. Objednávka by měla být nyní ve stavu Zrušeno a produkt vrácen do inventáře. V horní části stránky nákupního košíku by se měl být zobrazit text "Platební příkaz NEBYL Raiffeisenbank přijat!".

4. Release notes

Verze 3.0.1.1 - 3. 1. 2011

• Opravené chyby:
  • odstraněn licenční model

Verze 2.2.4.0 - 19. 5. 2010

• Opravené chyby:
  • oprava verifikace platby

Verze 3.0.1.0 - 19. 5. 2010

• Opravené chyby:
  • oprava verifikace platby

Verze 0.2.3 - 26. 3. 2010

• Opravené chyby:
  • první vydání modulu, historie starších verzí modulu nebyla uchovávána