Shopify

Máte e-shop na Shopify a používáte platební bránu Comgate? Stačí si pouze nainstalovat náš modul přes tento odkaz.

Multiměna

Shopify aktuálně umožňuje víceměnový prodej pouze při použití služby Shopify Payments. Pokud je použit tzv. offsite platební poskytovatel (např. Comgate), částka se při přesměrování na platební bránu vždy zobrazí ve výchozí měně obchodu.

Zákazníci si sice mohou v průběhu nakupování zobrazit ceny v různých měnách, ale samotná platba probíhá pouze ve výchozí měně. Tento technický limit vychází z architektury Shopify a nelze jej v současnosti obejít.

Doporučeným řešením multiměny je otevření nového obchodu v požadované měně. Samotné Shopify tento postup, ve své komunitní nápovědě zmiňuje jako vhodné řešení.

Obchody s více doménami

Shopify umožňuje provozovat jeden obchod na více doménách současně. Díky tomu může být jeden e-shop dostupný například na adresách www.obchod.cz, www.e-shop.com, www.der-laden.de nebo www.il-negozio.it. Všechny tyto domény směrují na jediný obchod, takže správa produktů, cen a objednávek probíhá centrálně. Stejným způsobem lze používat i více domén v rámci jedné země (např. www.obchod.cz a www.prodej.cz).

Pojďme si vysvětlit, co to přesně znamená a jaký to má dopad na konfiguraci platebního doplňku Comgate.

Shopify směrování domén řeší centrálně. Každý obchod běží vždy pod výchozí adresou ve formátu muj-obchod.myshopify.com. Tuto doménu nelze odstranit a dokonce ani změnit. Všechny další domény se na ni směrují pomocí aliasů (CNAME záznamů). Výhodou tohoto řešení je stabilita v čase – změny domén neovlivňují samotný provoz obchodu.

Comgate pro integraci plateb využívá právě výchozí doménu ve formátu myshopify.com, takže se nemusíte obávat žádných problémů, pokud později upravíte mapování svých vlastních domén (doplněk platební brány Comgate se instaluje na obchod, nikoliv doménu).

Cílení na různé trhy a multiměna na jednom obchodu

Pokud provozujete jeden obchod u něhož máte pro každý cílový trh nastavenou vlastní národní doménu, může být situace složitější v kombinaci s multiměnou. Pokud na všech trzích používáte stejnou měnu jako je hlavní měna obchodu, vše je bez problému.

Pokud však například pro domény .cz používáte CZK (hlavní měnu obchodu) a pro zahraniční trh (například doména .de) máte nastavenou měnu EUR, vše bude fungovat až do okamžiku přesměrování na platební bránu Comgate.

Shopify neumožňuje u externích platebních služeb (mimo Shopify payments) provozovat skutečnou multiměnu. V praxi to znamená, že jakékoliv jiná měna než je hlavní měna obchodu bude automaticky přepočítána interním kurzem Shopify a v této měně bude provedena platba přes Comgate. Ve stejné měně vám budou následně vyplaceny i finanční prostředky.

Další podrobnosti naleznete v kapitole Multiměna.

Vlastní obchod pro každý cílový trh

Často se lze setkat s přístupem, kdy si obchodník vytvoří více samostatných obchodů, z nichž každý je určen pro jiný cílový trh. Tento model je snadno rozpoznatelný podle toho, že každý obchod je spravován v oddělené administraci a má vlastní fakturaci. V takovém případě je nutné nainstalovat doplněk platební brány Comgate na každý obchod zvlášť a pro každý z nich provést samostatnou konfiguraci s příslušnými přístupovými údaji.

Pokud jsou tedy v Comgate pod jednou smlouvou registrovány dva či více samostatných obchodů (např. www.obchod.cz a www.e-shop.com), zákaznická podpora vygeneruje pro každý obchod unikátní přístupové údaje potřebné pro konfiguraci doplňku (viz krok 5 návodu Postup instalace doplňku). Každý obchod musí být nakonfigurován samostatně a je nutné dbát na to, aby nedošlo k záměně přístupových údajů.

