Aby si vaši klienti mohli zakoupit přístup k vašemu AI Expertovi, potřebujete propojit vaši BuddyPro instanci s platebním systémem. To vám umožní automatizovat prodej, správu předplatných a přístupů.

K dispozici jsou dva platební systémy - české FAPI.cz a mezinárodní Stripe.

<aside> 👉

Rozhodněte se, který systém chcete používat a podle toho pokračujte buď krokem 19.1 nebo krokem 19.2.

</aside>

19.1 Integrace s mezinárodním platebním systémem Stripe

Pokud jste se rozhodli používat pro platby Stripe a ne FAPI, pokračujte podle tohoto návodu.

A) Propojte svůj Stripe účet s vaší BuddyPro instancí:

• Ve vaší BuddyPro instanci (v Telegram chatu s vaším AI Expertem) zadejte následující příkaz:

  /setupStripe
  

• Po úspěšném zadání tohoto příkazu vám vaše BuddyPro instance pošle odkaz. Klikněte na tento odkaz pro propojení vašeho Stripe účtu s Buddy Pro. Pokud ještě nemáte Stripe účet, budete si ho moci vytvořit.

B) Budou vygenerovány ukázkové produkty Buddy Pro

• Buddy pro vás vygeneruje 4 produkty, společně s ukázkovými cenami a platebními odkazy:
  • Měsíční předplatné: $149 / měsíc → 1000 zpráv měsíčně
  • Čtvrtletní předplatné: $399 / 3 měsíce → 1000 zpráv měsíčně
  • Roční předplatné: $1149 / rok → 1000 zpráv měsíčně
  • Extra zprávy: $69 → 500 dodatečných zpráv bez vypršení platnosti
    • ⚠️ DŮLEŽITÉ: Balíčky jsou pouze pro existující předplatitele, kterým dojdou měsíční zprávy. Nemohou být zakoupeny bez aktivního předplatného
• Vygenerované produkty najdete zde: https://dashboard.stripe.com/products
• Vygenerované platební odkazy najdete zde: https://dashboard.stripe.com/payment-links

C) Upravte ceny, měsíční limity zpráv a názvy produktů podle vašich potřeb. Nebo si vytvořte vlastní produkty a platební odkazy, pokud je potřebujete.

• Pokud chcete změnit cenu ukázkového produktu ve Stripe, vytvořte na něm nový Price objekt a poté vytvořte nový Payment Link, ve kterém vyberete tuto novou cenu.

• Vaše Buddy Pro produkty ve Stripe musí vždy obsahovat tato metadata pole, která je identifikují jako Buddy Pro produkt (již nastaveno pro ukázkové produkty):

  case: buddy_pro
  messages: 200 (jakékoliv číslo, záleží na vás)
  

  

• Hodnota 'messages' je měsíční limit zpráv v konverzaci (pro předplatné) nebo celkový počet zpráv, které uživatel získá (pro balíčky).

• Do limitu se započítávají jak zprávy od uživatele, tak odpovědi od Buddyho.

• Měsíční limit se uplatňuje i u ročních/čtvrtletních předplatných, aby se zabránilo vyčerpání příliš mnoha zpráv během jednoho měsíce.

• Zprávy zakoupené v balíčku nemají datum expirace.

• ‼️ Pokud vytváříte vlastní produkt pro balíček, musíte v nastavení platebního odkazu povolit Post-payment invoice

  • Jak povolit Post-payment invoice

D) Další příkazy pro správu plateb:

• /processStripePaymentManually:{paidInvoiceId}
  • Tento příkaz se používá pro ruční zpracování platby, pokud selže automatické zpracování přes webhook. Použijte ho pouze v případě, že vás k tomu vyzve vaše BuddyPro instance nebo podpora.

⚠️ VAROVÁNÍ K RUČNÍM ÚPRAVÁM VE STRIPE: Důrazně nedoporučujeme provádět ruční úpravy ve Stripe u automaticky vystavených (zejména opakujících se) faktur vašim klientům za služby BuddyPro (např. ruční změna fakturačního období, posunutí data splatnosti, úprava ceny na již vystavené faktuře atd. bez hlubokého porozumění toho, jak integrace funguje a jaké mohou být důsledky). Platforma BuddyPro nemusí být o těchto ručních změnách, které ve Stripe provádíte, informována a nemusí se s nimi správně synchronizovat, což může vést k problémům s aktivací nebo deaktivací přístupu pro klienta.

Často kladené otázky (FAQ) pro Stripe:

• Jak je předplatné nebo balíček Buddy Pro doručen uživateli, který si jej zakoupí?
  • Poté, co si uživatel zakoupí vaše předplatné nebo balíček, automaticky mu z našeho serveru zašleme aktivační e-mail s tlačítkem pro aktivaci jeho nákupu.
  • Pokud uživatel nakupuje přímo v Telegram chatu s vaším Buddy Pro, nákup může být aktivován automaticky bez nutnosti kliknout na aktivační e-mail.
• Co když chci nabízet více tarifů na jedné ze svých webových stránek (rozcestník)?
  • Pokud uživatel přichází na váš rozcestník z BuddyPro (např. po vyčerpání zkušební verze), je zásadní, aby byl parametr client_reference_id z původní URL přenesen do platebních odkazů Stripe vedoucích z rozcestníku k jednotlivým Stripe formulářům. Pro podrobnější informace o tomto technickém řešení viz krok 20.3 Důležité řešení pro více-tarifní ROZCESTNÍKY.