Налаштування продажу підписок на веб-сайті SaaS-продукту часто перетворюється на набір милиць: тарифи зростають, користувачі скаржаться на збої, білінг ламається в найнесподіваніший момент. Ми вирішуємо це завдання під ключ, інтегруючи Stripe Billing, Paddle або Chargebee — без саморобних велосипедів. Наш досвід: понад 50 успішних проектів, понад 5 років у розробці білінгових систем. Такий підхід знижує churn rate на 10–15% і економить до 40 годин розробки на стартапі. Втрати через необроблені вебхуки можуть сягати $5,000 на місяць, тому автоматизація критична. Крім того, правильна інтеграція економить до $3,000–$5,000 щомісяця на ручному управлінні.
Як інтегрувати білінг?
Не реалізовуйте білінг самостійно — використовуйте Stripe Billing, Paddle або Chargebee. Вони беруть на себе: повторювані платежі, невдалі транзакції, dunning-механіки, податки за регіонами. Ми налаштовуємо повний цикл: від створення клієнта до обробки вебхуків. Як зазначається в документації Stripe, пробні періоди налаштовуються просто та гнучко.
Інтеграція з Stripe Billing
class SubscriptionService
{
public function createSubscription(User $user, string $priceId, array $options = []): Subscription
{
// Створюємо Stripe Customer якщо немає
if (!$user->stripe_customer_id) {
$customer = $this->stripe->customers->create([
'email' => $user->email,
'metadata' => ['user_id' => $user->id],
]);
$user->update(['stripe_customer_id' => $customer->id]);
}
$subscriptionData = [
'customer' => $user->stripe_customer_id,
'items' => [['price' => $priceId]],
'trial_period_days' => $options['trial_days'] ?? 0,
'payment_behavior' => 'default_incomplete',
'expand' => ['latest_invoice.payment_intent'],
];
$stripeSubscription = $this->stripe->subscriptions->create($subscriptionData);
return Subscription::create([
'user_id' => $user->id,
'stripe_subscription_id' => $stripeSubscription->id,
'plan' => $options['plan'],
'status' => $stripeSubscription->status,
'trial_ends_at' => $stripeSubscription->trial_end
? Carbon::createFromTimestamp($stripeSubscription->trial_end)
: null,
'current_period_end' => Carbon::createFromTimestamp($stripeSubscription->current_period_end),
]);
}
public function cancel(Subscription $subscription, bool $immediately = false): void
{
if ($immediately) {
$this->stripe->subscriptions->cancel($subscription->stripe_subscription_id);
} else {
// Скасування в кінці періоду
$this->stripe->subscriptions->update($subscription->stripe_subscription_id, [
'cancel_at_period_end' => true,
]);
}
}
}
Які тарифні плани можна налаштувати?
Підтримуються будь-які ліміти: кількість проектів, обсяг сховища, кількість API-викликів. Реалізуємо гнучку систему перевірки лімітів з апгрейдом та даунгрейдом. Для безлімітних планів використовуємо значення -1.
class PlanLimits
{
private array $limits = [
'free' => ['projects' => 1, 'storage_gb' => 1, 'api_calls_month' => 1000],
'starter' => ['projects' => 5, 'storage_gb' => 10, 'api_calls_month' => 10000],
'pro' => ['projects' => 20, 'storage_gb' => 50, 'api_calls_month' => 100000],
'enterprise' => ['projects' => -1, 'storage_gb' => -1, 'api_calls_month' => -1],
];
public function check(string $plan, string $feature, mixed $currentUsage): bool
{
$limit = $this->limits[$plan][$feature] ?? 0;
if ($limit === -1) return true;
return $currentUsage < $limit;
}
}
Webhook обробник подій білінгу
Route::post('/webhooks/stripe', function (Request $request) {
$event = \Stripe\Webhook::constructEvent(
$request->getContent(),
$request->header('Stripe-Signature'),
config('services.stripe.webhook_secret')
);
match($event->type) {
'customer.subscription.created' =>
HandleSubscriptionCreated::dispatch($event->data->object),
'customer.subscription.updated' =>
HandleSubscriptionUpdated::dispatch($event->data->object),
'customer.subscription.deleted' =>
HandleSubscriptionCancelled::dispatch($event->data->object),
'invoice.payment_failed' =>
HandlePaymentFailed::dispatch($event->data->object),
'invoice.payment_succeeded' =>
HandlePaymentSucceeded::dispatch($event->data->object),
default => null,
};
return response('ok');
});
Порівняння білінгових систем
| Система | Модель ціноутворення | Dunning | Податки | Пробний період |
|---|---|---|---|---|
| Stripe Billing | 2.9% + 30¢ за успішний платіж | Вбудований | Автоматичний | Так |
| Paddle | 5% + 50¢ за транзакцію | Вбудований | Автоматичний (включає ПДВ) | Так |
| Chargebee | від $49/міс + комісія | Вбудований | Автоматичний (дод. модулі) | Так |
Stripe Billing краще для стартапів — низька комісія, гнучке налаштування. Paddle зручний для продажу по всьому світу — сам розраховує податки. Chargebee підходить для складної білінгової логіки з кількома провайдерами.
Чому варто довірити білінг професіоналам?
Професійна інтеграція білінгу гарантує обробку всіх граничних випадків: скасування в середині пробного періоду, часткове відшкодування, перехід на тариф з пробним періодом. Самостійна реалізація часто призводить до витоку даних або некоректного обліку податків. Ми закладаємо обробку всіх подій вебхуків і тестуємо сценарії з аномальними даними.
Що робити при збоях в обробці платежів?
При збоях, таких як помилка карти або перевищення ліміту, Stripe Billing автоматично запускає dunning-процес з повторними спробами. Ми додатково реалізуємо сповіщення користувача через email та інтерфейс, призупиняємо доступ до успішного платежу. У разі невдалих виплат система надсилає адміністратору алерт, щоб вручну зв'язатися з клієнтом.
Типові помилки при інтеграції та їх рішення
| Проблема | Рішення |
|---|---|
| Не обробляються вебхуки при зміні тарифу | Налаштуйте події customer.subscription.updated та invoice.payment_succeeded |
| Пробний період не синхронізовано з доступом | Перевіряйте trial_ends_at і блокуйте доступ після закінчення |
| Ліміти не оновлюються після апгрейду | Реалізуйте перевірку лімітів у реальному часі через middleware |
| Помилки при скасуванні підписки | Використовуйте cancel_at_period_end для м'якого скасування |
Що входить в роботу з налаштування продажу SaaS-доступу
- Інтеграція з обраною білінговою системою (Stripe, Paddle, Chargebee).
- Налаштування тарифних планів з будь-якими лімітами.
- Реалізація пробного періоду, апгрейду, даунгрейду та скасування підписки.
- Обробка вебхуків та синхронізація з вашою базою даних.
- Документація по API та коду.
- Доступи до тестового та робочого середовища.
- Навчання вашої команди (до 2 годин).
- Підтримка протягом 3 місяців після запуску.
- Налаштування моніторингу статусів підписок та оповіщень про збої.
Процес роботи
- Аналітика — вивчаємо вашу модель монетизації, вимоги до тарифів, аудитуємо поточну інфраструктуру.
- Проектування — розробляємо архітектуру білінгу, обираємо систему, проектуємо схему БД.
- Реалізація — пишемо код інтеграції, налаштовуємо вебхуки, тестуємо критичні сценарії.
- Тестування — перевіряємо оплату, скасування, пробні періоди, обробку помилок.
- Деплой — розгортаємо на бойовому сервері, налаштовуємо моніторинг платежів.
Строки та як почати
SaaS-білінг з Stripe, тарифними планами та управлінням підписками: 14–20 робочих днів. Строк може варіюватися залежно від складності тарифної сітки та необхідності інтеграції з іншими сервісами.
Щоб обговорити ваш проект, зв'яжіться з нами — оцінимо завдання та запропонуємо рішення за 1 день. Гарантуємо прозорість та фіксовану вартість після затвердження ТЗ. Замовте консультацію — отримаєте комерційну пропозицію. Ми завжди раді допомогти вам з налаштуванням білінгу.