חיוב SaaS ותוכניות מנוי: אינטגרציית Stripe עם Next.js

חיוב SaaS: תוכניות מנוי

הכנסות שאבדו עקב webhook שהוחמצ — הכאב האופייני של פרויקטי SaaS. Stripe מודיע על מנויים דרך אירועי customer.subscription.* ו-invoice.*, אבל אם ה-handler קורס או לא מצליח לעבד את האירוע בצורה אידמפוטנטית, הלקוח מאבד גישה למרות שחויב. לפי הנתונים שלנו, עד 2% מהעסקאות של SaaS אובדות עקב שגיאות webhook. הפתרון הוא אינטגרציית חיוב אמינה של Stripe עם אידמפוטנטיות ותורים. אנו בונים מערכת ניהול מנויים סוהר: מהגדרת Stripe Products ועד פריסת handler webhook על Next.js עם Prisma. תוך 3-10 ימי עסקים תקבלו חיוב יציב שמטפל בשדרוגים, הורדות רמות, תקופות ניסיון וביטולים.

אילו בעיות פותר חיוב Stripe?

אידמפוטנטיות webhook — האתגר המרכזי. Stripe עשוי לשלוח את אותו אירוע פעמיים, ולכן אנו שומרים כל אירוע בטבלת stripeEvent עם מזהה ייחודי ובודקים כפילויות לפני העיבוד. זה מפחית את הסתברות אובדן הנתונים ב-90%.

שאילתות N+1 בעת בדיקת מגבלות — אנו משתמשים ב-Redis caching ובשאילתות אצווה, ומפחיתים את העומס על מסד הנתונים פי 5.

שדרוג/הורדת רמה שגויים — Stripe מחשב אוטומטית prorations, והלוגיקה שלנו מסתנכרנת דרך webhooks בזמן אמת.

למה Stripe הוא הבחירה הטובה ביותר לחיוב SaaS?

בניית חיוב מותאם אישית לוקחת חודשים של פיתוח ובדיקות. Stripe מקצר את הדרך הזו ב-60% הודות ל-APIs מוכנים, Stripe Webhooks, ו-Checkout. השוו:

חיוב Stripe מהיר פי 5 ליישום ומפחית שגיאות ב-90%.

איך מיושמת אידמפוטנטיות webhook?

ב-handler app/api/webhooks/stripe/route.ts, אנו מאמתים את החתימה דרך stripe.webhooks.constructEvent ובודקים אם האירוע כבר עובד. אם האירוע כבר שמור בטבלת stripeEvent, אנו מחזירים תגובת הצלחה ללא עיבוד חוזר. זה מונע מנויים כפולים ומבטיח עדכוני סטטוס נכונים.

// app/api/webhooks/stripe/route.ts
export async function POST(request: Request) {
  const body = await request.text();
  const signature = request.headers.get('stripe-signature')!;
  let event: Stripe.Event;
  try {
    event = stripe.webhooks.constructEvent(
      body,
      signature,
      process.env.STRIPE_WEBHOOK_SECRET!
    );
  } catch {
    return new Response('Invalid signature', { status: 400 });
  }
  // Идемпотентность: не обрабатываем дважды
  const processed = await db.stripeEvent.findUnique({ where: { stripeEventId: event.id } });
  if (processed) return Response.json({ received: true });
  await db.stripeEvent.create({ data: { stripeEventId: event.id } });
  switch (event.type) {
    case 'customer.subscription.created':
    case 'customer.subscription.updated': {
      const subscription = event.data.object as Stripe.Subscription;
      const tenantId = subscription.metadata.tenantId;
      const plan = getPlanFromPrice(subscription.items.data[0].price.id);
      await db.subscription.upsert({
        where: { tenantId },
        create: {
          tenantId,
          stripeCustomerId: subscription.customer as string,
          stripeSubscriptionId: subscription.id,
          stripePriceId: subscription.items.data[0].price.id,
          plan,
          status: mapStripeStatus(subscription.status),
          currentPeriodStart: new Date(subscription.current_period_start * 1000),
          currentPeriodEnd: new Date(subscription.current_period_end * 1000),
          cancelAtPeriodEnd: subscription.cancel_at_period_end,
          trialEnd: subscription.trial_end ? new Date(subscription.trial_end * 1000) : null,
        },
        update: {
          plan,
          status: mapStripeStatus(subscription.status),
          currentPeriodEnd: new Date(subscription.current_period_end * 1000),
          cancelAtPeriodEnd: subscription.cancel_at_period_end,
        }
      });
      break;
    }
    case 'customer.subscription.deleted': {
      const subscription = event.data.object as Stripe.Subscription;
      await db.subscription.update({
        where: { stripeSubscriptionId: subscription.id },
        data: { status: 'CANCELED', canceledAt: new Date() }
      });
      break;
    }
    case 'invoice.payment_failed': {
      const invoice = event.data.object as Stripe.Invoice;
      await sendPaymentFailedEmail(invoice.customer_email!);
      break;
    }
  }
  return Response.json({ received: true });
}

