This guide walks you through creating your first subscription in the Alguna dashboard.
Prerequisites: At least one plan configured in your account
Step 1: Create a Customer
Before creating a subscription, you need a customer to assign it to.
- Navigate to Customers in the sidebar
- Click New Customer
- Fill in customer details:
| Field | Description |
|---|
| Name | Company or customer name |
| Email | Billing email address |
| Billing Address | Street, city, state, postal code, country |
| External ID | Your internal customer ID (optional) |
- Click Create
Step 2: Create a Subscription
- Navigate to Subscriptions in the sidebar
- Click New Subscription
- Configure the subscription:
| Field | Description |
|---|
| Customer | Select the customer you created |
| Plan | Choose from your product catalog |
| Start Date | Today or a future date |
| Contract Length | Optional: 12 months, 24 months, etc. |
- Review the pricing summary
- Click Create & Activate
Your first subscription is now live!
What Happens After Activation
- Subscription becomes active - Status changes to “Active”
- First invoice generated - Based on your billing configuration
- Payment collected - If auto-charge is enabled and payment method exists
- Webhooks sent -
subscription.activated and invoice.issued events
Optional: Add Payment Method
For customers paying by card, they need to add a payment method:
Option 1: Send Portal Link
- Go to Customers → [Customer Name]
- Click Send Billing Portal Link
- Customer receives email with secure link to add payment
Option 2: Send Checkout Link
- Go to Customers → [Customer Name]
- Click Create Checkout Session
- Select the plan
- Send the checkout link to customer
Subscription Variations
Subscription with Trial
- When creating the subscription, expand Trial Settings
- Set trial duration (e.g., 14 days)
- Choose whether payment method is required
- Create & Activate
Future-Dated Subscription
- Set Start Date to a future date
- Create & Activate
- Subscription activates immediately but billing starts on the future date
Custom Line Items
Instead of selecting a plan:
- Click Custom Subscription
- Add products and quantities manually
- Set pricing for each line item
- Create & Activate
Managing the Subscription
View Subscription Details
- Navigate to Subscriptions
- Click on the subscription
- View:
- Current status
- Billing period
- Line items and pricing
- Invoice history
- Activity log
Make Changes
See Amendments for upgrading, downgrading, or modifying subscriptions.
Cancel Subscription
See Canceling Subscriptions for ending subscriptions.
Troubleshooting
Subscription Stuck in Draft
Subscriptions are created in “Draft” status by default. Click Activate to start billing.
Invoice Not Generated
Check:
- Is the start date today or in the past?
- Is billing set to “In Advance” or “In Arrears”?
- Review billing schedule settings on the plan
Customer Already Has Subscription
By default, customers can have multiple subscriptions. This is normal for complex billing scenarios.
Next Steps