MkSaaS Payment Module

The payment module is the core of SaaS application monetization, directly impacting product profitability and user experience. The MkSaaS template builds a complete, secure, reliable, and easily extensible payment module based on Stripe, Creem, and Waffo Pancake, providing an out-of-the-box payment solution for your SaaS application.

This article provides a detailed introduction to the core features of the MkSaaS payment module, helping you fully understand this powerful payment ecosystem.

MkSaaS Payment Module

The MkSaaS payment module goes beyond simple payment integration — it's a complete, secure, and highly extensible payment solution:

• 💳 Out of the Box - Built-in complete payment functionality, no need to develop from scratch
• 🔒 Secure & Reliable - Built on Stripe, Creem, and Waffo with industry-standard security practices
• 🎯 Feature Complete - Covers the entire flow from subscription payments, one-time payments, to billing management
• 🔌 Easy to Extend - Modular design, can easily add new payment providers (Stripe, Creem, Waffo)
• 🎨 Beautiful UI - Provides professional payment interface components with excellent user experience
• 💰 Flexible Pricing - Supports multiple pricing plans, billing intervals, and one-time offers

Core Features Explained

1. Price Configuration

MkSaaS provides a flexible and powerful price configuration system, allowing you to easily manage different pricing plans and feature limitations.

Key Features:

• Multi-Plan Support - Supports multiple pricing models including free plan, Pro subscription (monthly/yearly), and lifetime plan
• Flexible Configuration - Can configure price, name, description, billing cycle, feature list, and limitations
• Feature Access - Define the product features available to each plan
• Plan Availability - Keep legacy plans resolvable while hiding them from new purchases

Configuration Example:

You can easily set up pricing plans in the website.tsx configuration file, including prices, billing cycles, feature lists, etc. All configurations are centralized in one location for easy management and maintenance.

You can learn how to configure the pricing table in the Price Configuration Documentation, including detailed settings for prices, names, descriptions, billing cycles, features, and limitations.

2. Subscription and One-Time Payments

MkSaaS supports both subscription payments and one-time payments, meeting the needs of different business scenarios.

Subscription Payments:

• Monthly/Annual Subscriptions - Supports flexible subscription cycles, users can choose monthly or annual subscriptions
• Auto-Renewal - Subscriptions automatically renew without manual user intervention
• Subscription Upgrade/Downgrade - Supports users upgrading or downgrading plans during subscription period
• Subscription Cancellation - Users can cancel subscriptions at any time, system properly handles remaining time

One-Time Payments:

• Lifetime Membership - Supports one-time payment for lifetime access
• Product Purchase - Supports one-time purchase of specific products or feature packages
• Promo Codes - Supports using promo codes for discounts
• Invoice Generation - Automatically generates invoices for one-time payments

Secure Payments:

Payment processes are handled through the active provider's secure hosted checkout, ensuring payment information security and compliance. MkSaaS supports Stripe, Creem, and Waffo checkout flows. Users can experience the complete subscription and one-time payment flow at the demo site.

3. Webhooks Integration

Webhooks are key components of the payment module, used to handle asynchronous payment events and subscription status updates. MkSaaS provides a complete Webhooks integration solution.

Core Features:

• Event Listening - Automatically listens to and processes payment events from Stripe, Creem, and Waffo
• Status Synchronization - Real-time synchronization of payment status and subscription status to database
• Automatic Processing - Automatically handles events like payment success, subscription creation, updates, cancellations, etc.
• Error Handling - Comprehensive error handling and retry mechanisms, ensuring event processing reliability
• Development Support - Supports Stripe CLI and provider-specific tools for local Webhook testing

Supported Events:

• checkout.session.completed - Checkout session completed
• customer.subscription.created - Subscription created
• customer.subscription.updated - Subscription updated
• customer.subscription.deleted - Subscription cancelled
• invoice.paid - Invoice paid successfully

The template has integrated provider-specific Webhook handlers to manage payment status. Stripe and Creem use their own event formats, while Waffo uses the raw request body and X-Waffo-Signature header at /api/webhooks/waffo; Waffo signature verification is handled by the official SDK and does not require a webhook secret environment variable.

4. Billing Management

MkSaaS integrates hosted billing portals from the active payment provider, providing users with complete self-service billing management functionality. Stripe and Creem provide their own portals, while Waffo uses its shared consumer portal.

Management Features:

• Payment Method Management - Users can add, update, or delete payment methods
• Subscription Management - Users can view current subscriptions, upgrade/downgrade plans, cancel subscriptions
• Billing History - Users can view complete payment history and invoice records
• Invoice Download - Users can download and view historical invoices
• Auto-Renewal Settings - Users can manage auto-renewal settings

User Experience:

Users can manage payment methods, view billing history, and perform billing operations through the billing page. When Waffo is active, the "Manage subscription" action opens Waffo's hosted consumer portal.

Technical Architecture Advantages

The MkSaaS payment module adopts a modular design with the following technical advantages:

1. Modular Architecture

The payment module uses a clear modular design:

• Payment Provider Abstraction - Supports different payment providers through unified interfaces
• Componentized UI - Provides reusable payment UI components
• Server Actions - Uses Next.js Server Actions to ensure payment operation security
• Type Safety - Complete TypeScript support, providing type hints and error checking

2. Security Guarantees

• Server-Side Processing - All sensitive operations are completed on the server side
• Webhook Verification - Strictly verifies Webhook signatures to prevent forged events
• Environment Variable Management - Uses environment variables to manage API keys, ensuring security
• PCI Compliance - Processes payment information through Stripe, Creem, or Waffo, so the application does not need to handle sensitive card data

3. Easy to Extend

• Provider Abstraction - Can easily add new payment providers
• Custom Components - UI components can be easily customized and extended
• Event Handling - Can easily add new event handling logic
• Flexible Configuration - Easily manage pricing plans through configuration files

Real-World Application Scenarios

The MkSaaS payment module is suitable for various SaaS application scenarios:

• Subscription-Based SaaS - Provides monthly/annual subscription services, such as project management tools, design software, etc.
• Product Sales - Supports one-time purchases for digital products, feature bundles, or access passes
• Hybrid Mode SaaS - Combines subscriptions and one-time purchases for products such as cloud storage or developer tools
• Lifetime Membership SaaS - Provides one-time purchase for lifetime access services, such as course platforms, tool software, etc.

Integration with Other Modules

The MkSaaS payment module seamlessly integrates with other modules:

• Authentication - Integrates with user system, automatically associates payments with user accounts
• AI Features - Connects payment status to product-specific AI access rules
• Email System - Automatically sends payment confirmations, invoices, and other email notifications
• Data Analytics - Provides payment data statistics, supports affiliate marketing tool integration

Summary

The MkSaaS payment module is a complete, secure, and extensible payment solution. It covers price configuration, subscription management, Webhooks integration, billing management, and provider-specific checkout flows.

Whether you're building a simple subscription-based SaaS or an enterprise-level application requiring complex billing models, the MkSaaS payment module can provide powerful support. By using these features, you can:

• Quick Launch - No need to start from scratch, directly use payment functionality to quickly build commercial applications
• Reduce Risk - Built on Stripe, Creem, and Waffo with industry-standard security practices
• Enhance Experience - Professional UI and smooth payment flow, improving user experience
• Flexible Extension - Modular design, easy to extend and maintain

Get Started:

• Check out the online demo to experience the complete payment functionality
• Read the Payment Documentation to learn detailed configuration and usage methods
• Visit the MkSaaS Template to learn more about features

---