Skip to main content

Stripe Gateway

Stripe payment gateway integration for SaaS subscriptions. This module enables accepting payments via Stripe for tenant subscription billing with support for cards and various payment methods.

Features​

  • Stripe Payments: Accept payments via Stripe's payment platform
  • Subscription Management: Full subscription lifecycle management with Stripe Billing
  • Webhook Handling: Automatic event processing via Stripe webhooks
  • Card Payments: Accept credit and debit card payments
  • Multiple Payment Methods: Support for bank transfers, wallets, and local payment methods
  • Invoice Generation: Automatic invoice generation for all payments
  • Proration Support: Automatic proration for plan changes

Requirements​

  • Open Core Business Suite (Base System)
  • MultiTenancyCore module (required)
  • Stripe account
  • Stripe API keys (Publishable and Secret keys)

Installation​

  1. Download the Stripe Gateway module package
  2. Extract the module to Modules/StripeGateway
  3. Run the installation command:
php artisan module:enable StripeGateway
php artisan migrate
  1. Configure your Stripe API keys
  2. Clear the application cache:
php artisan optimize:clear

Usage​

Configuration​

Navigate to Settings > Payment Gateways > Stripe to configure:

  1. Enter your Stripe Publishable Key
  2. Enter your Stripe Secret Key
  3. Enter your Webhook Signing Secret
  4. Save settings

Webhook Setup​

Configure webhooks in your Stripe Dashboard:

  1. Go to Stripe Dashboard > Developers > Webhooks
  2. Add endpoint URL: https://yourdomain.com/api/webhooks/stripe
  3. Select events:
    • checkout.session.completed
    • customer.subscription.created
    • customer.subscription.updated
    • customer.subscription.deleted
    • invoice.paid
    • invoice.payment_failed

Subscription Management​

Stripe subscriptions are fully integrated:

  • Tenants can subscribe using the Stripe Checkout
  • Subscription changes are handled with proration
  • Failed payments trigger dunning emails
  • Cancelled subscriptions update tenant access

Card Payments​

Accept card payments securely:

  • PCI-compliant card handling via Stripe Elements
  • Support for 3D Secure authentication
  • Saved cards for future payments
  • Multiple cards per customer

Payment History​

View all Stripe transactions at Central Admin > Payments:

  • Filter by tenant, date, or status
  • View detailed transaction information
  • Download invoices
  • Process refunds

Configuration​

Access module settings at Settings > Stripe Gateway to configure:

  • API keys (Publishable and Secret)
  • Webhook signing secret
  • Default currency
  • Tax settings
  • Invoice customization
  • Payment method types to accept
Last updated on