Pokud k záměně údajů mezi obchody přesto dojde, propojení platební brány nebude plně funkční. Platby sice budou vytvořeny, ale na nesprávném obchodě, a stav platby se proto nepodaří předat zpět do Shopify. V takovém případě je nutné kontaktovat zákaznickou podporu Comgate. Oprava vyžaduje ruční zásah IT oddělení a může nějaký čas trvat.

Zaokrouhlování plateb v měně HUF

Při zakládání plateb v měně HUF na platební bráně Comgate dochází z technických důvodů k automatickému matematickému zaokrouhlení částky na celé hodnoty. Maximální odchylka činí 0,5 HUF (0,032 Kč).

Platební brána Comgate nepodporuje zpracování částek v měně HUF s desetinnou hodnotou a vyžaduje, aby byla částka vždy uvedena v celých HUF. Za účelem správného založení a zpracování platby je proto částka automaticky upravena.

Toto chování by nemělo mít dopad na většinu obchodníků, protože ti již ve většině případů pracují s částkami v HUF uváděnými v celých hodnotách.

Doporučujeme tuto informaci uvést také přímo u konkrétního zboží, aby byl plátce o případném zaokrouhlení předem informován.

Faktury v měně HUF

Při vystavování faktur v měně HUF obsahujících desetinnou hodnotu je nezbytné zajistit automatické provedení zaokrouhlovacího vyrovnání (rounding adjustment), aby výsledná částka odpovídala formátu celých hodnot podporovaných platební bránou.

Refundace

Stejná pravidla jako pro zakládání plateb platí také pro refundace.

Google Pay, Apple Pay a PayPal

V souladu s požadavky společnosti Shopify na platební rozšíření nelze v rámci platební brány Comgate provozovat platby prostřednictvím Google Pay, Apple Pay a PayPal.

Dodatečné poplatky

V případě, že není využívána služba Shopify Payments a obchodník se rozhodne pro platební řešení třetí strany (Comgate, …), účtuje si společnost Shopify transakční poplatek. Výše tohoto poplatku může činit až 2 % z celkové částky každé transakce a odvíjí se od plánu, který má obchodník u Shopify na obchodu sjednán. Podrobnosti jsou uvedeny v oficiálním ceníku Shopify, v přehledu funkcí na řádku „Transakční poplatky třetích stran při nepoužívání služby Shopify Payments“.

Postup instalace doplňku

1) Klikněte na odkaz, který vede na detail aplikace v Shopify store. Tam začnete s instalací.

2) Shopify zobrazí žádost o potvrzení oprávnění aplikace pro přístup k datům obchodu.

3) Po odsouhlasení je obchodník přesměrován do rozhraní externí aplikace, která ho provede dalšími kroky. Pro Comgate je prvním krokem odeslání registračního e-mailu do Comgate s technickými detaily o propojení.

4) Následuje čekání na kontakt od Comgate, že je účet připravený. Poté se přes stejný odkaz dostanete zpět do aplikace.

Můžete využít i alternativní cestu v nastavení Vašeho obchodu kliknout na Platby (1), v sekci Další platební metody vybrat platební doplněk Comgate (2 - není na obrázku). Na detailu doplňku kliknete vpravo nahoře na Další akce (3) a vyberte Spravovat (4).

5) Vyplníte údaje pro komunikaci s API platební brány.

6) Při úspěšném ověření údajů se dostanete do poslední části průvodce, kde můžete provést dodatečná nastavení brány, než stisknete tlačítko „Aktivovat“.

7) Následuje přesměrování zpět do Shopify s informacemi o propojení, kde můžete zapnout testovací mód a případně zvolit podporované platební metody. Ve spodní části je pak další tlačítko Aktivovat, které teprve zpřístupní bránu pro zobrazení v obchodě.

8) Pokud jste využívali předchozí platební řešení, můžete jej v Settings → Payments nyní deaktivovat.

