Shopify

Máte e-shop na Shopify a používate platobnú bránu Comgate? Stačí si len nainštalovať náš modul cez tento odkaz (v prípade nefunkčnosti tu).

Multimena

Spoločnosť Shopify v súčasnosti umožňuje predaj vo viacerých menách len pri použití služby Shopify Payments. Ak sa používa externý poskytovateľ platieb (napr. Comgate), suma sa pri presmerovaní na platobnú bránu vždy zobrazí v predvolenej mene obchodu.

Hoci zákazníci môžu počas procesu nakupovania zobraziť ceny v rôznych menách, skutočná platba sa uskutoční len v predvolenej mene. Toto technické obmedzenie vychádza z architektúry Shopify a v súčasnosti ho nie je možné obísť.

Odporúčaným riešením pre viacero mien je otvorenie nového obchodu v požadovanej mene. Samotná spoločnosť Shopify to uvádza ako vhodné riešenie vo svojej komunitnej nápovede.

Obchody s viacerými doménami

Shopify umožňuje prevádzkovať jeden obchod na viacerých doménach súčasne. Vďaka tomu môže byť jeden e-shop dostupný napríklad na adresách www.obchod.cz, www.e-shop.com, www.der-laden.de alebo www.il-negozio.it. Všetky tieto domény smerujú na jediný obchod, takže správa produktov, cien a objednávok prebieha centrálne. Rovnakým spôsobom je možné používať aj viac domén v rámci jednej krajiny (napr. www.obchod.cz a www.prodej.cz).

Poďme si vysvetliť, čo to presne znamená a aký to má dopad na konfiguráciu platebního doplňku Comgate.

Shopify smerovanie domén rieši centrálne. Každý obchod beží vždy pod východiskovou adresou vo formáte moj-obchod.myshopify.com. Túto doménu nie je možné odstrániť ani zmeniť. Všetky ďalšie domény sa na ňu smerujú pomocou aliasov (CNAME záznamov). Výhodou tohto riešenia je stabilita v čase – zmeny domén neovplyvňujú samotnú prevádzku obchodu.

Comgate pre integráciu platieb využíva práve východiskovú doménu vo formáte myshopify.com, takže sa nemusíte obávať žiadnych problémov, ak neskôr upravíte mapovanie svojich vlastných domén (doplňek platební brány Comgate sa inštaluje na obchod, nie na doménu).

Cielenie na rôzne trhy a multimena na jednom obchode

Ak prevádzkujete jeden obchod, pri ktorom máte pre každý cieľový trh nastavenú vlastnú národnú doménu, môže byť situácia komplikovanejšia v kombinácii s multimenou. Ak na všetkých trhoch používate rovnakú menu, aká je hlavná mena obchodu, všetko je bez problémov.

Ak však napríklad pre domény .cz používate CZK (hlavnú menu obchodu) a pre zahraničný trh (napríklad doména .de) máte nastavenú menu EUR, všetko bude fungovať až do okamihu presmerovania na platební bránu Comgate.

Shopify neumožňuje u externých platobných služieb (mimo Shopify payments) prevádzkovať skutočnú multimenu. V praxi to znamená, že akákoľvek iná mena než hlavná mena obchodu bude automaticky prepočítaná interným kurzom Shopify a v tejto mene bude vykonaná platba cez Comgate. V rovnakej mene vám budú následne vyplatené aj finančné prostriedky.

Ďalšie podrobnosti nájdete v kapitole Multimena.

Vlastný obchod pre každý cieľový trh

Často sa možno stretnúť s prístupom, keď si obchodník vytvorí viac samostatných obchodov, z ktorých každý je určený pre iný cieľový trh. Tento model je ľahko rozpoznateľný podľa toho, že každý obchod je spravovaný v oddelenej administrácii a má vlastnú fakturáciu. V takom prípade je nutné nainštalovať doplňek platební brány Comgate na každý obchod zvlášť a pre každý z nich vykonať samostatnú konfiguráciu s príslušnými prístupovými údajmi.

Ak sú teda v Comgate pod jednou smlouvou registrované dva alebo viac samostatných obchodov (napr. www.obchod.cz a www.e-shop.com), zákaznícka podpora vygeneruje pre každý obchod unikátne prístupové údaje potrebné pre konfiguráciu doplnku (pozri krok 5 návodu Postup inštalácie doplnku). Každý obchod musí byť nakonfigurovaný samostatne a je potrebné dbať na to, aby nedošlo k zámene prístupových údajov.

