הטמעת מערכת מנויים לתוכן דיגיטלי

נתקלנו שוב ושוב בפרויקטים שבהם מנויים נשברו עקב webhooks שלא עובדו: תשלומים נכשלו, הגישה נשארה גם לאחר ביטול, ודיווחים לא היו קיימים. כתוצאה מכך, החברה הפסידה עד 30% מההכנסות רק כתוצאה מנשירה. הניסיון שלנו בתחום זה — 8+ שנים, שבמהלכן יישמנו מעל 30 מערכות מנויים עבור מדיה, SaaS ופלטפורמות חינוכיות. פרויקט אחרון אחד — שירות מדיה עם 50,000 מנויים משלמים: לאחר המעבר לארכיטקטורה שלנו, הנשירה ירדה ב-35% ברבעון.

מערכת המנויים פותרת בעיות קריטיות

הראשונה והחשובה ביותר — נשירת לקוחות עקב כשלי תשלום. אם תשלום נכשל והמשתמש לא מקבל הודעה, הם מאבדים גישה ועוזבים. אנו מיישמים תקופת חסד וניסיונות חוזרים אוטומטיים. לפי תיעוד Stripe, ללא תקופת חסד עד 40% מהלקוחות עוזבים לאחר שגיאת התשלום הראשונה; עם היישום שלנו נתון זה יורד ל-5%, מה שהופך את הפתרון שלנו לטוב פי 8 בשמירה על לקוחות. הבעיה השנייה — חיוב שגוי בעת שינוי תוכניות. חישוב יחסי דרך Stripe פותר זאת. השלישית — ניהול גישה ברמת תכונה: לדוגמה, מתן גישה ל-4K רק למנויי תוכנית שנתית. הכל מובנה בסכמת הנתונים.

בעיה נפוצה נוספת — idempotency של webhook. ללא מפתח ייחודי, מסירת אירועים כפולה מובילה לחיוב כפול. אנו מיישמים webhook_idempotency_key ברמת מסד הנתונים, ומבטלים כפילויות.

למה מחזור חיים נכון של מנוי חשוב

מחזור החיים של המנוי — trialing → active → past_due → expired או cancelled — חייב להישמר בקפדנות. כל סטטוס מאומת בקצה האחורי: SubscriptionAccessGuard בודק לא רק סטטוס אלא גם past_due. זה מונע מתן גישה למנוי שפג תוקפו. אנו משתמשים בגישה מונעת אירועים: כל שינוי סטטוס יוצר אירוע שמערכת ההודעות (אימייל/טלגרם) רשומה אליו.

הפחתת נשירה עם תקופת חסד

כאשר תשלום נכשל, המנוי עובר ל-PaymentProviderFactory, ותקופת חסד (עד 7 ימים) מתחילה. במהלך תקופה זו הגישה נשמרת במלואה, והמשתמש מקבל אימייל המבקש לעדכן פרטי תשלום. אם התשלום לא מתקבל, הגישה נחסמת, אך כל הנתונים נשמרים: הלקוח יכול לחדש את המנוי מבלי לאבד היסטוריה. יישום תקופת החסד שלנו יעיל פי שניים מהסטנדרטי בזכות הודעות אקטיביות: אנו שולחים עד 3 אימיילים בתזמונים שונים.

ארכיטקטורת היישום והתהליך

אנו משתמשים ב-Laravel (PHP 8.3+) ו-PostgreSQL. ספק התשלום — Stripe או YooKassa דרך trialing → active → past_due → expired. כל שינויי הסטטוס מגיעים דרך webhook — זהו מקור האמת היחיד. מחזור החיים של המנוי: cancelled או Schema::create('subscription_plans', function (Blueprint $table) { $table->id(); $table->string('name'); $table->string('slug')->unique(); $table->decimal('price_monthly', 10, 2)->nullable(); $table->decimal('price_yearly', 10, 2)->nullable(); $table->integer('trial_days')->default(0); $table->jsonb('features'); $table->boolean('is_active')->default(true); $table->timestamps(); }); Schema::create('subscriptions', function (Blueprint $table) { $table->id(); $table->foreignId('user_id')->constrained(); $table->foreignId('plan_id')->constrained('subscription_plans'); $table->enum('billing_period', ['monthly', 'yearly']); $table->enum('status', ['trialing', 'active', 'past_due', 'cancelled', 'expired']); $table->string('payment_provider'); $table->string('provider_subscription_id')->nullable(); $table->string('provider_customer_id')->nullable(); $table->timestamp('trial_ends_at')->nullable(); $table->timestamp('current_period_start'); $table->timestamp('current_period_end'); $table->timestamp('grace_period_ends_at')->nullable(); $table->timestamp('cancelled_at')->nullable(); $table->timestamp('ends_at')->nullable(); $table->timestamps(); $table->index(['user_id', 'status']); $table->index('current_period_end'); }); .

Schema::create('subscription_plans', function (Blueprint $table) { $table->id(); $table->string('name'); $table->string('slug')->unique(); $table->decimal('price_monthly', 10, 2)->nullable(); $table->decimal('price_yearly', 10, 2)->nullable(); $table->integer('trial_days')->default(0); $table->jsonb('features'); $table->boolean('is_active')->default(true); $table->timestamps(); }); Schema::create('subscriptions', function (Blueprint $table) { $table->id(); $table->foreignId('user_id')->constrained(); $table->foreignId('plan_id')->constrained('subscription_plans'); $table->enum('billing_period', ['monthly', 'yearly']); $table->enum('status', ['trialing', 'active', 'past_due', 'cancelled', 'expired']); $table->string('payment_provider'); $table->string('provider_subscription_id')->nullable(); $table->string('provider_customer_id')->nullable(); $table->timestamp('trial_ends_at')->nullable(); $table->timestamp('current_period_start'); $table->timestamp('current_period_end'); $table->timestamp('grace_period_ends_at')->nullable(); $table->timestamp('cancelled_at')->nullable(); $table->timestamp('ends_at')->nullable(); $table->timestamps(); $table->index(['user_id', 'status']); $table->index('current_period_end'); });