Přijímání plateb na ubytování

Po dokončení tohoto návodu budete mít jedno ze svých ubytování (nebo služeb) nastavené na Přijímat platby, s typem účtování, výší zálohy (pokud volíte zálohu), s deadlinem a budete vědět, co host vidí a co vám pak naskáče v adminu.

Krok 1: Otevřete ubytování → sekce Rezervace

Postranní lišta → Místa → vaše ubytování (nebo Služby → vaše služba). Sjeďte na sekci Rezervace.

Sekce má dva sloupce vedle sebe:

• Chování widgetu — tři možnosti: Pouze dostupnost, Přijímat rezervace, Přijímat platby
• Typ rezervace — Okamžitá / Na žádost

Nová ubytování jsou ve výchozím stavu na Přijímat rezervace + Okamžitá.

Krok 2: Přepněte chování na Přijímat platby

Klikněte na Přijímat platby v přepínači Chování widgetu. Stane se dvojí:

1. Sloupec Typ rezervace se uzamkne na Okamžitá (možnost Na žádost je zakázaná a vybledlá). Hosté potvrzují platbou — to je krok ověření žádosti.
2. Pod sekcí se objeví nová podsekce Platby.

Pokud váš účet ještě nemá nakonfigurovanou platební bránu, uvidíte upozornění "Na vašem účtu zatím není nastavená žádná platební brána." s tlačítkem Nastavit platební bránu. Klikněte; přejdete na /settings. Nastavte Stripe (viz Platební brány) a vraťte se zpátky.

Krok 3: Vyberte typ účtování

V podsekci Platby je nahoře Platební brána — nechte na Výchozí brána účtu, pokud nechcete pro toto ubytování použít jinou.

Pod výběrem brány je přepínač s dvěma možnostmi:

Celá částka

Host zaplatí celou částku rezervace při checkoutu. Rezervace dorazí jako paid, datumy zablokované, peníze na vašem Stripe účtu.

Použijte, když:

• Celková částka je pro hosty pohodlná zaplatit předem (malé služby, denní pronájmy, výlety)
• Nechcete žádnou další práci s vybíráním po rezervaci
• Storno podmínky jsou dostatečně volné, aby předplata nebyla riziková

Záloha

Host zaplatí pevnou výši zálohy při checkoutu. Rezervace dorazí ve stavu deposit paid, datumy zablokované, zbytek vyberete později přes platební odkaz.

Při výběru Zálohy se objeví další pole: Výše zálohy. Zadejte částku (ve měně ubytování). Příklady:

• Ubytování od 3 000 do 8 000 Kč podle délky → záloha 2 000 Kč: každý platí stejnou 2k teď, zbytek později
• Tour balíček za 120 € → záloha 30 € pro zarezervování slotu, zbytek na místě

Použijte, když:

• Celkové částky jsou velké a celá platba předem by hosty odradila
• Chcete odfiltrovat vážné rezervace bez nutnosti zavázat hosta k celé částce
• Jste flexibilní s vybíráním zbytku ručně (bankovní převod, hotovost, druhá kartová platba)

Krok 4: Nastavte deadline rezervace (volitelné)

Pod typem účtování je Deadline rezervace, číselné pole s hodiny nápisem. Výchozí hodnota: 0.

Toto je hraniční čas, do kterého musí hosté dokončit platbu. Při deadlinu = 0 se sloty/datumy stanou nedostupnými pro nové rezervace ve chvíli, kdy uplyne čas začátku. Při 48 se stanou nedostupnými 48 hodin předem — užitečné, pokud potřebujete čas na přípravu.

Pro platby konkrétně se deadline aplikuje na odeslání checkoutu na Stripe, ne na rezervaci. Pokud host otevře dialog na poslední chvíli, ale na Stripe to nestihne, session vyprší a datumy se opět uvolní.

Krok 5: Notifikace

Poslední nastavení v sekci: přepínač Upozornit mě pro e-maily o nových rezervacích. Když je zapnutý, pošleme vám e-mail při každé příchozí rezervaci (zaplacené nebo se zálohou). E-mail obsahuje zaplacenou částku, zbývající doplatek (u zálohy) a odkaz na detail rezervace.

Krok 6: Uložte a otestujte

Nahoře na stránce → Uložit. Načtěte URL svého widgetu. Dialog rezervace teď ukazuje krok platby na obrazovce shrnutí.

End-to-end test (Stripe Test režim):