Ak k zámene údajov medzi obchodmi predsa len dôjde, prepojenie platební brány nebude plne funkčné. Platby síce budú vytvorené, ale na nesprávnom obchode, a stav platby sa preto nepodarí odovzdať späť do Shopify. V takom prípade je nutné kontaktovať zákaznícku podporu Comgate. Oprava vyžaduje ručný zásah IT oddelenia a môže chvíľu trvať.

Zaokrúhľovanie platieb v mene HUF

Pri zakladaní platieb v mene HUF na platební bráně Comgate dochádza z technických dôvodov k automatickému matematickému zaokrúhleniu čiastky na celé hodnoty. Maximálna odchýlka činí 0,5 HUF (0,032 Kč).

Platební brána Comgate nepodporuje spracovanie čiastok v mene HUF s desatinnou hodnotou a vyžaduje, aby bola čiastka vždy uvedená v celých HUF. Za účelom správneho založenia a spracovania platby je preto čiastka automaticky upravená.

Toto správanie by nemalo mať dopad na väčšinu obchodníkov, pretože tí už vo väčšine prípadov pracujú s čiastkami v HUF uvádzanými v celých hodnotách.

Odporúčame túto informáciu uviesť aj priamo pri konkrétnom tovare, aby bol platca o prípadnom zaokrúhlení vopred informovaný.

Faktúry v mene HUF

Pri vystavovaní faktúr v mene HUF obsahujúcich desatinnú hodnotu je nevyhnutné zaistiť automatické vykonanie zaokrúhľovacieho vyrovnania (rounding adjustment), aby výsledná čiastka zodpovedala formátu celých hodnôt podporovaných platební bránou.

Refundácie

Rovnaké pravidlá ako pre zakladanie platieb platia aj pre refundácie.

Google Pay, Apple Pay a PayPal

V súlade s požiadavkami spoločnosti Shopify na platobné rozšírenia nie je v rámci platobnej brány Comgate možné prevádzkovať platby prostredníctvom Google Pay, Apple Pay a PayPal.

Dodatočné poplatky

V prípade, že nie je využívaná služba Shopify Payments a obchodník sa rozhodne pre platobné riešenie tretej strany (Comgate a pod.), účtuje si spoločnosť Shopify transakčný poplatok. Výška tohto poplatku môže činiť až 2 % z celkovej sumy každej transakcie a odvíja sa od plánu, ktorý má obchodník u Shopify na obchode dohodnutý. Podrobnosti sú uvedené v oficiálnom cenníku Shopify, v prehľade funkcií na riadku „Transakční poplatky třetích stran při nepoužívání služby Shopify Payments“.

Postup inštalácie doplnku

1) Obchodník klikne na odkaz (v prípade nefunkčnosti tu), ktorý vedie na detail aplikácie v Shopify store, kde má možnosť začať s inštaláciou.

2) Shopify zobrazí žiadosť o potvrdenie oprávnenia aplikácie pre prístup k údajom obchodu.

3) Po odsúhlasení je obchodník presmerovaný do rozhrania externej aplikácie, ktorá ho prevedie ďalšími krokmi. Pre Comgate je prvým krokom odoslanie registračného e-mailu do Comgate s technickými detailami o prepojení.

4) Nasleduje čakanie na kontakt od Comgate, že je účet pripravený. Potom sa cez rovnaký odkaz dostane späť.

Môžete využiť aj alternatívnu cestu v nastavení Vášho obchodu kliknúť na Platby (1), v sekcii Ďalšie platobné metódy vybrať platobný doplnok Comgate (2 - nie je na obrázku). V detaile doplnku kliknete vpravo hore na Ďalšie akcie (3) a vyberte Správa (4).

5) Obchodník vyplní údaje pre komunikáciu s API platobnej brány.

6) Pri úspešnom overení údajov je obchodníkovi sprístupnená posledná časť sprievodcu, kde môže vykonať dodatočné nastavenie brány, kým stlačí tlačidlo Aktivovat.

7) Následne je presmerovaný späť do Shopify s informáciami o prepojení, kde môže zapnúť testovací mód a prípadne zvoliť podporované platobné metódy. V spodnej časti je potom ďalšie zelené tlačidlo Aktivovat, ktoré až teraz sprístupní bránu pre zobrazenie v obchode.

