🔄 Manage Your Subscription
Control every aspect of your UniPulse subscription from Settings > Billing — view your current plan, track usage, change tiers, and manage your billing lifecycle.
Subscription Model​
Your subscription is tracked with the following data:
| Field | Description |
|---|---|
| planId | The plan you're subscribed to (see Pricing & Plans) |
| provider | Payment processor: STRIPE, PAYMOB, or KASHIER |
| providerCustomerId | Your customer ID with the payment provider |
| providerSubscriptionId | The subscription ID with the payment provider |
| status | Current status (see table below) |
| currentPeriodStart / End | Start and end dates of the current billing cycle |
| cancelAtPeriodEnd | If true, the subscription will cancel at the end of the current period |
Subscription Statuses​
| Status | Meaning |
|---|---|
ACTIVE | Subscription is in good standing; all features available |
PAST_DUE | Payment failed; features remain active during a grace period while retries occur |
CANCELLED | Subscription has been cancelled; access continues until currentPeriodEnd |
EXPIRED | Subscription period has ended; access reverted to free tier |
Viewing Your Plan​
Navigate to Settings > Billing to see at a glance:
- Current plan name, tier, and price
- Subscription status (Active, Past Due, Cancelled, or Expired)
- Next billing date (
currentPeriodEnd) - Usage vs. limits — Scheduled posts used, AI credits consumed (from WorkspaceUsage)
- Billing history — All past transactions
Upgrading​
- Click Upgrade or Change Plan
- Select a higher-tier plan
- Review the prorated charge for the remainder of your current billing cycle
- Confirm the upgrade
Upgrades take effect immediately. A Transaction of type UPGRADE is recorded:
| Field | Description |
|---|---|
| type | UPGRADE |
| amount | Prorated amount charged |
| currency | Billing currency |
| status | PENDING → PROCESSING → SUCCEEDED or FAILED |
Downgrading​
- Click Change Plan
- Select a lower-tier plan
- Review what features you'll lose
- Confirm the downgrade
Downgrades take effect at the end of your current billing cycle (currentPeriodEnd). You retain full access to premium features until then. A Transaction of type DOWNGRADE is recorded.
Before downgrading, check your Usage to ensure you won't exceed the lower plan's limits. If you have more social accounts connected than the new plan allows, you'll need to disconnect some before the downgrade takes effect.
Renewals​
Subscriptions renew automatically at each currentPeriodEnd. A Transaction of type RENEWAL is created:
| Field | Description |
|---|---|
| type | RENEWAL |
| amount | Full plan price |
| status | SUCCEEDED if payment goes through; FAILED if the charge fails |
If renewal fails, your subscription moves to PAST_DUE status. The system will retry the charge automatically. After multiple failures, the subscription becomes EXPIRED.
Cancellation​
- Go to Settings > Billing > Cancel Subscription
- Optionally provide a reason (helps us improve)
- Confirm cancellation
What happens after cancellation:
cancelAtPeriodEndis set totrue- Your subscription remains
ACTIVEuntilcurrentPeriodEnd - All features continue working until the period ends
- After the period ends, status changes to
EXPIRED - Data is retained for 30 days after expiration — you can resubscribe to restore everything
Transaction History​
Every financial event is recorded as a Transaction:
| Field | Description |
|---|---|
| type | SUBSCRIPTION (initial), UPGRADE, DOWNGRADE, RENEWAL |
| amount | Charge amount |
| currency | Currency code |
| status | PENDING, PROCESSING, SUCCEEDED, FAILED, or REFUNDED |
View your full transaction history at Settings > Billing > History.
Related Pages​
- Pricing & Plans — Compare plans and features
- Payment Methods — Add, update, or change your payment method
- Multi-Workspace — Workspace limits tied to your plan