1. Otevřete veřejnou URL widgetu (použijte Zobrazit veřejný widget na stránce úpravy widgetu; stejný host jako admin)
2. Vyberte datumy → Rezervovat
3. Krok 3 (shrnutí) — pro režim Celá částka vidíte jedno velké číslo; pro režim Záloha vidíte celkovou částku + krátký odstavec: "Teď zaplatíte zálohu :deposit. Zbývající částku :remaining vybereme později." s tučně zvýrazněnými hodnotami
4. Klikněte na Zaplatit — otevře se nová záložka se Stripe Checkoutem
5. Karta: 4242 4242 4242 4242, jakákoliv budoucí expirace, libovolné 3místné CVC
6. Odešlete — Stripe přesměruje zpátky na cabintale stránku úspěšné platby
7. Zpátky v adminu: rezervace je teď ve vašem seznamu rezervací s viditelnou zaplacenou částkou; po otevření vidíte tabulku Plateb s transakcí

Co host prožije

Obrazovka úspěchu, dialog rezervace i samotný Stripe Checkout se zobrazují v jazyce widgetu. Když je widget v češtině, celé flow je v češtině (včetně UI Stripe). Podpora 34 jazyků.

Co vidí admin: konsolidovaná tabulka Plateb

Otevřete jakoukoliv rezervaci s online platbami. Sekce Platby teď ukazuje vše v jediné tabulce:

• Online transakce nahoře: částka, datum, typ (Karta), popis (Záloha / Celá částka / Doplatek), status badge (Zaplaceno / Čeká / Neúspěšné / Vypršelo)
• Klikněte na status badge pro zobrazení logu transakce (každá webhook událost, výsledek ověření podpisu, audit info)
• Ruční platby (převod, hotovost) níže — stejná tabulka, sloupec status nevyplněný
• Souhrnný řádek dole ukazuje Doplatit se skutečným zbytkem (celková částka mínus všechny platby — online a ruční dohromady)

Vybírání zbytku: platební odkazy

Když host zaplatil zálohu, ještě potřebujete vybrat zbytek. Sekce Plateb má dvě tlačítka vedle + Přidat platbu:

• Odkaz na platbu — vygeneruje /pay odkaz pro aktuální zbytek (celkem − online − ruční). Automaticky se přepočítá, pokud později přidáte ruční platbu. Pošlete mailem/SMSkou hostovi.
• Odkaz na zálohu — viditelné pouze pokud je ubytování na typu Záloha A neexistují žádné platby. Pro případ, kdy host opustil dialog a chcete mu poslat čerstvý odkaz.

Klikněte na kterékoliv; odkaz se automaticky zkopíruje do schránky (žádné popupy, žádný e-mail ve výchozím stavu — tlačítko se prostě přepne na "Odkaz na platbu zkopírován" se zaškrtávátkem na 3 sekundy). Vložte odkaz do odpovědi mailem.

Host odkaz otevře → uvidí stránku platby v jazyce svého původního widgetu → klikne na Zaplatit → jde na Stripe → zaplatí. Detail vaší rezervace se aktualizuje během vteřin.

Kombinace online a ručních plateb

Běžný scénář:

1. Host zaplatí 2 000 Kč zálohu online přes widget
2. Za 2 týdny zaplatí 4 000 Kč bankovním převodem — zaznamenáte to jako ruční platbu přes + Přidat platbu s typem Převod
3. Celkem rezervace: 6 800 Kč. Zbývá: 800 Kč
4. Kliknete na Odkaz na platbu — backend spočítá 6800 − 2000 − 4000 = 800. Odkaz vygenerován na 800 Kč.
5. Host zaplatí 800 přes odkaz. Rezervace je plně zaplacená.

Výpočet "zbývá" je vždy živý: backend počítá online (z webhooků Stripe) i ruční (z tabulky Plateb) pokaždé, když se odkaz otevře nebo aktivuje.

Odstranění čekající platby

Pokud jste vygenerovali platební odkaz omylem (špatná částka, špatný host atd.), otevřete rezervaci → tabulka Plateb → najděte řádek Pending → klikněte na ikonu Smazat. Potvrdí se malým dialogem, pak se transakce odstraní (odkaz okamžitě přestane fungovat).

Zaplacené platby smazat nelze (audit ochrana). Pro vrácení peněz hostovi použijte na stejném řádku akci Vrátit platbu — viz Vrácení a zrušení rezervací.

Vrácení z Přijímat platby zpět na Přijímat rezervace

Lze kdykoliv: otevřete ubytování, přepněte Chování widgetu zpět na Přijímat rezervace, uložte. Existující platby zůstávají — historické transakce a tabulka Plateb se stále zobrazují. Nové rezervace na widgetu jdou přes neplatící flow.

Řešení potíží

Související návody

• Platební brány (nastavení účtu) — Platební brány
• Nastavení Stripe (strana Stripe dashboardu) — Nastavení Stripe
• Vrácení a zrušení rezervací — Vrácení a zrušení rezervací
• Okamžitá vs. Na žádost — Okamžitá vs. žádaná rezervace
• Deadline rezervace — Uzávěrka rezervací