8) Pokiaľ obchodník využíval predchádzajúce platobné riešenie, môže ho v Settings > Payments teraz deaktivovať.

Synchronizácia názvov objednávok a párovanie platieb

ID platby Comgate sa v súčasnosti nezobrazuje v detaile objednávky v administračnom prostredí Shopify. Synchronizujeme však názvy objednávok zo Shopify do nášho systému. Pre párovanie platieb je možné využiť:

• Klientský portál Comgate, kde sú na stránke Platby zákazníkov pri každej platbe uvedené ID platby Comgate (Comgate ID) aj ID objednávky Shopify (ID od klienta).
  

• denné či mesačné vyúčtovanie, kde sú obidva údaje uvedené rovnako ako Comgate ID a ID od klienta. Je možné využiť formáty CSV aj ABO (prečítajte si špecifikácie pre ABO).

Keďže Shopify názov objednávky generuje až potom, čo je uhradená, je platba v systéme Comgate založená s ID Shopify platby (napr.: rJNzsrQKFQUFHnDJeUUcZoQhL), ktoré je vygenerované v Shopify. Túto hodnotu je možné nájsť tiež v Shopify v detaile objednávky v časovej ose po rozkliknutí informácií o platbe:

Vo chvíli, keď dôjde k zaplateniu platby a úspešnému odovzdaniu stavu do e-shopu, sa automaticky synchronizuje názov objednávky Shopify (napr: 1001).

Ako synchronizácia funguje

Systém Comgate si zo Shopify automaticky sťahuje informácie o názve objednávok (napr: 1001), ktoré sú následne dostupné v Klientskom portáli v prehľade platieb v stĺpci ID od klienta.

Synchronizácia prebieha vždy niekoľko desiatok sekúnd potom, čo je platba úspešne uhradená a podarilo sa odovzdať stav platby do e-shopu. V krajných prípadoch sa môže stať, že sa synchronizácia o niekoľko hodín oneskorí.

To znamená, že v denných i mesačných exportoch nájdete v úspešne zaplatených platbách v ID od klienta názov Shopify objednávky.

Názov objednávky obsahujú exporty objednávok aj exporty transakčnej histórie priamo zo Shopify pod názvom Name.

Formát čísla objednávky zo Shopify

Synchronizovaný formát závisí na nastavení Synchronizácie ID objednávky v Klientskom portále.

Číslo objednávky (1005)

Jedná sa predvolené nastavenie, kde je synchronizované poradové číslo objednávky, v ktorom nie je zahrnutá predpona ani prípona z nastavenia obchodu (Nastavení → Obecné → ID objednávky).

Príklad série: 1001, 1002, 1003