Synchronizace názvů objednávek a párování plateb

ID platby Comgate se v současnosti nezobrazuje v detailu objednávky v administračním prostředí Shopify. Synchronizujeme však názvy objednávek ze Shopify do našeho systému. Pro párování plateb je možné využít:

• Klientský portál Comgate, kde jsou na stránce Platby > Platby zákazníků u každé platby uvedena ID platby Comgate (Comgate ID) i ID objednávky Shopify (ID od klienta).

  

• denní či měsíční vyúčtování, kde jsou oba údaje uvedeny rovněž jako Comgate ID a ID od klienta. Je možné využít formáty CSV i ABO (přečtěte si specifika pro ABO).

Jelikož Shopify název objednávky generuje až poté, co je uhrazena, je platba v systému Comgate založena s ID Shopify platby (např.: rJNzsrQKFQUFHnDJeUUcZoQhL), které je vygenerované v Shopify. Tuto hodnotu je možné také nalézt v Shopify v detailu objednávky v časové ose po rozkliknutí informací o platbě:

Ve chvíli, kdy dojde k zaplacení platby a úspěšnému předání stavu do e-shopu, automaticky se synchronizuje název objednávky Shopify (např.: 1001).

Jak synchronizace funguje

Systém Comgate si ze Shopify automaticky stahuje informace o názvu objednávek (např: 1001), které jsou následně dostupné v Klientském portálu v přehledu plateb ve sloupci ID od klienta.

Synchronizace probíhá vždy několik desítek sekund poté, co je platba úspěšně uhrazena a podařilo se předat stav platby do e-shopu. V krajních případech se může stát, že se synchronizace o několik hodin opozdí.

To znamená, že v denních i měsíčních exportech najdete u úspěšně zaplacených plateb v ID od klienta název Shopify objednávky.

Název objednávky obsahují i exporty objednávek i exporty transakční historie přímo ze Shopify pod názvem Name.

Formát čísla objednávky ze Shopify

Synchronizovaný formát závisí na nastavení Synchronizace ID objednávky v Klientském portálu.

Číslo objednávky (1005)

Jedná se o výchozí nastavení, kdy je synchronizováno pořadové číslo objednávky, ve kterém není zahrnuta předpona ani přípona z nastavení obchodu (Nastavení → Obecné → ID objednávky).

Příklad řady: 1001, 1002, 1003

