Subscription Management & Recurring Billing in Agency Handy
Managing subscriptions efficiently is crucial for agencies offering recurring services. Agency Handy provides a seamless subscription management system that automates invoicing, streamlines payment processing and ensures smooth client interactions. This guide walks you through the entire process—from creating a subscription service to handling renewals, failed payments, and cancellations. With features like automated invoices, multiple billing cycles, and detailed tracking, Agency Handy ensures agencies can focus on delivering value while the system takes care of billing and payments.
Pre-Conditions
Role Access: Available to SuperAdmin, Admin, PM, and Clients.
Payment Integration: Requires Stripe/PayPal integration for automatic payment processing.
Service Setup: The service must have a recurring payment option enabled.
Client Subscription: Clients must have an active subscription before recurring billing is triggered.
Order Management: Agencies must configure renewal behavior for each subscription.
1. Creating a Subscription Service
Step 1: Access Service Creation
Go to Agency Handy Dashboard.
Navigate to Services from the sidebar.
Click on Create New Service.
Step 2: Define Subscription Details
Service Type: Select Subscription as the service type.
Payment Type: Choose Recurring.
Billing Cycle: Select the desired billing frequency:
Daily
Weekly
Monthly
Yearly
Renewal Behavior: Choose one of the following options:
Create New Order: Generates a new order with updated deadlines for each billing cycle.
Update Existing Order: Changes the status to "Ongoing" and refreshes deadlines without creating a new order.
Keep Unchanged: Maintains the current order while generating recurring invoices.
Step 3: Set Pricing and Payment Method
Subscription Fee: Enter the recurring payment amount.
Payment Method: Select the preferred payment gateway:
Stripe
PayPal
Manual
Step 4: Save and Publish
Review the details.
Click Save to draft the service or Publish to make it available for purchase.
2. Subscription Creation Flow
Once a client purchases the subscription service:
A Subscription is created under Subscription Management.
An Order is automatically generated within that subscription.
An Invoice linked to the order is created with the following behavior:
For Self-Checkout Orders:
The invoice is marked as Paid automatically.
Payment is processed immediately using the stored payment method.
For Manual Orders:
An invoice is created and sent to the client for payment.
Payment must be manually confirmed by the agency.
3. Managing Subscriptions
Accessing Subscription Details
Go to Subscription Management from the sidebar.
Select the desired subscription to view its details, including:
Subscription ID
Client Name
Service Name
Subscription Fee
Number of Orders
Last Payment Date
Next Payment Date
Total Payments Made
Subscription Status (Active / Inactive)
Editing Subscription Details
Click on Edit in the subscription details page.
Modify fields such as:
Payment Method
Billing Cycle (only for upcoming payments)
Save changes to update the subscription settings.
Cancelling a Subscription
Click on Cancel Subscription in the subscription details page.
If canceling the last active order, a confirmation popup will appear:
"Do you also want to cancel the subscription?"
Select Yes to cancel the subscription.
Select No to keep the subscription active while canceling the order.
Note: Clients cannot cancel their own subscriptions. Only Super Admin and Admin have this permission.
4. Invoice and Payment Processing
Automatic Invoice Generation
Self-Checkout Orders:
Invoices are automatically marked as Paid once the payment is processed.
Manual Orders:
Invoices are sent to clients for payment confirmation.
Status is updated to Paid once manually confirmed by the agency.
Payment Failure Handling
If a payment fails:
The invoice status remains Open.
No new order is generated.
A Failed Payment Notification is sent to both the client and the agency.
Agency can retry the payment or request the client to update payment details.
5. Notifications & Email Updates
Before Subscription Renewal (Self-Checkout Orders)
Subject: Subscription Renewal Reminder for [Service_Name] with [Company_Name]
Notification: Sent X days before renewal.
After Successful Payment
Subject: Payment Received for Invoice [Invoice_Number]
Notification: Sent immediately upon payment confirmation.
Failed Payment Notification
Admin Notification: "There was a problem processing [Client_Name]’s payment for [Service_Name]."
Client Notification: "Your payment for [Service_Name] could not be processed. Please update your payment method."
Email to Client:
Subject: Action Required: Payment for [Service_Name] Failed
"Your recent payment for [Service_Name] was unsuccessful. We will retry automatically."
Email to Agency:
Subject: Payment Failure Notification for [Client_Name]
"Payment for [Client_Name]’s [Service_Name] was unsuccessful. Please follow up."
6. Service Deletion Rules
Services with active subscriptions cannot be deleted.
The Delete button will be hidden for such services.
To delete, first cancel all active subscriptions linked to the service.
Important Notes
Unpaid Self-Checkout Attempts Become "Leads"
Clients remain as Leads until they make a purchase.
Handling Multiple Invoices
Only manual orders allow multiple invoices to repeat.
Orders will repeat even if no invoice is generated.
Manual Invoice for Stripe/PayPal
Only one-time invoices can be manually added.
Currency Restrictions
Currency cannot be changed in manual orders.
Manual Invoice Pricing
Invoice billing cycles are separate from orders.
Repeating Old Invoices
Old invoices do not repeat indefinitely.
A repeat limit is introduced.
Invoice Due Date
The due date is auto-set based on the billing cycle.
Subscription Timeline
A detailed subscription page is accessible by clicking the Subscription ID.
Last updated
Was this helpful?