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.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.