Popis funkcionalit Shoptet doplňku GoPay+

V tomto článku jsou detailněji popsané následující funkcionality Shoptet doplňku GoPay+ a jejich možnosti využití. Článek je rozdělený na následující části:

A. Označování stavů objednávek
B. Generování plateb přes platební link k objednávce
C. Propojení linku generujícího platby k objednávce s automatickým e-mailem
D. Jazyk platebních metod x jazyk platební brány

Pro správné používání funkcionalit k doplňku GoPay+ je potřeba, aby byly platební metody k doplňku GoPay+ naimportované a nastavené správně. Import a nastavení platebních metod lze provést dle postupu popsaného v centru nápovědy v části “Jak nastavím platební metody pro GoPay+ doplněk?” a zde je shrnuto v bodech:

• V Propojení > GoPay+ > Zobrazené platební metody se nastaví potřebná konfigurace, tlačítkem IMPORTOVAT se provede vytvoření a nahrání všech aktuálně povolených platebních metod do sekce Způsoby platby. Tento krok je potvrzený zeleným textem “Platební metody byly importovany.”.
   

  

   

• Pokud se však po importu zobrazí červeným textem “Nebyly nalezeny žádné (další) metody k importu.”, pak jsou již všechny aktuálně povolené platební metody vytvořené a nahrané v sekci Nastavení > Doprava a platby > Způsoby platby a nelze je tedy znovu naimportovat.
   

  

   

• Dále je potřeba v sekci Nastavení > Doprava a platby > Způsoby platby metody případně zviditelnit ve sloupci Viditelnost. Jsou-li zešedlé, nejsou zviditelněné.

  

   

• Defaultními názvy naimportovaných metod například v českém jazyce v rámci doplňku GoPay+ jsou On-line platba kartou, On-line bankovní převod, Google Pay, Apple Pay, Bitcoin, Premium SMS, Paysafecard, m-platba a PayPal.
   

• V detailu naimportované metody lze změnit název metody, ale nikdy se nesmí upravovat nastavení parametru Typ platby.
   

  

   

• Častou chybou při importu je, že se metoda vytváří jiným, než námi doporučeným, způsobem. Platební metody pro doplněk GoPay+ nelze přidávat manuálně v sekci Způsoby platby v rámci tlačítka Přidat. V takovém případě by nefungovaly návazné funkcionality a doporučujeme v sekci Způsoby platby takhle chybně vytvořené platební metody nejdříve odstranit a poté provést import a nastavení platebních metod dle našeho doporučeného postupu.

   

A. Označování stavů objednávek

Stav objednávky se mění na základě změn stavů k ní vytvořené platby/plateb, a to tzv. HTTP notifikacemi (oznámeními) informujícími o změnách. Je třeba vždy odlišit stav objednávky a stav u platby/plateb, která byla/které byly k příslušné objednávce založena/založeny. Lze tedy říci, že změny stavů u platby/plateb dále aktualizují stav příslušné objednávky, ke které se platba/platby vztahují.

V Propojení > GoPay+ > Nastavení lze zapnout následující možnosti.
 

• Označit objednávku jako zaplacenou - v sekci Objednávky se u objednávky (1.) zobrazí puntík, kdy zelený znamená zaplacenou platbu a ostatní barvy nezaplacenou. Pokud k objednávce proběhne více plateb a jedna z plateb k objednávce je ve stavu Zaplacená - PAID, příznak se u objednávky změní na zelený, a to samozřejmě i s ohledem restartů k platbě. V opačném případě se stav objednávky na zaplacenou změnit nemůže.
  Pozn. více plateb může být k jedné objednávce založeno, pokud je zapnuta funkcionalita generování plateb přes odkaz, tedy funkcionalita popsaná v další části tohoto článku.
   
• Stav objednávky po úspěšné platbě - stav objednávky (2.), na který se změní, je-li platba k objednávce dokončena do stavu Zaplacena - PAID.
   
• Stav objednávky po neúspěšné platbě - stav objednávky (2.), na který se změní, je-li platba k objednávce ve stavu Zrušena - CANCELED, či Vypršela - TIMEOUTED.
   
• Názvy stavů objednávek jsou definované v Shoptetu (v sekci Nastavení > Objednávky > Stavy), platební brána GoPay a doplněk GoPay+ na názvosloví nemá vliv.
  
  Ukázka ze sekce, kde se jednotlivé stavy objednávek spravují

  

• Stav objednávky se může změnit na základě tzv. HTTP notifikace/oznámení, která probíhá ke každé jednotlivé platbě a k objednávce se vždy zohledňuje koncový stav platby - je-li k objednávce založeno více plateb, pak tedy koncový stav u jedné z nich (pozn. více plateb může být k jedné objednávce založeno, pokud je zapnuta funkcionalita generování plateb přes odkaz, tedy funkcionalita popsaná v další části tohoto článku). Koncové stavy plateb mohou být Platba zrušena - CANCELED, Platba vypršela - IMEOUTED, anebo Platba zaplacena - PAID.
   
• Stav objednávky se nezmění na základě platby/plateb založených mimo doplněk GoPay+, tedy například používáte-li nějaký vlastní script, či zakládáte-li platby přes odkaz na dodatečnou platbu vygenerovaný v GoPay obchodním účtu.

B. Generování plateb přes platební link k objednávce

• Raději zopakujeme, že funkcionalitu lze použít pouze v případě, že platební metody jsou správně naimportované a nastavené (viz výše odstavec "Pro správné používání....").
   
