# Integrace, popis všech polí

Každé pole stránky Integrace: platební brána pays.cz, odkaz na ministránku a adresa kalendáře (iCal), kterou lze přidat do Google Calendar.

## Kde to je

V panelu otevřete Nastavení a v něm Integrace. Stránka je na adrese `/Admin/Nastaveni/Integrace`. Je jen pro přihlášeného poskytovatele.

## K čemu stránka slouží

Stránka má čtyři karty: API pro platby, odkaz na nastavení ministránky, platební bránu pays.cz pro online platby a adresu kalendáře (iCal), kterou lze přidat do Google Calendar nebo jiné kalendářové aplikace. Jediné pole formuláře jsou údaje platební brány.

Přístupové údaje k platební bráně pays.cz a k účtům zámků TTLock a Tuya nikomu neposílejte, ani nám e-mailem. Zadáváte je sami na stránce Integrace (u zámků na stránce Zámky), ukládají se šifrovaně a zpět se nezobrazí. Pomoc s nastavením se týká služeb, rozvrhu a rezervací, ne předání hesel k cizím službám.

## API pro platby

Napojte banku nebo vlastní program pro potvrzování přijatých plateb rezervací a vstupenek. Karta ukazuje „Zatím žádný přístup“, „Aktivní přístupy: N“ nebo „Dostupné v plánu Pro+“. Vidí ji jen uživatel s oprávněním na správu API; oprávnění zaměstnanců se nemění.

### Spravovat API pro platby

