Як додати підписки через Stripe: тарифи, пробні періоди, webhooks і невдалі платежі

Щоб додати підписки через Stripe, створіть у Stripe Dashboard продукт із періодичною ціною, з вашого сервера надсилайте клієнтів до Stripe Checkout у режимі підписки, а webhook нехай повідомляє вашому застосунку, коли кожен платіж успішний, невдалий, змінюється або завершується. Зберігайте статус підписки для користувача та відкривайте доступ на основі цього статусу, а не сторінки успіху. Додайте кнопку Керувати оплатою, яка відкриває розміщений Stripe портал клієнта, щоб люди могли змінювати картки, перемикати тарифи й скасовувати підписку без створення цих екранів вами.

Цей посібник спирається на як додати оплату до застосунку, де описано разовий Checkout, тестовий режим і запуск у роботу. Тут ми зосереджуємося на тому, що відрізняє регулярні платежі. Відомості про Stripe взято з документації Stripe станом на вересень 2026 року.

Чому підписки складніші за разові платежі

Разовий платіж відбувається, поки клієнт перебуває у вашому застосунку. Підписка триває й після того, як клієнт пішов: щомісячні продовження, картки, що спливають, оновлення тарифу посеред циклу, скасування, які набувають чинності наприкінці періоду. Ваш застосунок дізнається про це лише через webhooks. Більшість помилок із підписками виникає через те, що перший платіж вважають усією історією.

Ваші варіанти

Для більшості застосунків Checkout плюс портал — правильний компроміс. Порівняйте провайдерів у Stripe проти Paddle проти Lemon Squeezy, якщо вас турбує обробка податків.

Спершу сплануйте ціни в Stripe

У Stripe продукт — це те, що ви продаєте («Pro plan»), а ціна — це те, як ви за нього стягуєте («$20 на місяць», «$200 на рік»). В одного продукту може бути кілька цін. Визначте:

• Які тарифи ви пропонуєте і що кожен відкриває у вашому застосунку
• Помісячно, щорічно чи обидва варіанти
• Чи пропонуєте ви пробний період і чи потрібна для нього картка наперед

Створіть продукти та ціни в тестовому режимі й збережіть їхні ID цін; ваш застосунок посилатиметься на них. Якщо ціни ще не визначено, прочитайте як визначити ціну SaaS-продукту і фриміум чи безкоштовний пробний період.

Життєвий цикл підписки, який треба обробляти

Огляд підписок Stripe перелічує статуси, які може мати підписка. Найважливіші для доступу:

Зберігайте статус у записі користувача або облікового запису й визначайте доступ на його основі. Оновлюйте його щоразу, коли надходить відповідний webhook.

Події webhook, які треба обробляти

Правила для обробників із документації Stripe щодо webhooks діють і тут: перевіряйте підпис за сирим тілом запиту, швидко повертайте 2xx, обробляйте дублікати та події не в порядку надходження й очікуйте повторів. У посібнику що таке webhook пояснено саму ідею, а в посібнику про оплату детально перелічено правила.

Покроково

1. Створіть продукти й ціни в тестовому режимі Stripe.
2. Додайте секрети: секретний ключ, ID цін і пізніше секрет підпису webhook. Ніколи не розміщуйте їх у коді інтерфейсу.
3. Сторінка тарифів: кнопка кожного плану викликає ваш сервер, який створює Checkout Session у режимі підписки для авторизованого користувача. Передайте ID користувача, щоб webhook міг пов'язати платіж з обліковим записом.
4. Кінцева точка webhook: перевіряйте підписи й обробляйте наведені вище події, оновлюючи один запис підписки для кожного користувача.
5. Обмежуйте функції залежно від збереженого статусу та тарифу, перевіряючи їх на сервері для кожної захищеної дії, а не лише приховані кнопки.
6. Портал клієнта: налаштуйте його в Stripe Dashboard (на які тарифи можна переходити, чи можна скасовувати), а потім додайте кнопку Керувати оплатою, яка створює сесію порталу на сервері та перенаправляє до нього.
7. Невдалі платежі: у налаштуваннях оплати Stripe оберіть поведінку повторів і те, що відбувається після останньої спроби. Показуйте банер у застосунку, поки статус past_due.
8. Протестуйте весь життєвий цикл, потім опублікуйте й зареєструйте бойовий webhook.

Промпти для вашого AI-конструктора