• Funkcionalita vyžaduje v Propojení > GoPay+ > Ostatní nastavení zapnutí Generovat nový platební link na Ano a u Platnost generovaného linku mít nastavenou životnost linku (lze zvolit 1 až 7 dnů).

  

• Je-li zapnuta na Ano i možnost Vkládat link do komentáře objednávky, link se zobrazí v detailu objednávky (Objednávky > Přehled > detail příslušné objednávky > Komentáře).
   
• Možnost Otevření další platby na rozcestníku umožní, že u nové platby založené přes link se po vyvolání platební brány zobrazí buď předvybraná platební metoda (ta, která byla zvolena u první platby založené po dokončení objednávky), anebo rozcestník s výběrem všech povolených platebních metod.
   
• Link na vygenerování nové platby k objednávce lze použít, pokud jsou splněny následující podmínky:
  • je zapnuto Propojení > GoPay+ > Ostatní nastavení a nastaveno Platnost generovaného linku
  • nevypršela životnost linku (určuje nastavení Platnost generovaného linku)
  • k objednávce zatím neproběhla úspěšně zaplacená platba (Zaplacena - PAID)
  • k objednávce proběhla platba (například hned první založená po dokončení objednávky), která je ve stavu Zamítnuta (Zamítnuta - CANCELED), či Vypršela (Vypršela - TIMEOUTED)
  • k objednávce nebyla provedena platba, která by skončila stavem Platební metoda vybrána (Vybrána - PAYMENT METHOD CHOSEN) - je třeba standardně čekat, než se stav platby z Platební metoda vybrána změní na některý koncový (Zamítnuta - CANCELED, Vypršela - TIMEOUTED, či Zaplacena - PAID)
     

C. ​Propojení linku generujícího nové platby k objednávce s automaticky odesílaným e-mailem

• Chceme upozornit, že automatické odesílání e-mailu je funkcionalita Shoptetu, ne platební brány GoPay a doplňku GoPay+ a zde je popsaný postup vycházející z prostředí Shoptetu. Článek k možnostem nastavení automatického odesílání e-mailů je dále detailně popsaný přímo v centru nápovědy Shoptet.
   
• Do e-mailů lze vkládat link generovaný doplňkem GoPay+.
   
• Podmínkou je, aby bylo v sekci Propojení > GoPay+ > Ostatní nastavení > zapnuto Generovat nový platební link a v Platnost generovaného linku doba životnosti linku.
   
• Dále v Propojení > GoPay+ > Nastavení > je potřeba nastavit příslušný stav objednávky v Stav objednávky po neúspěšné platbě.
   
• V sekci nastavení > E-maily > Automatické zasílání > záložka Stavy objednávek > zde se nachází šablony e-mailů, které se mohou odesílat automaticky.

  

• V detailu konkrétní šablony lze upravit textaci e-mailu a pomocí tagu #ONLINE_PAYMENT_BUTTON# docílíme, že se bude do těla e-mailu automaticky vkládat link na vygenerování nové platby k objednávce.
  
   
• V případě splnění podmínek výše se bude automaticky odesílat e-mail při změně stavu objednávky, e-mail bude obsahovat link na vygenerování nové platby k objednávce. Pořád je však potřeba počítat s životností linku (doba jeho platnosti + dokud neproběhne úspěšně zaplacená platba, anebo naopak platba nezůstane v nekoncovém stavu).
   
• Link lze případně vkládat i do těla jiných automatických e-mailů, například aby se odeslal hned po dokončení objednávky a založení prvotní platby. Nicméně tuto variantu nedoporučujeme z důvodu, kdy zákazník po dokončení objednávky může rovnou založit přes link z e-mailu další platbu a existuje riziko, že by po sobě tak dokončil obě platby.

D. Jazyk platebních metod x jazyk platební brány

• V jakém jazyce se vyvolá platební brána k platbě založené z Shoptetu je dáno dvěma variantami nastavení v Propojení > GoPay+ > Ostatní nastavení > Jazyk.

  

   

Varianta 1

• Pokud je v Propojení > GoPay+ > Ostatní nastavení > v roletce Jazyk brány nastavena možnost s konkrétním jazykem (například FR), pak se po vyvolání platební brány zobrazí jazyk v odpovídajícím jazyce (tedy v tomto případě ve francouzštině). V nabídce (roletce) lze zvolit z jazyků podporovaných platební bránou dle číselníku v naší technické dokumentaci.

  

Varianta 2

• Pokud je ovšem v Propojení > GoPay+ > Ostatní nastavení > Jazyk brány nastavena možnost Výchozí (dle Shoptetu), pak se po dokončení objednávky zobrazí shodný jazyk jako na e-shopu, tedy který si zákazník zvolil v rámci e-shopu.

  

  

• V takovém případě v administraci Shoptet v sekci Nastavení > Základní nastavení > Jazyky musí být daný jazyk vytvořený a zviditelněný.

  

• Shoptet pro e-shopy podporuje angličtinu, češtinu, slovenštinu, maďarštinu, němčinu, polštinu, rumunštinu a vietnamštinu (jazyk se tak na bráně zobrazí v angličtině) = v těchto jazycích tedy lze vyvolat platební bránu.
   
• Platební metody zobrazené v košíku/objednávce však mají jazyk nastavený takový, který jsme použili při importu.

  

  

• Platební metody lze naimportovat v angličtině, češtině, slovenštině, maďarštině, němčině, anebo francouzštině.