- **Co dělá:** Otevře správu přístupů a záznam volání na `/Admin/Nastaveni/ApiPlatby`. I bez Pro+ vede na stejnou stránku, která vysvětluje podmínku tarifu. Cesta je Nastavení → Integrace → API pro platby. Podrobnosti najdete v [příručce API pro platby](https://obsadto.cz/napoveda/reference/api-platby.md).

- **Výchozí hodnota:** Bez účinku, dokud odkaz neotevřete.
- **Povolené hodnoty:** Odkaz.
- **Platí pro:** účty s oprávněním ke správě API pro platby.
- **Na co má vliv:** Nic na stránce Integrace nemění.

## Pole

### Zapnout online platby (pays.cz)

- **Co dělá:** Po zapnutí rezervační formulář po vytvoření rezervace přesměruje zákazníka na platební bránu pays.cz. E-mail s potvrzením se odešle až po úspěšném zaplacení.
- **Výchozí hodnota:** Vypnuto.
- **Povolené hodnoty:** Zapnuto nebo vypnuto. Zapnutí zobrazí pole Merchant ID, Shop ID a Heslo pro API.
- **Platí pro:** všechny typy rezervací. Zda a jak se platba bránou uplatní u jednotlivých typů a služeb: Neověřeno.
- **Na co má vliv:** Průběh rezervace ve formuláři. Změna se projeví po stisknutí Uložit. Po uložení se zobrazí „Nastavení platební brány uloženo.“ Vztah k platbě zálohy převodem: Neověřeno.
- **Časté omyly:** Samotné zapnutí bez vyplněných údajů nestačí, server vyplnění neověřuje. Chování při prázdných údajích: Neověřeno.

### Merchant ID

- **Co dělá:** Identifikátor obchodníka u pays.cz.
- **Výchozí hodnota:** Prázdné.
- **Povolené hodnoty:** Libovolný text, formát se nekontroluje. Prázdné uloží prázdnou hodnotu.
- **Platí pro:** jen když jsou zapnuté online platby.
- **Na co má vliv:** Spojení s vaším účtem u pays.cz.

### Shop ID

- **Co dělá:** Identifikátor obchodu u pays.cz.
- **Výchozí hodnota:** Prázdné.
- **Povolené hodnoty:** Libovolný text, formát se nekontroluje. Prázdné uloží prázdnou hodnotu.
- **Platí pro:** jen když jsou zapnuté online platby.
- **Na co má vliv:** Spojení s vaším obchodem u pays.cz.

### Heslo pro API (pro MD5 hash – ponechte prázdné pro zachování stávajícího)

- **Co dělá:** Heslo k rozhraní pays.cz, které slouží k podpisu platby. Ukládá se šifrovaně a zpět se nezobrazí. Je-li uložené, ukáže se „Heslo je uloženo.“
- **Výchozí hodnota:** Prázdné.
- **Povolené hodnoty:** Libovolný text. Prázdné pole zachová stávající heslo, nové heslo ho přepíše. Heslo tedy nelze smazat prázdným polem.
- **Platí pro:** jen když jsou zapnuté online platby.
- **Na co má vliv:** Podpis požadavků na platební bránu.

### Uložit

- **Co dělá:** Uloží nastavení platební brány pays.cz.
- **Výchozí hodnota:** Bez účinku, dokud se nestiskne.
- **Povolené hodnoty:** Tlačítko. Uloží i vypnutí. Při vypnutí zůstanou Merchant ID, Shop ID a heslo uložené.
- **Platí pro:** jen kartu Platební brána pays.cz.
- **Na co má vliv:** Chování rezervačního formuláře po vytvoření rezervace.

### Přejít na nastavení ministránky

- **Co dělá:** Odkaz na stránku nastavení ministránky (odkaz na ministránku, QR kód a fronta čekajících).
- **Výchozí hodnota:** Bez účinku, jen přejde na jinou stránku.
- **Povolené hodnoty:** Odkaz.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Nic na této stránce nemění.

### Kopírovat

- **Co dělá:** Zkopíruje adresu kalendáře (iCal) do schránky. Na chvíli se změní na „Zkopírováno!“ Adresu vložíte do Google Calendar přes Přidat kalendář a Z URL. Podle zdrojového kódu jde o přenos jedním směrem, z Obsadta do kalendáře: v kalendáři uvidíte rezervace, ale události z Google Calendar termíny v Obsadtu neblokují (blokovat čas v Obsadtu lze jen dovolenou a rozvrhem). Do kalendáře se dostanou rezervace Potvrzeno a Čeká na potvrzení za posledních 30 dní a všechny budoucí. Potvrzená je v kalendáři jako potvrzená, čekající jako předběžná. U události se zobrazí název služby a jméno zákazníka v názvu a v popisu e-mail a telefon zákazníka, pokud je vyplněn. Jak často si Google adresu znovu načítá, určuje Google, ne Obsadto. Přesný interval Neověřeno. Čerstvě vytvořená rezervace se proto v kalendáři nemusí objevit hned.
- **Výchozí hodnota:** Bez účinku, dokud se nestiskne. Adresa je jen pro čtení.
- **Povolené hodnoty:** Tlačítko.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Nic se nemění, jen se kopíruje text. Adresa obsahuje tajný token a kdokoli s ní uvidí jména, e-maily a telefony zákazníků z rezervací, proto ji nesdílejte. Unikne-li, vygenerujte nový token, stará adresa pak přestane fungovat.

### Vygenerovat nový token

- **Co dělá:** Vytvoří nový token adresy kalendáře. Před provedením se zobrazí potvrzení „Starý token bude zneplatněn a budete muset URL znovu vložit do kalendáře. Pokračovat?“
- **Výchozí hodnota:** Bez účinku, dokud se nestiskne.
- **Povolené hodnoty:** Tlačítko.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Stará adresa kalendáře přestane fungovat a novou je nutné znovu vložit do kalendáře. Po provedení se zobrazí „Nový token vygenerován. Aktualizujte URL ve svém kalendáři.“

## Jak spolu pole souvisí

- Pole Merchant ID, Shop ID a Heslo pro API se zobrazí jen při zapnutém Zapnout online platby (pays.cz). Uloží se však společně s přepínačem.
- Karta pays.cz a karta kalendáře jsou nezávislé.
- Platební brána je jiný způsob než platba zálohy převodem. Údaje pro převod jsou na stránce Profil.

## Příklady nastavení

**Zapnutí online plateb.** Zapnete Zapnout online platby (pays.cz), vyplníte Merchant ID, Shop ID a heslo z účtu u pays.cz a stisknete Uložit. Zákazník je po rezervaci přesměrován na platbu.

**Přidání kalendáře do Google Calendar.** Stisknete Kopírovat, v Google Calendar zvolíte Přidat kalendář, Z URL a adresu vložíte. Když adresu omylem sdílíte, stisknete Vygenerovat nový token a novou vložíte znovu.

## Technická poznámka

Informace jsou převzaté ze zdrojového kódu (`Integrace.cshtml`, `Integrace.cshtml.cs`, `Provider.cs`). Kde chování nebylo možné ověřit, je to napsáno výslovně slovem Neověřeno.

Verze nápovědy: 1.0.2.74, 2026-11-22
