Prorated Discounts and Credits for Membership Plan Changes

Link: https://support.brilliantdirectories.com/support/solutions/articles/12000094635-prorated-discounts-and-credits-for-membership-plan-changes

In this article, we will be going over the prorated discounts and credits that can be assigned during membership plan upgrades and downgrades.


Important Notes:


1. For this funcionality to work, the Member Credits System add-on has to be enabled on the site.


2. The member has to be in Active status, meaning that they can't be past due on the most recent invoice on the current product for this discounts/credits to work.



There are two Advanced Settings related to the prorated discounts.


Find them by searching the following variables:

  • enable_prorated_plan_changes 
  • proration_deduct_first_day
  • enable_credit_system


1) How Does the Enable Prorated Plan Changes Setting Work?


To enable prorated plan changes, navigate to Settings >> Advanced Settings and enable the advanced setting enable_prorated_plan_changes:




Locate the setting enable_credit_system and ensure that it is turned on:


The idea of proration is when a paid member wants to change their membership plan, the system will calculate a prorated amount of credits that will then be applied during when a member changes their membership plan. 


Let's assume the following scenario, there is a member who signed up for the Premium in an annual plan for $200 today:




Now let's assume this member would like to change their membership plan to Featured on the same day, which is an annual plan for $100:




When this advanced setting is enabled, instead of the members having to pay a new $100 for the plan they are changing to, the system will instead calculate the difference in pricing between the current plan and the new plan and will give the member a Prorated Discount/Credit:




As the system indicates in the Order Summary above, this member who signed up today still has $200.00 worth of prorated time left on their current plan, hence this member will receive $200 worth of credit and $100 of this credit will be used to pay for the $100 annual membership of this new plan.


This can be better seen in the Credit History Log for this member:




A $200 prorated credit has been assigned first and then $100 was instantly used to change their membership plan, hence this member has a $100 credit left on their account.


2) How Does the Deduct First Day Usage From Proration Calculation Setting Work?


To enable the deduction of first-day usage from the proration calculation, navigate to Settings >> Advanced Settings and enable the advanced setting proration_deduct_first_day:




Now let's assume the same scenario provided above, a member signed up for the Premium membership plan in an annual plan for $200 today and would like to change their membership plan to Featured on the same day, which has an annual plan for $100:




When this advanced setting is enabled, the member will receive $199.45 worth of prorated credits first to their account, instead of $200 as the first-day usage of the yearly plan has been deducted from the total:




This can be better seen in the Credit History Log for this member:




How Does the System Calculate the Proration Credit Value?


In the examples above, we went over the scenarios where the user decides to change their plan within the same day. What if this user decides to change their plan after a few days instead?


Example 1: 

Let's assume the member signed up on April 20th and changed their plan on April 28th (technically 9 full days) and let's assume the proration_deduct_first_day is disabled. The proration credit value would be calculated like the following:


$200 divided by 365 equals $0.55,  and this will be the daily value of the original membership plan they signed up to.


$0.55 times 8 days (not deducting for the first day) that past equals $4.40 of plan usage so far on their current plan.


$200 minus $4.40 equals $195.60, and this will be the total value of the prorated credit the member will receive


Example 2:

Let's assume the member signed up on April 20th and changed their plan on April 28th and let's assume the proration_deduct_first_day is enabled. The proration credit value would be calculated like the following:


$200 divided by 365 equals $0.55 and this will be the daily value of the original membership plan they signed up to.


$0.55 times 9 days (the full number of days from April 20 - 28) equals $4.95 and this will be the total value of the prorated credit that will be deducted from the total


$200 minus $4.95 equals $195.05 and this will be the total value of the prorated credit the member will receive