Subscriptions

Introduction

The Subscriptions section in OpenCart 4 provides powerful tools for managing recurring billing, subscription plans, and automated payment processing. This advanced feature enables you to offer subscription-based products and services with flexible billing cycles and comprehensive management capabilities.

{% hint style="info" %} Subscription Evolution OpenCart 4 introduces enhanced subscription management, replacing the previous "Recurring Orders" system with more robust features and better integration with payment gateways. {% endhint %}

Accessing Subscriptions

To access the Subscriptions section:

Navigate to Sales in the main admin menu
Click on Subscriptions to open the subscription management interface
View the subscription list displaying all active and historical subscriptions

Subscriptions List Overview

The main Subscriptions page displays all subscription records with the following information:

Column	Description
Subscription ID	Unique identifier for each subscription
Order ID	Original order that created the subscription
Customer	Customer name associated with subscription
Status	Current subscription status
Date Added	When subscription was created
Action	Available actions (Edit, View History)

Filtering Subscriptions

Use filtering to quickly find specific subscriptions:

{% stepper %} {% step %}

Step 1: Access Filter Options

Click the Filter button above the subscriptions list to expand filtering options. {% endstep %}

{% step %}

Step 2: Apply Search Criteria

Use any combination of the following filters:

Subscription ID: Search by specific subscription number
Order ID: Find subscriptions from specific orders
Customer: Search by customer name
Product: Filter by product name or model
Subscription Status: Filter by current subscription status
Date Ranges: Filter by date added or next billing date {% endstep %}

{% step %}

Step 3: Apply and View Results

Click Apply Filter to display matching subscriptions. Use Clear Filter to reset all criteria. {% endstep %} {% endstepper %}

Subscription Status Workflow

Available Subscription Statuses

OpenCart 4 includes comprehensive subscription status tracking:

Status	Description
Active	Subscription is active and billing normally
Inactive	Subscription is paused or temporarily stopped
Expired	Subscription has reached its end date
Pending	Subscription awaiting activation
Suspended	Subscription suspended due to payment issues
Cancelled	Subscription cancelled by customer or admin
Failed	Subscription failed due to payment problems

Subscription Status Management

{% stepper %} {% step %}

Step 1: Edit Subscription

Click Edit next to the subscription you want to update. {% endstep %}

{% step %}

Step 2: Navigate to Subscription History

Scroll to the Subscription History section at the bottom of the subscription details page. {% endstep %}

{% step %}

Step 3: Update Status

Select the new Subscription Status from the dropdown
Add a Comment for internal tracking
Check Notify Customer to send email notification
Click Add History to save the status change {% endstep %} {% endstepper %}

Subscription Plans and Billing

Subscription Plan Structure

Subscription plans in OpenCart 4 support flexible billing configurations:

Trial Periods: Optional free or discounted trial periods
Recurring Billing: Regular billing cycles (daily, weekly, monthly, yearly)
Duration Limits: Set subscription duration or allow indefinite billing
Price Variations: Different pricing for trial vs. regular billing

Billing Cycle Options

Cycle	Description	Use Cases
Day	Daily billing	News services, daily content
Week	Weekly billing	Weekly newsletters, services
Semi-Month	Twice monthly	Bi-weekly services
Month	Monthly billing	Most subscription services
Year	Annual billing	Software licenses, memberships

Manual Subscription Creation

Create subscriptions manually for special situations or custom arrangements:

{% stepper %} {% step %}

Step 1: Start New Subscription

Click the Add button at the top of the Subscriptions page. {% endstep %}

{% step %}

Step 2: Customer and Order Details

Select Customer: Choose existing customer
Order ID: Link to existing order (optional)
Store: Select store location
Language/Currency: Set subscription language and currency {% endstep %}

{% step %}

Step 3: Subscription Plan

Subscription Plan: Choose from available subscription plans
Product: Select product for subscription
Options: Configure product options if applicable
Quantity: Set subscription quantity {% endstep %}

{% step %}

Step 4: Billing Details

Date Next: Set next billing date
Payment Method: Choose payment method for recurring billing
Payment/Shipping Address: Set addresses for billing and shipping {% endstep %}

{% step %}

Step 5: Complete Subscription

Review Information: Verify all subscription details
Set Status: Choose initial subscription status
Save Subscription: Click Save to create the subscription {% endstep %} {% endstepper %}

Subscription Processing

Automatic Billing Workflow

{% stepper %} {% step %}

Step 1: Billing Cycle Trigger

System automatically processes subscriptions based on their billing cycle and next billing date. {% endstep %}

{% step %}

Step 2: Payment Processing

Payment gateway attempts to charge customer
System creates new order for successful payments
Failed payments trigger retry logic or status changes {% endstep %}

{% step %}

Step 3: Order Generation

New order created with subscription products
Order status set based on payment success
Customer notified of successful billing {% endstep %}

{% step %}

Step 4: Next Billing Date Update

System calculates and sets next billing date
Subscription status updated if needed
Log entry created for billing cycle {% endstep %} {% endstepper %}

Manual Subscription Management

For subscriptions requiring manual intervention:

Process Single Subscription: Manually trigger billing for specific subscriptions
Bulk Processing: Process multiple subscriptions at once
Override Billing Dates: Adjust next billing dates as needed
Payment Retry: Manually retry failed payments

Subscription History and Logs

Comprehensive Tracking

OpenCart 4 maintains detailed subscription records:

Billing History: Complete record of all billing attempts
Status Changes: Timeline of subscription status updates
Payment Logs: Detailed payment gateway responses
Customer Actions: Customer-initiated changes and cancellations

Accessing Subscription Logs

Edit Subscription you want to review
Navigate to Logs tab to view detailed transaction history
Review billing attempts, payment responses, and system actions

Troubleshooting

<details> <summary>Common Subscription Issues</summary>

Payment Processing Failures

Verify payment gateway supports recurring billing
Check customer payment method is valid
Ensure sufficient funds are available
Confirm payment gateway configuration

Subscription Not Billing

Check next billing date is set correctly
Verify subscription status is Active
Ensure payment gateway is properly configured
Check for system cron job issues

Customer Access Problems

Verify customer account is active
Check subscription status allows access
Confirm product availability and pricing
Ensure proper user permissions

Billing Date Issues

Verify timezone settings are correct
Check subscription plan duration settings
Ensure billing cycle calculations are accurate
Confirm manual overrides haven't affected dates

</details>

Best Practices

{% hint style="success" %} Subscription Management Tips

Monitor subscription health metrics regularly
Proactively address payment failures to reduce churn
Provide clear communication for subscription changes
Maintain detailed audit trails for billing activities
Test subscription workflows thoroughly before launch {% endhint %}

{% hint style="warning" %} Important Considerations

Ensure compliance with subscription billing regulations
Maintain clear cancellation and refund policies
Monitor payment gateway reliability and uptime
Keep accurate records for accounting and auditing
Plan for subscription lifecycle management {% endhint %}

Next Steps

After mastering subscription management, explore:

Orders Management - Complete order processing system
Returns Processing - Handling product returns
Payment Gateway Configuration - Setting up recurring billing
Customer Management - Comprehensive customer relationship management