How Subscription Billing Works
The subscription lifecycle in AgencyHandy follows six key stages.Create a subscription-based service
Navigate to Services and click Create New Service. Select Subscription as the service type.Define:
- Billing Cycle — Daily, Weekly, Monthly, or Yearly
- Renewal Behavior — Create New Order, Update Existing Order, or Keep Unchanged
- Pricing & Payment Method — PayPal, Stripe, or Manual
Client purchases the subscription
The client selects the subscription service, proceeds to checkout, and chooses a payment method.AgencyHandy automatically:
- Creates a Subscription ID
- Generates an Order
- Issues an Invoice
Automated recurring billing
On each renewal date, AgencyHandy processes the payment automatically (for PayPal/Stripe) and generates the next invoice.If payment succeeds, the invoice is marked Paid. If it fails:
- The invoice remains Open
- The client receives a Failed Payment Notification
- The agency receives an alert to retry or request updated payment details
Manage active subscriptions
Navigate to Subscription Management in the left sidebar to view all active and inactive subscriptions. Select any subscription to see its full details.
Handle cancellations
When you cancel a subscription, you can choose to:
- Cancel completely — stop all future billing and orders
- Keep the last active order running — let the client continue receiving service through the current period’s deadline
Subscription Details Page
The Subscription Details page gives you a complete picture of any individual subscription — from the service and package down to every invoice and event log entry.How to Access
- Go to Subscriptions in the left sidebar
- Click on any subscription from the list to open its detail page
What You Can See
- Subscription Info
- Payment Details
- Order History
- Invoice History
- Event Logs
- Service Name and Package Name
- Client Name
- Billing Cycle (e.g., Monthly, Yearly)
- Kick Off Date and End Date
- Subscription Status (Active or Inactive)
A single subscription can have multiple linked orders and invoices. Invoices tied to subscriptions update dynamically when payments are received.
Wise Support for Manual Subscription Invoices
If you collect international payments, you can embed a Wise payment link directly into subscription invoices. This gives clients a convenient way to pay without needing to set up a bank transfer manually.Requirements
- An active AgencyHandy account
- An active Wise account with a valid payment link generated
Steps to Add a Wise Link to an Invoice
Select the client and order
Choose the client from the dropdown. All related Order IDs will appear. Select the relevant Order ID and enter the amount and any items being billed.
Apply discounts and taxes
Add any applicable discount percentage, discount amount, paid amount, due amount, and VAT/tax details. Include billing address and notes as needed.
Add the Wise payment link
In the Payment Method section, select Wise as the payment option. Paste your Wise payment link into the provided field.
Important Notes on Subscription Billing
Who can cancel subscriptions?
Who can cancel subscriptions?
Only Super Admins and Admins can cancel subscriptions. Clients cannot cancel their own subscriptions — they must request cancellation through the agency.
Subscription IDs are permanent
Subscription IDs are permanent
Once a subscription is created, its Subscription ID cannot be edited. This ensures consistent tracking throughout the subscription’s lifetime.
Failed payments and order creation
Failed payments and order creation
When a payment fails, the invoice remains Open and a new order is created for the failed period. The subscription status stays Active until an admin manually retries the payment or cancels the subscription.
Manual payment orders
Manual payment orders
If a client pays outside of Stripe or PayPal (e.g., via bank transfer), the admin must manually mark the invoice as Paid in AgencyHandy. The system does not do this automatically for manual payments.
Unpaid self-checkout attempts
Unpaid self-checkout attempts
If a client starts a subscription checkout but does not complete payment, they remain in the system as a Lead until they successfully subscribe.
Invoice due dates
Invoice due dates
Due dates for subscription invoices are set automatically based on the billing cycle you configured (e.g., monthly invoices are due one month after the kick-off date).

