> For the complete documentation index, see [llms.txt](https://napoveda.rocketoo.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://napoveda.rocketoo.cz/rocketoo/rozsireni/comgate.md).
# Comgate
Platební brána
Platební brána [**ComGate**](https://www.comgate.cz) nabízí více než 50 platebních metod - platby kartou i bankovními tlačítky všech bank v ČR, SK i PL. Platby v měnách CZK, EUR, PLN, HUF, USD, GBP, HRK a RON. Brána komunikuje v 10 jazycích. Má transparentní ceník, kdy s růstem objemů plateb se automaticky snižují poplatky. Procento z běžných transakcí je 0,79 % až 0,99 %. Žádné fixní poplatky u běžných transakcí. Peníze zasílány denně a zdarma na libovolný účet. Možnosti opakovaných plateb, zapamatování karty i integrace do účetních SW. Zřízení na dálku, aktivace s e-mailovou a telefonickou podporou.
## Nastavení propojení s platební bránou ComGate
Pro správné fungování této platební metody musíme nejprve získat **ID obchodu**, **Secure key** a **propojit obchod s platební bránou** na klientském portálu ComGate.
### Nastavení propojení
Ve vašem e-shopu Rocketoo v nastavení platební brány ComGate (***Nastavení*** / ***Rozšíření*** / ***Online platby*** / ***ComGate***) zadejte **Identifikátor propojení obchodu** a **Heslo**, které jste obdrželi od ComGate.
V dalším kroku je potřeba nastavit váš e-shop na portálu ComGate. Přihlašte se tedy na [https://portal.comgate.cz](https://portal.comgate.cz/). Přejděte v menu po levé straně do záložky **Nastavení obchodů** a vyberte ten, který chcete spravovat (v případě, že je více jak jeden), poté klikněte na **Propojení obchodu** a nakonec na ikonu tužky **Upravit.**
V následující obrazovce zvolte jako **Povolený způsob založení platby** volbu ***HTTP POST protokol - backend - DOPORUČUJEME***. Dále do čtyř políček **Url zaplacený**, **Url zrušený**, **Url nevyřízený** a **Url pro předání výsledku platby** zkopírujte URL adresy, které najdete v nastavení v Rocketoo. Do pole **Povolené IP adresy** zkopírujte IP adresu taktéž z nastavení Rocketoo. **Správné nastavení IP adresy je důležité, bez něj nebude platební brána fungovat!** Celé nastavení uložte.
### Další nastavení
V **Nastavení** můžete také povolit pouze vybrané platební metody. Pokud nechcete některé z nich nabízet, aktivujte tuto volbu a v zobrazeném seznamu označte platební metody, které chcete z e-shopu vyloučit.
Pokud chcete, aby byly platby v **Comgate** označeny číslem vaší objednávky pro snadnější párování, aktivujte volbu **Jako refId zasílat číslo objednávky**. Po jejím nastavení je nutné v administraci **Comgate** v sekci **Nastavení obchodů** aktualizovat **URL adresy pro přenos informací o platbě**.
### Stavy objednávky po platbě
Po dokončení platby na **platební bráně** se e-shopu předávají informace o úspěšnosti nebo neúspěšnosti transakce. Na základě těchto údajů můžete automaticky měnit **stav objednávky** podle nastavení:
* **Stav po úspěšném zaplacení (PAID)** – měl by být nastaven tak, aby označoval objednávku jako zaplacenou.
* **Stav po neúspěšné platbě (CANCELLED)** – umožňuje označit objednávku jako nezaplacenou nebo zrušenou.
* **Stav po vytvoření platby, před jejím schválením (PENDING)** – tento stav vznikne v situaci, kdy platba byla založená, ale finální výsledek platby zatím není známý.
Správné nastavení těchto stavů vám pomůže automatizovat zpracování objednávek a zjednodušit správu plateb.
Tím máte propojení s platební bránou ComGate úspěšně nastaveno.
## Comgate Web Checkout
**Comgate Web Checkout** je platební řešení, které zákazníkovi umožňuje zaplatit přímo v prostředí košíku e-shopu – kartou, Apple Pay nebo Google Pay – bez přesměrování na samostatnou platební stránku. Platební brána se stává přirozenou součástí checkoutu, zákazník tak nikdy neopouští vaše prostředí.
#### Co Web Checkout nabízí
* **Platba kartou, Apple Pay a Google Pay** přímo v košíku
* **3D Secure** je obsluhováno SDK automaticky – žádná vlastní implementace není nutná
* **Přizpůsobitelný vzhled** – výběr z připravených presetů (světlý, tmavý) nebo vlastní nastavení, které ladí s designem vašeho e-shopu
* **Volba jazyka** platební brány
* **Plynulejší průchod objednávkou** – méně změn prostředí, méně rušivých momentů
{% hint style="info" %}
Podrobný popis funkce Web Checkoutu najdete na [blogu Comgate](https://www.comgate.eu/cs/blog/comgate-web-checkout). Online konfigurátor vzhledu brány je dostupný na [apidoc.comgate.cz/checkout/konfigurator](https://apidoc.comgate.cz/checkout/konfigurator/).
{% endhint %}
### Nastavení Web Checkoutu
Kompletní dokumentace ke konfiguraci Checkout SDK je dostupná na [**apidoc.comgate.cz/checkout/konfigurace**](https://apidoc.comgate.cz/checkout/konfigurace#konfigurace-v-klientskem-portalu).
#### 1. Konfigurace v klientském portálu Comgate
Pro aktivaci Web Checkoutu se přihlaste do [klientského portálu Comgate](https://portal.comgate.cz/cs/) a postupujte takto:
1. V horním menu vyberte **Integrace** → **Nastavení obchodů** → vyberte příslušný obchod.
2. Přejděte na záložku **Propojení obchodu** a vyberte propojení, přes které chcete Web Checkout provozovat.
3. Najděte položku **Checkout SDK** a zaklikněte ji.
4. V rozbalené části povolte všechny služby, které chcete provozovat (Apple Pay, Google Pay).
5. Do pole **Povolené originy** zadejte všechny domény (originy), na kterých bude Web Checkout fungovat – včetně vývojového a testovacího prostředí. Každý origin uvádějte na samostatný řádek.
Příklad:
```
# produkce
https://www.vas-eshop.cz
# testovací prostředí
https://test.vas-eshop.cz
```
\
**Web Checkout bude fungovat pouze na originech uvedených v tomto poli. Chybějící origin způsobí, že se platební rozhraní nenačte.**
6. Klikněte na **Uložit**.
#### 2. Získání `checkoutId`
Hodnota `checkoutId` jednoznačně identifikuje propojení obchodu a je vyžadována při konfiguraci modulu v Rocketoo.
1. Přejděte na seznam propojení obchodu (kroky 1–2 výše).
2. U požadovaného propojení klikněte na **ikonu oka** (zobrazit detail).
3. Sjeďte dolů a zkopírujte **Identifikátor Checkout SDK** (formát UUIDv4).
Tuto hodnotu zadejte do nastavení platební brány Comgate v administraci Rocketoo.
### Ověření domény pro Apple Pay
{% hint style="info" %}
Více informací: [apidoc.comgate.cz – ověření domény Apple Pay](https://apidoc.comgate.cz/checkout/konfigurace#overeni-domeny-apple-pay)
{% endhint %}
Apple Pay vyžaduje ověření domény pomocí speciálního validačního souboru. Bez ověření nebude Apple Pay na produkci fungovat.
#### Postup ověření
**Ověřte nahrání v klientském portálu** – v detailu propojení obchodu klikněte na **„Zkontrolovat pro \[název metody]"**. Po zobrazení zelené hlášky je zahájena automatická registrace u Apple (standardně do 10 minut, výjimečně až 24 hodin).
#### Důležitá upozornění
* Pokud chcete Apple Pay nabízet i na dalších subdoménách, je nutné ověření provést pro každou subdoménu zvlášť.
* Comgate nenese odpovědnost za nefunkčnost Apple Pay způsobenou neaktuálním validačním souborem.
#### Stavy registrace Apple Pay
| Stav | Popis |
| ---------------------------- | ------------------------------------------------------------------------------------------------------ |
| **Povoleno** | Registrace byla úspěšně dokončena, služba je aktivní. |
| **Zakázáno** | Služba je vypnuta. |
| *(čeká na registraci)* | Doména čeká na automatické zpracování registrace. |
| *(čeká na přeregistraci)* | Doména čeká na automatické zpracování přeregistrace. |
| *(zakázáno pro celý obchod)* | Apple Pay je zakázáno pro celý obchod – kontaktujte podporu Comgate. |
| *(chyba registrace)* | Deaktivujte Apple Pay, uložte, znovu aktivujte a uložte. Pokud problém přetrvává, kontaktujte podporu. |
### Ověření domény pro Google Pay
{% hint style="info" %}
Více informací: [apidoc.comgate.cz – ověření domény Google Pay](https://apidoc.comgate.cz/checkout/konfigurace#overeni-domeny-google-pay)
{% endhint %}
Google Pay nevyžaduje nahrání validačního souboru, ale vyžaduje schválení domény přes **Google Pay Console**. Na rozdíl od Apple Pay lze integraci při vývoji provozovat v testovacím režimu.
#### Postup ověření produkční domény
1. Přihlaste se do [Google Pay Console](https://pay.google.com/business/console).
2. V levém menu vyberte **Rozhraní API služby Google Pay** → **Integrate with your website** → **+ Add website**.
3. Vyplňte URL webu (včetně subdomény), jako typ integrace zvolte **Brána**.
4. Nahrajte **5 snímků obrazovky** znázorňujících průběh placení přes Google Pay:
1. Výběr produktu (prohlížení produktu/služby)
2. Obrazovka před nákupem (zákazník je připraven nakoupit)
3. Výběr platební metody (zákazník volí Google Pay)
4. Obrazovka platby Google Pay (zobrazení uložených platebních údajů)
5. Obrazovka po dokončení nákupu
5. Klikněte na **Uložit** a zkontrolujte všechny požadavky:
* První zaškrtávací políčko provedl za vás Comgate – potvrďte jej.
* Druhé políčko (systémová ověření) zajišťuje Checkout SDK automaticky – potvrďte jej.
* Třetí políčko (funkční testy) provedl Comgate – potvrďte jej.
6. Klikněte na **Submit for approval**.
{% hint style="warning" %}
Na webu nesmí být uvedeno, že se jedná o testovací nebo demo prostředí – doménu Google schvaluje pouze pro plně produkční produkt.
{% endhint %}
#### Google Pay Merchant ID
V nastavení modulu Comgate v Rocketoo je třeba vyplnit **Google Pay Merchant ID**. Tuto hodnotu najdete v pravém horním rohu hlavičky stránky Google Pay Console (formát např. `BCR2AN9TWDNZ7G2L`).
#### Řešení problémů
Pokud Google žádost zamítne, zašle e-mail s vysvětlením a dalším postupem. V případě nejasností využijte **„Okamžitá podpora"** v levém menu Google Pay Console (odpověď obvykle do 48 hodin). Comgate v procesu schvalování domén u Google nemá rozhodovací pravomoc.