Додай регулярну оплату підписки через Stripe. Тарифи: Starter (ID ціни в STRIPE_PRICE_STARTER) і Pro (STRIPE_PRICE_PRO). Сторінка тарифів створює на сервері Checkout Session у режимі підписки, використовуючи STRIPE_SECRET_KEY, і додає ID авторизованого користувача. Збережи в користувача ID клієнта Stripe, ID підписки, тариф і статус. Ніколи не передавай секретний ключ у браузер.

Додай POST /api/stripe/webhook. Перевіряй підпис через STRIPE_WEBHOOK_SECRET, використовуючи сире тіло запиту. Обробляй checkout.session.completed, invoice.paid, invoice.payment_failed, customer.subscription.updated, customer.subscription.deleted і customer.subscription.trial_will_end. Записуй оброблені ID подій, щоб ігнорувати дублікати. Оновлюй статус користувача з об'єкта підписки, а не з порядку, у якому надходять події.

Обмеж функції Pro на сервері: дозволяй їх лише тоді, коли статус active або trialing і тариф Pro. Показуй банер «Оплата не пройшла, оновіть картку», коли статус past_due. Додай кнопку Manage billing, яка відкриває портал клієнта Stripe для цього користувача.

Оновлення, зниження тарифу та перерахунок

Коли клієнт перемикає тариф, документація Stripe каже, що зміна часто створює перерахунок (proration): нова ціна застосовується до решти поточного періоду оплати. Можна переглянути перерахунки або вимкнути їх. Якщо тарифи мають однаковий інтервал, дати оплати залишаються тими самими; перехід із місячного на річний переносить дату оплати на день перемикання. Дозвіл клієнтам змінювати тариф у порталі позбавляє вас від написання цієї логіки, але в налаштуваннях порталу потрібно визначити, які перемикання дозволені.

Чек-лист тестування

Використовуйте тестовий режим Stripe і тестові картки та пройдіть кожен стан:

• Нова підписка надає правильний тариф правильному користувачеві
• Закриття вкладки одразу після оплати все одно відкриває доступ (це доводить, що webhook працює)
• Відхилена картка під час реєстрації нічого не відкриває
• Продовження, яке не пройшло, переводить обліковий запис у past_due і показує банер
• Оновлення картки в порталі відновлює статус active
• Підвищення й зниження тарифу коректно змінюють функції
• Скасування наприкінці періоду зберігає доступ до кінцевої дати, а потім його видаляє
• Користувачі пробного періоду отримують доступ, отримують нагадування і коректно переходять на платний тариф або втрачають доступ
• Надсилання того самого події webhook двічі нічого не змінює

Тестові годинники Stripe дають змогу симулювати плин часу, тож можна тестувати продовження без очікування місяця. Перевірте поточну документацію Stripe щодо тестування, щоб дізнатися, як їх використовувати.

Типові помилки

• Надання доступу на сторінці успіху. Клієнти можуть заплатити й ніколи її не побачити. Використовуйте webhook.
• Обробка лише першого платежу. Продовження, невдачі та скасування надходять пізніше, як події.
• Перевірка статусу тарифу лише в інтерфейсі. До вашого API може звертатися будь-хто.
• Одна людина, випадково багато підписок. Перевіряйте наявну підписку перед створенням нової Checkout Session або відправляйте наявних клієнтів до порталу.
• Відкликання доступу після першого невдалого продовження. Картки не проходять із банальних причин. Короткий пільговий період із чітким банером утримує клієнтів.
• Забута бойова webhook-точка. У тестових і бойових кінцевих точок різні секрети підпису.
• Ігнорування податків і повернень. Визначте політику повернень і перевірте податкові зобов'язання з бухгалтером до запуску.

Підписки на Mythex

Застосунки, які ви створюєте на Mythex, використовують ваш власний обліковий запис Stripe і ключі; для вашого застосунку немає підключення Stripe в один клік. Додайте тестові ключі й ID цін як секрети проєкту, використовуйте промпти, подібні до наведених вище, і тестуйте тестовими картками Stripe у Preview. Webhooks потребують публічної URL-адреси вашого застосунку, тож публікуйте застосунок до реєстрації кінцевої точки в Stripe, а після переходу на бойові ключі опублікуйте знову, щоб бойовий застосунок їх підхопив. Див. Прийом платежів через Stripe і Обробка webhooks у вашому бекенді. Для ширшого продукту як створити MVP SaaS пояснює, що будувати навколо оплати.

Запитання