Управление на абонамента
Upgrade, downgrade, отмяна, обновяване на карта.
Upgrade на по-висок план
Извиква се през `/api/subscription/upgrade` с `{ configId, plan, billingCycle }`. Stripe изчислява prorated сума за остатъка от текущия месец, лимитът на съобщенията скача веднага. Следващото плащане е на пълната цена на новия план.
Ако картата изисква 3D Secure verification, response-ът връща `requiresAction` + `clientSecret` и UI-ят те води да я завършиш. Ако картата е отказана — отговор `CARD_DECLINED` (HTTP 402).
Downgrade — не се поддържа през API
Преминаване на по-нисък план не става през self-serve API — заявката се отказва. Причината е, че трябва да преценим имаш ли активни записвания, които биха надвишили новия лимит. Ако искаш да минеш на по-нисък план — пиши на <a href="mailto:ai@raiceptionist.com">ai@raiceptionist.com</a>.
Край на trial-а предсрочно
Ако искаш да минеш на пълен план веднага без да чакаш ден 3 — `/api/subscription/end-trial-now`. Stripe моментално таксува картата, лимитът скача от 250 на пълния на плана. Полезно когато си надминал 250 в първия ден и не искаш да чакаш.
Add-on: +500 съобщения за €19
Ако стигнеш лимита по средата на cycle-а — `/api/addon/purchase` създава Stripe one-time payment session за €19. Add-on-ът се добавя към `addon_replies_this_cycle` в базата и важи до края на текущия billing cycle. След плащане — redirect към `/dashboard?addon=success`.
Отмяна и обновяване на карта
За момента отмяна на абонамент и обновяване на карта стават през Stripe customer portal — пишеш на <a href="mailto:ai@raiceptionist.com">ai@raiceptionist.com</a> и ти пращаме линк към твоя portal. След отмяна ботът остава активен до края на текущия cycle, после статусът става „cancelled“. Self-serve customer portal в dashboard-а предстои.