Přehled Produktů

Po dokončení tohoto návodu budete vědět, co Produkty jsou, jak vytvořit první produkt, jak nastavit a vložit tlačítko Checkout na web a jak po platbě fungují objednávky, e-maily, vrácení peněz a dialog pro disponování s vouchery. Pro voucherovou problematiku (ruční vystavení, platnost, uplatnění) viz Vouchery.

Co jsou Produkty

Produkty jsou prodejné položky s cenou v jedné měně. Každé tlačítko Checkout prodává jeden produkt v nastavitelném množství, placeno online přes Stripe. Po zaplacení se objednávka objeví ve správě a vám i hostovi přijde e-mail.

Dnes jsou k dispozici dva typy produktů:

• Produkt — fyzické nebo digitální zboží. Standardní jednorázový prodej.
• Voucher — generuje jeden zákaznický kód na zakoupenou jednotku. Formát kódu [PREFIX-]XXXX-XXXX. Viz Vouchery pro voucherové chování.

Každý produkt běží v jednom ze dvou cenových režimů:

• Jedna cena — jedna pevná cena za kus. Host zvolí množství, celkem = cena × množství. Vhodné pro položku s jednotnou cenou (láhev za 1 800 Kč, voucher na 500 Kč).
• Možnosti — více řádků, každý s vlastním názvem, popisem a cenou. Host zvolí množství na řádek (např. Dospělý — 1 000 Kč ×2, Dítě — 500 Kč ×1) a součet se sčítá. Vhodné pro varianty / tiery — a pro voucherové produkty, které prodávají několik nominálních hodnot z jednoho tlačítka.

Krok 1: Vytvoření prvního produktu

V postranní nabídce → Produkty → klikněte na + nahoře na liště. Otevře se formulář:

Klikněte Uložit. Otevře se detail produktu — jedna stránka se sekcemi pro základní informace, platby, výchozí množství, notifikace a (pro vouchery) nastavení vystavovaných kódů.

Platby mají vlastní sekci. Pokud zatím nemáte bránu, nápověda vás odkáže na Nastavení → Platby — veřejný checkout se nezveřejní, dokud bránu nepřidáte, ale zbytek produktu můžete dokončit.

Krok 2: Tlačítko Checkout

Produkt je jen data — hosté ho kupují přes tlačítko Checkout. Na detailu produktu otevřete Checkouts v postranní nabídce a klikněte Přidat checkout.

Stránka detailu má tři sekce — Identita, Vzhled, Vložení.

Nastavení tlačítka:

Limity množství (min ≤ default ≤ max) se nastavují na produktu, ne na checkoutu — jedna sada platí pro všechna tlačítka navázaná na produkt.

Uložte. Sekce Vložení odhalí kód (dvě varianty níže) a odkaz Zobrazit veřejný náhled, který otevře /checkout/{token} v novém panelu.

Krok 3: Vložení tlačítka na váš web

V sekci Vložení detailu checkoutu zvolte Typ vložení. Snippet vpravo se aktualizuje podle volby.

Tlačítko (doporučeno) — předstylované HTML tlačítko s vašimi vzhledovými volbami zapečenými jako inline styly. Vložte do webu a doupravte inline style podle potřeby. Nejlepší kontrola designu.

<button data-cabintale-checkout="{token}" style="…">Objednat</button>
<script src="https://admin.cabintale.com/widget-embed.js" async></script>

Skript (pokročilé) — tlačítko vyrenderujeme za vás v iframe. Žádný styling, ale ztrácíte CSS kontrolu nad tlačítkem.

<cabintale-root data-checkout="{token}"></cabintale-root>
<script src="https://admin.cabintale.com/widget-embed.js" async></script>

Iframe (jednoduché) — vložte naši checkout stránku do holého iframe. Vyžaduje doprovodný widget-dialog.js na stejné stránce, aby dialogové overlay fungovaly přes celý viewport.

<iframe src="https://admin.cabintale.com/checkout/{token}" style="border:none; width:100%; min-height:80px"></iframe>
<script src="https://admin.cabintale.com/widget-dialog.js" async></script>

Všechny tři otevírají dialog jako celoobrazovkový overlay přes postMessage. Origin je validován; více Checkout tlačítek na jedné stránce se navzájem neruší.

Krok 4: Jak dialog funguje pro hosta

Po kliknutí na tlačítko se otevře 4krokový dialog:

1. Množství
   • Produkty s jednou cenou: jeden krokový volič v rámci min / max. Součet se aktualizuje živě.
   • Produkty s možnostmi: jeden krokový volič na řádek možnosti. Celkem = Σ (cena × množství). Aspoň jeden řádek musí být > 0, aby šlo pokračovat.
