Description
Multi-Site Stripe Checkout Routing
Stripe Router Gateway for WHMCS
Stripe Router Gateway for WHMCS is a professional payment routing and synchronization solution that connects a primary WHMCS installation with a dedicated processor WHMCS installation.
The module supports Stripe Checkout, invoice synchronization, saved-card management, account-wide autopay, automatic renewal capture, and secure communication between connected WHMCS sites.
Two-Site WHMCS Payment Architecture
The module is designed for businesses that operate separate WHMCS environments for customer-facing billing and payment processing. Customers continue using the primary WHMCS site, while checkout, payment handling, and Stripe communication are processed through the connected processor WHMCS site.
Core Features
- Stripe Checkout Support: Route invoice payments through secure Stripe-hosted checkout pages.
- Two-WHMCS Integration: Connect a primary WHMCS site with a dedicated processor WHMCS installation.
- Invoice Synchronization: Sync invoices, payment status, and mapped processor invoices between both WHMCS sites.
- Client and Service Sync: Keep customer and service records connected between the main and processor environments.
- Product and Currency Mapping: Map products and currencies between both WHMCS installations for cleaner billing operations.
- Saved Card Management: Allow customers to add, replace, remove, and manage saved payment methods securely.
- Account-Wide Autopay: Use one default saved card for automatic renewals across all active services on the customer account.
- Secure Signed Requests: Uses signed API communication between connected WHMCS sites.
Customer Payment Flow
- The customer opens an invoice on the primary WHMCS site.
- The module prepares the mapped processor invoice on the connected WHMCS site.
- The customer is sent to Stripe Checkout for secure payment.
- Stripe confirms the payment through verified webhook events.
- The payment status is synchronized back to WHMCS and the original invoice is updated.
Saved Cards and Automatic Renewals
Stripe Router Gateway supports saved-card setup using Stripe-hosted flows, allowing customers to securely save a payment method for future automatic renewals without storing card numbers locally in WHMCS.
- Customer card setup through Stripe Checkout
- Account-wide default autopay card
- Automatic WHMCS renewal invoice capture
- Client area card management page
- Admin payment method management
- Manual admin capture support for unpaid invoices
Admin Tools
- Connection Diagnostics: Check processor site connection and configuration status.
- Payment Method Management: View saved cards, default status, and autopay status from the admin addon.
- Product Mapping: Map primary WHMCS products to processor WHMCS products.
- Currency Mapping: Configure currency relationships between both WHMCS installations.
- Gateway Logs: Track payment, capture, webhook, and synchronization activity.
- Manual Capture: Retry eligible invoice payments from the WHMCS admin invoice page.
Security and Reliability
- No Local Card Number Storage: Card numbers are handled by Stripe, while WHMCS stores only non-sensitive card metadata.
- Signed API Requests: Main and processor WHMCS sites communicate using signed request validation.
- Webhook Verification: Stripe webhook signatures are verified before payment events are processed.
- Idempotency Support: Helps reduce duplicate checkout sessions, captures, and payment actions.
- Payment Logs: Important payment actions are recorded for easier troubleshooting.
Ideal For
- WHMCS businesses using Stripe Checkout
- Multi-brand WHMCS operations
- Digital service providers
- Subscription-based businesses
- Agencies managing separated billing environments
- Businesses that need remote checkout and payment synchronization between WHMCS installations
Included Modules
- Stripe Router Main: Customer-facing WHMCS gateway module.
- Stripe Router Sync: Main WHMCS addon for synchronization, settings, diagnostics, product mapping, currency mapping, and saved-card management.
- Stripe Router Processor: Processor-side WHMCS gateway module for Stripe payment handling.
- Stripe Router Processor API: Processor-side API and webhook layer for checkout, capture, callbacks, and synchronization.
Requirements
- Two WHMCS installations or compatible WHMCS environments
- Stripe account with API keys
- Stripe webhook signing secret
- HTTPS enabled on both WHMCS sites
- PHP cURL, JSON, and OpenSSL extensions
- Valid WHMCS cron configuration for automatic renewal capture
Professional Stripe Routing for WHMCS
Stripe Router Gateway for WHMCS gives businesses a structured way to connect two WHMCS installations, route checkout through Stripe, manage saved cards, and keep invoice payments synchronized across both billing environments.




