Subscription Configuration Guide

​

Overview

​

Settings(Go To Configuration -> Subscription Config Page)

​

Enable Immediate Downgrade

• Description:
  • By default, subscription downgrades occur at the end of the current billing cycle. This ensures that customers receive the full value of their current subscription period, even if they pay the downgrade invoice early.
  • When enabled, this option allows users to downgrade immediately upon request and payment, without waiting for the cycle to finish.
• Default: Disabled

• Customer has a Monthly Pro Plan ($99/month) that started on January 1st
• On January 15th (mid-cycle), customer requests to downgrade to Basic Plan ($49/month)
• System generates a downgrade invoice for the Basic Plan, effective from February 1st
• Customer pays the invoice immediately on January 15th
• Result: Customer continues using Pro Plan features until January 31st, then switches to Basic Plan on February 1st
• This ensures the customer gets full value from the $99 already paid for January

• Same scenario: Customer requests downgrade on January 15th
• Customer pays the downgrade invoice
• Result: Customer immediately loses access to Pro Plan features and switches to Basic Plan right away
• The remaining days of Pro Plan access are forfeited

Note: With the default setting (disabled), if a customer pays their downgrade invoice before the billing cycle ends, they will still be able to use their current plan features until the cycle ends. The system automatically ensures customers get the complete value of the period they’ve already paid for.

​

Prorated Upgrade Invoices

• Description:
  • When a user upgrades their subscription, UniBee will automatically generate a prorated invoice based on the remaining billing period.
• Default: Enabled

• Customer has a Basic Plan ($49/month) with a billing cycle from January 1st to January 31st
• On January 16th (mid-cycle, 15 days remaining), customer upgrades to Pro Plan ($99/month)
• System calculates the prorated charge:
  • Daily rate difference: ($99 -$49) / 31 days = $1.61/day
  • Remaining days: 15 days
  • Prorated upgrade fee: $1.61 × 15 =$24.15
• Customer pays $24.15 immediately and gains access to Pro Plan features
• On February 1st, customer will be charged the full $99 for the next billing cycle

• Customer would need to pay the full $99 immediately for the upgrade, regardless of remaining days in the current cycle

​

Incomplete Status Duration

• Description:
  • Defines how long a subscription remains in the “incomplete” status before being automatically handled.
  • The incomplete status provides a grace period for customers to complete payment while maintaining service access.
• Field: Duration in seconds
• Default Value: 86400 seconds (24 hours)

Learn more: For detailed information about incomplete status, including examples and use cases, see Understanding Subscription Incomplete Status.

​

Enable UniBee Billing Emails

• Description:
  • When enabled, UniBee will automatically send billing-related emails to users.
• Default: Enabled

​

Auto-Charge Start Time Before Period End

• Description:
  • Configures how early (in seconds) the system should trigger an automatic payment before the subscription period ends.
  • Example: Setting to 300 seconds (5 minutes) will attempt auto-payment 5 minutes before the period end.
• Default Value: 7200 seconds (2 hours)

​

Hide Zero Value Invoices

• Description:
  • By default, UniBee generates and displays invoices even if the amount is zero.
  • Enabling this option hides invoices with a total value of zero.
• Default: Disabled

​

Notes

• Always review the impact of each setting on your billing cycles and user experience.
• Changes to billing behavior may affect subscription lifecycle events and customer notifications.