2. Vlastní pole — co jste nastavili v editoru (e-mail, adresa, dárková zpráva). Povinná pole se validují klient- i server-side.
3. Shrnutí — souhrn objednávky s celkem za řádek (u možností) a celkovým součtem.
4. Zaplatit — otevře Stripe Checkout v jazyce widgetu. Po platbě se Stripe vrátí a dialog potvrdí Objednávka přijata.

U voucherových produktů se v kroku 4 zobrazí vygenerované kódy. Kódy zároveň odejdou hostovi v e-mailu — viz další krok.

Krok 5: Příjem objednávek

Objednávky padají do Produkty → {produkt} → Objednávky se stavem Zaplaceno. Seznam objednávek sdílí vizuální rytmus s Rezervacemi — jméno + cena + datum + referenční chip + stavový pill.

• Detail objednávky ukazuje množství, celkem, stav platby, údaje hosta a všechna vlastní pole.
• Tabulka Platby zobrazuje Stripe transakci (jeden řádek na pokus). Na úspěšných řádcích je ikona pro vrácení.
• Panel Vystavené vouchery (jen u voucherových objednávek) ukazuje každý vygenerovaný kód se stavem + platností + řádkovým zrušením.
• Vám přijde NewOrderNotificationMail — upozornění, že přišla platba.
• Hostovi přijde OrderConfirmationMail — účtenka s názvem produktu, jednotlivými položkami (u režimu možností), celkem, vlastními poli a (u voucherů) vystavenými kódy zobrazenými jako čárkované rámečky s kódem + hodnotou + volitelnou platností.

Oba e-maily se odesílají v jazyce zachyceném na objednávce (widget_language se uloží při vytvoření, pozdější změna nepřepíše historii).

Krok 6: Odeslat platební odkaz ručně

Pokud platba selhala nebo zákazník chce zaplatit mimo vložené tlačítko (chat / e-mail / telefon), vygenerujte platební odkaz z detailu objednávky:

1. Otevřete sekci Platby objednávky.
2. Klikněte Odeslat platební odkaz. cabintale vytvoří čekající Stripe Checkout relaci a zkopíruje URL do schránky.
3. Pošlete URL hostovi. Zaplatí na /pay/{token}.
4. Po úspěchu se objednávka překlopí na Zaplaceno a odejdou potvrzovací e-maily.

Tlačítko je skryté, pokud produkt nemá nastavenou bránu nebo je objednávka už zaplacená.

Krok 7: Vrácení peněz + disponování s vouchery

Refundy fungují stejně jako u rezervací. Z tabulky Platby v detailu objednávky:

1. Klikněte na ikonu refundu u úspěšné transakce.
2. Zadejte částku (plnou nebo částečnou) a klikněte Zahájit.
3. cabintale pošle 6místný potvrzovací kód na váš administrátorský e-mail — zadejte do dialogu.
4. Stripe zpracuje refund; v Platbách se objeví záporný řádek.

Pokud má objednávka zaplacené vouchery, objeví se navazující dialog: Zrušit všechny vouchery nebo Ponechat vouchery.

• Zrušit všechny — všechny zaplacené vouchery na objednávce se překlopí na cancelled (držitel je už neuplatní).
• Ponechat — vouchery zůstanou platné; aktualizuje se jen stav objednávky.

Stejný dialog se objeví při zrušení objednávky (změnit stav → Zrušená a uložit) nebo při smazání. Při Smazat + Ponechat je objednávka tvrdě smazána; product_order_id voucheru se nastaví na NULL, ale kódy zůstávají platné.

Voucherové detaily viz Vouchery.

Ruční vystavení voucherů

Pro voucherové produkty můžete vystavovat kódy bez online platby (dárkové kódy, prodej naživo). Viz Vouchery → "Ruční vystavení voucherů".

Aktuální omezení

• Žádný košík / vícepoložkový checkout. Jedno tlačítko = jeden produkt (možnosti uvnitř něj se počítají jako jedna objednávka). Vícepoložkové katalogy jsou v plánu.
• Žádné sledování skladu. Vyprodáno je ruční přepínač — překlopte Dostupný v hlavičce produktu pro skrytí tlačítka.
• Zatím bez obrázků produktů — přijde se sdíleným úložištěm médií.
• Žádný režim "na žádost". Produkty jsou jen pro platby online.

Související návody

• Nastavení platební brány — Platební brány
• Vouchery (vystavení, ruční tvorba, platnost, uplatnění) — Vouchery
• Refundy a storna (stejný postup jako u objednávek) — Vrácení a zrušení rezervací
• Vlastní rezervační formulář (stejný editor jako pro pole Checkoutu) — Vlastní rezervační formulář
• E-mailová oznámení — E-mailová oznámení