Název objednávky (#1005s)

Je synchronizován celý název objednávky včetně předpony a přípony z nastavení obchodu (Nastavení → Obecné → ID objednávky). Příklad řady: #1001s, #1002s, #1003s

Návod na synchronizaci objednávek v Shopify

Pro zajištění synchronizace objednávek a refundací mezi Shopify a platební bránou Comgate je nutné vytvořit vlastní privátní aplikaci, získat přístupové údaje a následně je uložit do klientského portálu Comgate. Níže naleznete kompletní postup od vytvoření aplikace až po její propojení s obchodem v portálu Comgate a zahájení synchronizace.

Vytvoření aplikace v Shopify

1. V prvním kroku je nutné ověřit vlastníka obchodu, tedy osobu, která obchod v současnosti vlastní. Je žádoucí, aby následující konfigurace byla provedena výhradně prostřednictvím účtu této osoby.

   

   
   

   Pouze tato osoba je oprávněna vytvořit a nakonfigurovat vlastní (custom) aplikaci, jejímž prostřednictvím je možné provádět synchronizaci. Pokud bude aplikace vytvořena jinou osobou, není garantováno, že bude synchronizace funkční.

2. V administraci Shopify přejděte do Nastavení a otevřete sekci Aplikace a prodejní kanály.

3. V pravém horním rohu klikněte na Vyvíjet aplikace.
   

4. V zobrazeném okně klikněte na Vytvářet aplikace v Dev Dashboardu.
   

5. Po přesměrování do Dev Dashboardu klikněte na Create App.
   

6. V pravém panelu zadejte libovolný název aplikace (např. “Synchronizace ID objednávek s Comgate”) a potvrďte tlačítkem Create.
   

7. V následujícím kroku do pole App URL v sekci URLs vložte tuto adresu (jedná se pouze o odkaz na dokumentaci a po instalaci aplikace na ni budete automaticky přesměrováni): https://help.comgate.cz/docs/shopify

Tato URL nevyžaduje žádnou další akci z Vaší strany. Po přesměrování na dokumentaci ji můžete jednoduše zavřít. URL je vyplňována, jelikož Shopify tuto hodnotu pro aplikaci vyžaduje.

7. Zrušte zaškrtnutí volby Embed app in Shopify admin.

8. V sekci Access klikněte na Select scopes.
   

9. Vyhledejte „order“ a v sekci Admin API – Orders zaškrtněte read_orders.

10. Potvrďte volbu tlačítkem Done.

11. Potvrďte vytvoření aplikace kliknutím na tlačítko “Release” v spodní části obrazovky a v následném okně opět potvrďte kliknutím na tlačítko “Release”.
    

Instalace aplikace do Shopify obchodu

1. V Dev Dashboardu přejděte na záložku Home.

2. V sekci Installs klikněte na Install app.

3. V novém okně vyberte obchod, do kterého chcete aplikaci nainstalovat.

4. Potvrďte přístupy a instalaci kliknutím na Instalovat.

5. Po dokončení instalace budete přesměrováni na stránku Comgate s návodem k aktivaci synchronizace ID objednávek (jedná se o stejnou URL, kterou jste vyplňovali při zakládání aplikace). Tuto stránku můžete zavřít a pokračovat dále v tomto návodu.

Sdílení přístupových údajů v klientském portálu Comgate

Posledním krokem k dokončení celého procesu synchronizace objednávek a refundací v Shopify je třeba se společností Comgate sdílet Přístupové údaje do Vaší vytvořené aplikace. Pro správné fungování je potřeba sdílet Client ID a Secret aplikace do klientského portálu dle návodu níže.

1. V klientském portálu Comgate otevřete v horním menu sekci Integrace → Nastavení obchodů.

2. Vyberte příslušný obchod.

3. V záložce Propojení obchodu klikněte na Editovat (pokud nevíte jaké propojení editovat, postupujte návodem v Jak zjistit správné propojení obchodu pro editaci

4. Pro zobrazení dalších konfigurací musí být vyplněna následující pole (které vám do integrace již vyplnila zákaznická podpora při aktivaci platebního doplňku):

   1. Url zaplacený

   2. Url zrušený

   3. Url nevyřízený

   4. Url pro předání výsledku platby

      Všechny musí obsahovat URL adresu s doménou .myshopify.com.

5. V případě jejich správného vyplnění (vy pravděpodobně nic neměníte, by měla být  zobrena volba Povolit nastavení pro Shopify – zaškrtněte ji.

6. Vyplňte zobrazená pole údaji z Dev Dashboardu (sekce Credentials aplikace).
   

   
   

7. Vyberte formát synchronizace.

8. Uložte konfiguraci tlačítkem Uložit.
   

Jak zjistit správné propojení obchodu pro editaci

1. V Shopify administraci obchodu přejděte do sekce Nastavení → Platba.

2. V seznamu platebních metod vyberte doplněk Comgate.

3. V pravém horním rohu klikněte na Další akce a poté na Spravovat.

4. V otevřeném formuláři vyhledejte pole Registrovaný identifikátor propojení obchodu.
   Tento identifikátor určuje konkrétní propojení, které je nutné upravit v klientském portálu Comgate. Jiné neměňte.

Použití jedné aplikace pro více obchodů

Pokud potřebujete synchronizovat objednávky z více Shopify obchodů, není nutné vytvářet novou aplikaci pro každý z nich. Stačí tu samou aplikaci v Dev Dashboardu nainstalovat do dalších obchodů a pro každý z nich provést konfiguraci v Klientském portálu Comgate.