Názov objednávky (#1005s)

Je synchronizovaný celý názov objednávky vrátane predpony a prípony z nastavenia obchodu (Nastavení → Obecné → ID objednávky).

Príklad série: #1001s, #1002s, #1003s

Návod na synchronizáciu objednávok v Shopify

Na zaistenie synchronizácie objednávok a refundácií medzi Shopify a platobnou bránou Comgate je potrebné vytvoriť vlastnú privátnu aplikáciu, získať prístupové údaje a následne ich uložiť do Klientskeho portálu Comgate. Nižšie nájdete kompletný postup od vytvorenia aplikácie až po jej prepojenie s obchodom v portáli Comgate a spustenie synchronizácie.

Vytvorenie aplikácie v Shopify

1. Prvým krokom je overenie vlastníka obchodu, t. j. osoby, ktorá je v súčasnosti vlastníkom obchodu. Je žiaduce, aby nasledujúca konfigurácia bola vykonaná výlučne prostredníctvom účtu tejto osoby.
   
   

   Iba táto osoba je oprávnená vytvoriť a nakonfigurovať vlastnú aplikáciu, prostredníctvom ktorej je možné synchronizáciu vykonať. Ak aplikáciu vytvorí iná osoba, nie je zaručené, že synchronizácia bude fungovať.

2. V administrácii Shopify prejdite do Nastavenia a otvorte sekciu Aplikácie a predajné kanály.

3. V pravom hornom rohu kliknite na Vyvíjať aplikácie.
   

4. V zobrazenom okne kliknite na Vytvárať aplikácie v Dev Dashboarde.
   

5. Po presmerovaní do Dev Dashboardu kliknite na Create App.
   

6. V pravom paneli zadajte ľubovoľný názov aplikácie (napr. Synchronizácia ID objednávok s Comgate) a potvrďte tlačidlom Create.
   

7. V nasledujúcom kroku vložte do poľa App URL v sekcii URLs túto adresu (ide iba o odkaz na dokumentáciu, po inštalácii aplikácie naň budete automaticky presmerovaní): https://help.comgate.cz/docs/shopify

Táto URL nevyžaduje žiadnu ďalšiu akciu z vašej strany. Po presmerovaní na dokumentáciu ju môžete jednoducho zavrieť. Shopify však vyplnenie URL pre aplikáciu vyžaduje, preto je nutné ju doplniť.

8. Zrušte zaškrtnutie voľby Embed app in Shopify admin.

9. V sekcii Access kliknite na Select scopes.
   

10. Vyhľadajte „order“ a v sekcii Admin API – Orders zaškrtnite read_orders.

11. Potvrďte voľbu tlačidlom Done.
    

12. Potvrďte vytvorenie aplikácie kliknutím na tlačidlo Release v spodnej časti obrazovky a v následnom okne opäť potvrďte kliknutím na Release. Povolení přístupu k chráněným zákaznickým údajům.
    
    
    

Inštalácia aplikácie do Shopify obchodu

1. V Dev Dashboard prejdite na záložku Home.
   

2. V sekcii Installs kliknite na Install app.
   

3. V novom okne vyberte obchod, do ktorého chcete aplikáciu nainštalovať.
   

4. Potvrďte prístupy a inštaláciu kliknutím na Inštalovať.
   

5. Po dokončení inštalácie budete presmerovaní na stránku Comgate s návodom k aktivácii synchronizácie ID objednávok (ide o tú istú URL, ktorú ste vyplnili pri zakladaní aplikácie). Túto stránku môžete zatvoriť a pokračovať ďalej v tomto návode.

Zdieľanie prístupových údajov v klientskom portáli Comgate

Posledným krokom k dokončeniu celého procesu synchronizácie objednávok a refundácií v Shopify je zdieľať so spoločnosťou Comgate prístupové údaje do vašej vytvorenej aplikácie. Pre správne fungovanie je potrebné zdieľať Client ID a Secret aplikácie do klientského portálu podľa návodu nižšie.

1. V klientskom portáli Comgate otvorte v hornom menu sekciu Integrácie → Nastavenie obchodov.

2. Vyberte príslušný obchod.

3. V záložke Prepojenie obchodu kliknite na Editovať (ak neviete, ktoré prepojenie editovať, postupujte podľa návodu v časti Ako zistiť správne prepojenie obchodu pre editáciu).
   

4. Pre zobrazenie ďalších konfigurácií musia byť vyplnené nasledujúce polia (ktoré vám do integrácie už vyplnila zákaznícka podpora pri aktivácii platobného doplnku):

1. Url zaplatený

2. Url zrušený

3. Url nevyriešený

4. Url pre odovzdanie výsledku platby

Všetky musia obsahovať URL adresu s doménou .myshopify.com.

5. V prípade ich správneho vyplnenia (pravdepodobne nič nemeníte) by mala byť zobrazená voľba Povoliť nastavenie pre Shopify – zaškrtnite ju.

6. Vyplňte zobrazené polia údajmi z Dev Dashboardu (sekcia Credentials aplikácie).
   
   

7. Vyberte formát synchronizácie.

8. Uložte konfiguráciu tlačidlom Uložiť.
   

Ako zistiť správne prepojenie obchodu pre editáciu

1. V Shopify administrácii obchodu prejdite do sekcie Nastavenia → Platba.

2. V zozname platobných metód vyberte doplnok Comgate.

3. V pravom hornom rohu kliknite na Ďalšie akcie a potom na Spravovať.

4. V otvorenom formulári vyhľadajte pole Registrovaný identifikátor prepojenia obchodu.
   Tento identifikátor určuje konkrétne prepojenie, ktoré je potrebné upraviť v klientskom portáli Comgate. Iné neměňte.

Použitie jednej aplikácie pre viac obchodov

Ak potrebujete synchronizovať objednávky z viacerých Shopify obchodov, nie je potrebné vytvárať novú aplikáciu pre každý z nich. Stačí tú istú aplikáciu v Dev Dashboard nainštalovať do ďalších obchodov a pre každý z nich vykonať konfiguráciu v klientskom portáli Comgate.