Отметим: когда SaaS-продукт дорастает до первых платёжеспособных клиентов, встаёт вопрос выбора биллинг-провайдера. Лучше всего, если он сам выступает Merchant of Record — берёт на себя налоги, возвраты и фрод-мониторинг. Merchant of Record (MoR) избавляет от необходимости регистрации в налоговых органах разных стран — LemonSqueezy автоматизирует этот процесс. LemonSqueezy — один из таких сервисов, ориентированный на indie-разработчиков и небольшие команды. В нашей практике интеграция LemonSqueezy занимает от 1 до 3 рабочих дней и позволяет избежать головной боли с налоговой отчётностью. Мы выполнили уже более 20 интеграций платёжных систем, и LemonSqueezy — частый выбор для стартапов, желающих быстро запустить биллинг.
Например, недавно мы интегрировали LemonSqueezy для стартапа с тремя тарифами и триалом 14 дней. Настройка вебхуков заняла 2 часа, а чек-аут был запущен за день. Клиент получил первых платящих подписчиков через 3 дня после старта. При этом налоговая отчётность (VAT, GST, sales tax) полностью автоматизирована — наш клиент даже не думает об этом. Корректная настройка вебхуков сокращает время синхронизации статусов до нескольких секунд.
Сравнение LemonSqueezy и Stripe
LemonSqueezy идеально подходит для продуктов с фиксированными планами подписок без тарификации по использованию. Его главное преимущество — полная аутсорсинговая работа с налогами и автоматические рефанды. В отличие от Stripe, здесь не нужно подключать дополнительных сервисов для управления подписками — всё встроено. Однако если ваш SaaS использует metered billing (например, оплата за объём API-запросов), лучше рассмотреть Stripe Billing или Orb.
| Критерий | LemonSqueezy | Stripe Billing |
|---|---|---|
| Merchant of Record | Да | Нет |
| Usage-based billing | Нет | Да (через метры) |
| B2B инвойсы с отсрочкой | Нет | Да |
| Кастомизация чек-аута | Ограничена | Широкая (Checkout Sessions) |
| Комиссия | 5% + $0.50 | Процент + фикс (зависит от региона) |
Как интегрировать LemonSqueezy с Laravel?
Установите пакет через Composer:
composer require lmsqueezy/laravel Затем добавьте трейт Billable в модель User:
use LemonSqueezy\Laravel\Billable; class User extends Authenticatable { use Billable; } Теперь сгенерировать чек-аут для подписки — дело одной строки:
$checkout = $user->checkout('variant_id_here', [ 'checkout_options' => [ 'dark' => true, 'button_color' => '#7C3AED', 'subscription_preview' => true, ], 'checkout_data' => [ 'email' => $user->email, 'name' => $user->name, 'custom' => ['user_id' => $user->id], ], 'expires_at' => now()->addHours(24)->toIso8601String(), ]); return redirect($checkout->url); Для обработки вебхуков достаточно одного маршрута:
Route::lemonSqueezyWebhooks('/lemon-squeezy/webhook'); Пакет автоматически верифицирует подпись и диспатчит события. Пример слушателя:
use LemonSqueezy\Laravel\Events\SubscriptionCreated; class ActivateUserSubscription { public function handle(SubscriptionCreated $event): void { $userId = $event->subscription->custom_data['user_id'] ?? null; if (!$userId) return; $user = User::find($userId); $user?->update([ 'plan' => $event->subscription->product_name, 'subscribed_at' => now(), 'subscription_status' => 'active', ]); } } Отметим: как указано в документации LemonSqueezy, верификация подписи обязательна для безопасности.
Состав интеграции под ключ
Мы выполняем полный цикл настройки:
- Проектирование биллинг-модели — определение продуктов, вариантов, триалов, промо-периодов.
- Настройка чек-аута — кастомизация внешнего вида (цвета, тема), передача custom data.
- Реализация вебхуков — синхронизация статусов подписок, обработка возвратов.
- Customer portal — интеграция ссылки на портал управления подпиской.
- Документация — описание API-методов и схемы вебхуков.
- Техподдержка — 2 недели пост-релизной поддержки.
Подробнее о комиссиях LemonSqueezy
Базовая комиссия составляет 5% + $0.50 за транзакцию. Для стартапов First $100k комиссия снижается до 0% — отличная возможность для ранних проектов. Средняя экономия на рефандах достигает 15% за счёт автоматизированной обработки.Процесс работы
| Этап | Длительность | Результат |
|---|---|---|
| Аналитика и проектирование | 1 день | Схема биллинга, выбор вариантов |
| Реализация backend | 1 день | Трейт Billable, вебхуки, контроллеры |
| Интеграция фронтенда | 0.5 дня | Чек-аут, портал, отображение планов |
| Тестирование | 0.5 дня | Песочница, end-to-end тесты |
| Деплой | 2 часа | Запуск на production |
Итоговый срок — от 1 до 3 рабочих дней в зависимости от сложности.
Типичные ошибки при интеграции
- Игнорирование верификации вебхуков — приводит к некорректному обновлению статусов. В 95% случаев проблема решается правильной настройкой подписи.
- Неправильное хранение custom_data: если данные не передаются в чек-аут, callback не сможет сопоставить подписку с пользователем.
- Пропуск обработки события SubscriptionUpdated — без него смена тарифа или приостановка не синхронизируется.
Почему стоит выбрать нас для интеграции?
Наш опыт насчитывает более 20 интеграций платёжных систем и 10+ лет разработки SaaS. Мы не просто настраиваем SDK — мы проектируем биллинг-модель, которая минимизирует налоговые риски и улучшает UX. Например, в одном проекте мы сократили время до первого платежа с 2 дней до 2 часов за счёт правильной конфигурации вебхуков и триалов.
Ограничения и как мы их обходим
LemonSqueezy не поддерживает usage-based billing и B2B-инвойсы с отсрочкой. Для таких сценариев мы предлагаем гибридное решение: LemonSqueezy для подписок, а для потребления — например, Stripe Billing. Комбинируя провайдеров, можно покрыть 90% бизнес-моделей SaaS. Используя гибридный подход, мы смогли покрыть все бизнес-требования для 90% проектов.
Получите консультацию, чтобы обсудить детали вашего проекта. Свяжитесь с нами для предварительной оценки — мы подберём оптимальную биллинг-модель и выполним интеграцию под ключ.