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.
Postup
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.
Nezpracováváme žádné citlivé informace o objednávkách. Z obchodu stahujeme pouze Název objednávky (např: 1001) a to jen u zaplacených plateb. Díky tomu vám umožňujeme snadno si párovat objednávky v různých účetních systémech.
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“.
Mimořádnou pozornost věnujte nastavení položky Synchronizace ID objednávky. Nastavení určuje, zda chcete synchronizovat do systémů Comgate ID objednávky s předponou a příponou nebo bez nich. Více informací najdete v sekci Formát čísla objednávky ze Shopify.
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.
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 provedeném výše v kroku 6).
V případě, že chcete hodnotu změnit a nevíte kde, můžete postupovat podle kroku 4) a dostat se do konfigurace platebního doplňku.
Čí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 (Podrobnosti obchodu -> 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 (Podrobnosti obchodu -> ID objednávky). Příklad řady: #1001s, #1002s, #1003s
Jak povolit platebnímu doplňku Comgate přístup k informacím o názvech objednávek v systému Shopify
Postup je velmi podobný první instalaci platebního doplňku. Usnadněním je již uložená konfigurace propojení se systémy Comgate, které tak již není třeba provádět znovu. Není tedy nutné kontaktovat zákaznickou podporu ani dohledávat údaje v Klientském portálu.
- Pokud jste ve svém obchodě ještě platební doplněk Comgate neměli aktivovaný, postupujte podle tohoto návodu.
- Pokud jste v obchodě platební doplněk Comgate již provozovali nebo jej aktuálně provozujete, je třeba poskytnout aplikaci nová oprávnění přístupu k informacím o objednávkách:
- Otevřete Nastavení svého obchodu a přejděte do sekce Platby. V ní najděte platební doplněk Comgate a klikněte na něj.
- Na konci zobrazené stránky najděte tlačítko Deaktivovat.
- Následující dialog potvrďte kliknutím na Odinstalovat.
- Deaktivovaný doplněk odinstalujte kliknutím na tlačítko Odinstalovat.
- Opět potvrďte v dialogovém okně kliknutím na Odinstalovat.
- Platební doplněk je nyní odinstalován.
- Nyní platební doplněk opětovně nainstalujte ze Shopify Store – na tomto odkazu klikněte na tlačítko Instalovat.
- Pokud se objeví seznam obchodů, vyberte ten, na kterém jste právě platební doplněk Comgate odinstalovali a chcete ho znovu nainstalovat:
- Zobrazí se potvrzovací stránka pro instalaci platebního doplňku, kde je možné přečíst si, jaká oprávnění aplikace žádá. Instalaci potvrdíte kliknutím na tlačítko Nainstalovat. Aplikace nově získá přístup k informacím o vašich objednávkách za posledních 60 dnů. Díky tomu je aplikace Comgate schopna získat informaci o názvu (např: 1001) zaplacené objednávky. Tu následně dokáže převést do systému Comgate a zahrnout ji do exportů a výpisů.
Nezpracováváme žádné citlivé informace o objednávkách. Z obchodu stahujeme pouze Název objednávky (např: 1001) a to jen u zaplacených plateb. Díky tomu vám umožňujeme snadno si párovat objednávky v různých účetních systémech. - Nainstaluje se platební aplikace a zobrazí se stránka s kontaktními údaji. Zde můžete případně doplnit informace a uložit je kliknutím na tlačítko Uložit nastavení.
Aktivujte platební doplněk kliknutím na tlačítko Aktivovat. - Po aktivaci dojde k přesměrování na konfiguraci platebního doplňku v nastavení obchodu. Zde si vyberete povolené platební metody a zkontrolujete stav zkušebního režimu (pravděpodobně ho budete chtít mít vypnutý, pak je třeba, aby bylo prázdné zaškrtávací pole). Na závěr je potřeba aktivovat platební doplněk v obchodě kliknutím na tlačítko Aktivovat.
- Dojde k opětovné aktivaci platebního doplňku. V tuto chvíli je platební metoda v košíku vašeho obchodu opět dostupná a plně funkční. Doporučujeme však, abyste si tuto skutečnost ověřili založením pokusné objednávky:
- vložte do košíku libovolný produkt a postupujte na platbu,
- vyplňte údaje o zákazníkovi,
- vyberte platební metodu Comgate,
- klikněte na tlačítko Zaplatit (dojde k přesměrování na platební bránu Comgate),
- platbu můžete zrušit (jinak bude automaticky zrušena podle nastavení obchodu, nejpozději do 7 dní).
Platební doplněk jste tímto úspěšně reautorizovali. V tuto chvíli můžete očekávat, že všechny následující platby budou mít synchronizováno ID objednávky ze systému Shopify v systému Comgate v poli ID od klienta.
Synchronizace bude spuštěna nejpozději 24 hodin po reautorizaci práv. Následně probíhá vždy několik desítek sekund poté, co je platba úspěšně uhrazena a dojde k úspěšnému předání stavu do vašeho e-shopu. Ve velmi krajních případech se může stát, že synchronizace bude u některých plateb mírně opožděna.