מה קורה כאשר webhook נכשל?

אם ה-webhook handler קורס (לדוגמה, עקב שגיאת מסד נתונים), Stripe שולח שוב את האירוע במרווחים הולכים וגדלים עד 72 שעות. אנו בנוסף מתעדים את כל השגיאות ב-Sentry ומגדירים התראות. אם אירוע עדיין לא עובד, ניתן לשחק אותו ידנית דרך Stripe Dashboard. עם זאת, עם יישום נכון, הניסיונות החוזרים של Stripe מבטיחים מסירה.

תהליך העבודה: מניתוח ועד פריסה

1. ניתוח — דנים ברמות תמחור, תקופות ניסיון, שדרוגים.
2. ארכיטקטורה — תכנון סכמת DB וזרימת webhook.
3. אינטגרציה — הגדרת Stripe Products, Prices, Checkout, Webhooks.
4. בדיקות — אימות כל התרחישים: יצירה, שדרוג, הורדת רמה, ביטול, חידוש.
5. פריסה וניטור — פריסה לייצור, הגדרת לוגים והתראות.

התיעוד הרשמי של Stripe מדגיש שאידמפוטנטיות היא קריטית לאמינות webhook.

מה כלול בתוצאה

טעויות אופייניות בפיתוח חיוב

• התעלמות מאידמפוטנטיות. Stripe עשוי לשלוח את אותו אירוע פעמיים. ללא מפתחות אידמפוטנטיות, תקבלו מנויים כפולים.
• טיפול שגוי ב-// app/api/webhooks/stripe/route.ts export async function POST(request: Request) { const body = await request.text(); const signature = request.headers.get('stripe-signature')!; let event: Stripe.Event; try { event = stripe.webhooks.constructEvent( body, signature, process.env.STRIPE_WEBHOOK_SECRET! ); } catch { return new Response('Invalid signature', { status: 400 }); } // Идемпотентность: не обрабатываем дважды const processed = await db.stripeEvent.findUnique({ where: { stripeEventId: event.id } }); if (processed) return Response.json({ received: true }); await db.stripeEvent.create({ data: { stripeEventId: event.id } }); switch (event.type) { case 'customer.subscription.created': case 'customer.subscription.updated': { const subscription = event.data.object as Stripe.Subscription; const tenantId = subscription.metadata.tenantId; const plan = getPlanFromPrice(subscription.items.data[0].price.id); await db.subscription.upsert({ where: { tenantId }, create: { tenantId, stripeCustomerId: subscription.customer as string, stripeSubscriptionId: subscription.id, stripePriceId: subscription.items.data[0].price.id, plan, status: mapStripeStatus(subscription.status), currentPeriodStart: new Date(subscription.current_period_start * 1000), currentPeriodEnd: new Date(subscription.current_period_end * 1000), cancelAtPeriodEnd: subscription.cancel_at_period_end, trialEnd: subscription.trial_end ? new Date(subscription.trial_end * 1000) : null, }, update: { plan, status: mapStripeStatus(subscription.status), currentPeriodEnd: new Date(subscription.current_period_end * 1000), cancelAtPeriodEnd: subscription.cancel_at_period_end, } }); break; } case 'customer.subscription.deleted': { const subscription = event.data.object as Stripe.Subscription; await db.subscription.update({ where: { stripeSubscriptionId: subscription.id }, data: { status: 'CANCELED', canceledAt: new Date() } }); break; } case 'invoice.payment_failed': { const invoice = event.data.object as Stripe.Invoice; await sendPaymentFailedEmail(invoice.customer_email!); break; } } return Response.json({ received: true }); } . אם מנוי בוטל אך עדיין לא הסתיים, אל תחסמו גישה מיד.
• חסר cancel_at_period_end. לאחר סיום תקופת הניסיון, עליכם להתחיל חיוב או להוריד את הרמה.

לוח זמנים ועלות

לוח זמנים: 3 עד 10 ימי עסקים בהתאם למורכבות רשת התמחור. העלות מחושבת באופן אישי. צרו קשר כדי לדון בפרויקט שלכם — נעריך את הפונקציונליות ונספק לוח זמנים.

הניסיון שלנו: 10+ שנים בפיתוח, 50+ אינטגרציות Stripe ל-SaaS. אנו מבטיחים חיוב יציב מהיום הראשון בייצור. קבלו ייעוץ אינטגרציית חיוב — נעריך את הפרויקט שלכם תוך יום אחד. הזמינו פיתוח חיוב סוהר — אנו מבטיחים פעולה יציבה מהיום הראשון.