Billing of Prepaid Subscriptions
On this page
Overview
Prepaid subscriptions are funded directly from the wallets of subscribers. Subscription services can be pre-rated (billed for an upcoming predetermined period) or post-rated (billed after being used). Billing takes place either when the service is activated or a prepaid billing run is executed. There must be sufficient funds in the wallet to cover the billing period in order for services to be activated. If there are insufficient funds during the billing run to cover billed services, the services become candidates for deactivation.
Setting Up Prepaid Billing Runs
In order for the prepaid billing run to be executed the necessary configurations in the Prepaid Billing Settings tab of the billing definition must be made.
Configuration > Billing Application > Billing > Set Up Billing Definition > Prepaid Billing Settings
Managing Prepaid Billing Runs
Once the billing settings are defined, the prepaid billing run is executed by a system background process (without the need for user intervention). The results of the billing run can be viewed from a dedicated page or through the Batch Process Admin Board (from where you can manage their schedule and view logs of all executed runs).
Prepaid Billing Run
Billing > Billing > Perform Prepaid Billing Runs
The table describes the sections of the Prepaid Billing Run Data Entry page and explains how the fields on the page are used.
Mandatory Configurable
Main Information | |
---|---|
Bill As Of Date: The date on which the prepaid billing run is executed. Subscriptions with services 'Rated up to' and including the 'Bill as of' date are considered for billing. The Life Cycle State reflects the progress of the billing run:
Scheduled Date: Displays the next date on which the run will be executed. Enable Wallet Consumption Estimation Step: Configured in the prepaid billing settings section of the billing definition.
Skip the estimation of wallets for a faster execution of billing. | |
Results (Information on bills created by billing run) | |
Includes the total Number of Generated Wallet Transactions, the billing run Start and End Date and the Results Per Step (a summary table listing the steps of the billing run, the wallet transactions that were created and the included entities). | |
Exceptions | |
Display accounts excluded from billing due to errors. |
Batch Process Admin Board
Foundation > Platform > Manage Admin Settings > Batch Processes Admin Board
Use the board to stop the prepaid billing run from being executed or to view its logs.
- Navigate to the Board
- Go to Recurring System Process
- Find the prepaid billing run.
- Click on View Logs
or - Stop the run.
- Click on View Logs
Executing a prepaid billing run
The steps of a run include:
- Identifying the items to be billed
- Rating the items
- Debiting (or crediting) the subscription wallet.
Identification process
Locates unrated billable items that, according to billing run conditions, are ready to be charged or credited. The following entities are considered:
- Subscription Usage Detail Records that should be charged or credited and have a 'Posted' life cycle state.
- Post-rated services that:
- Should be charged or credited (depending on the value of the billing directive)
- Are not yet rated
- Have a billing effective date up to and including the bill as of date.
- Pre-rated services that have not been rated before or whose latest 'rated up to' date is up to and including the billing run's performed date.
Terminated accounts are excluded from billing.
Rating
Creates rated billing items for services using the rate from the price plan and information from the following entities:
- Usage services
Usage Detail Records (UDRs) with a 'Pending' (not yet processed) rating state are considered for billing. The UDR billing directive specifies whether a debit or credit rated billing item should be created. The period to be billed is indicated by the 'Started on' and 'Ended on' dates. - Termed services
The source of information for rating termed services is their life cycle states. Each life cycle state represents one period. The 'Started on' and 'Ended on' dates indicate the period. Life cycle states in a 'Pending' rating state are considered for billing. The billing directive of each life cycle state specifies whether a debit or credit rated billing item should be created.- For post-rated services, a rated billing item is created covering the period from the last Rated Up To Date until the billing run's Performed Date.
- For pre-rated services, a rated billing item is created covering the period billed in advance (as defined in the billing term scheme) up to the last 'Rated Up To Date'.
- Expenses
The billing directive for the life cycle state of the expense specifies whether a debit or credit rated billing item should be created. - Additive Discounts
Additional discounts that should be applied to the subscription are taken into consideration after discounts that may have been applied through the price plans.
Rated billing items are created as long as they don't result in the wallet's balance falling below the threshold (established in the wallet definition).
If the calculated balance of the wallet remains over the threshold:
- The wallet is debited
- The service is not rated for the upcoming period
- The prepaid state is set to 'Valid' and the service is not considered for deactivation.
If the calculated balance of the wallet drops below the threshold:
- The wallet is not debited
- The service is not rated for the upcoming period
- The prepaid state is set to 'Invalid' and the service is considered for deactivation.
If a service is coming out of a Grace Period, customers are also billed for the period spent in grace, unless the 'Decrease the prepaid pre-rated period by the total number of days in grace periods' setting is selected in the billing definition.
Changes on price plans and additive discounts that come into effect after a prepaid billing run pre-rates a service do not affect its billing. The new prices will apply in the next billing period, which is not rated yet.
Wallet Debiting
Uses the rated billing items resulting from the rating step and previously unprocessed rated billing items, to generate debit or credit wallet transactions.
Wallet Consumption Estimations
Calculates the date on which (or the number of days until) wallet funds (or the funds allotted for a specific product) will run out, based on the billing terms and use of subscription services. The estimations must be enabled through the prepaid billing run.
The maximum estimated time (one year by default) can be configured through the 'Prepaid Billing Run Settings' in the billing definition.
Wallets
- Estimated consumption days
- Estimated consumption date
Wallet Product Consumption
- Estimated consumption days
- Estimated consumption date
- Latest date of estimation
Glossary
CRM.COM Term | Definition |
---|---|
Billable Entity | An entity that can be billed through the billing engine (job or subscription). |
Rated Billing Item (RBI) | Information on services, physical goods and the billing period, generated by the billing engine during the rating step of the normal billing run, before the transaction takes place. RBIs let the user make amendments or corrections before (a binding) financial transaction is created. |
Usage Detail Record (UDR) | Information describing the use of usage subscription services. |
Prepaid State | Reflects whether a service is evaluated as 'Valid' or 'Invalid' by the prepaid billing run. Invalid services are included in the next deactivation run. |