Personal tools
Namespaces

Variants
Actions

Recurring Contract Billing For WHMCS

From ModulesGarden Wiki
(Difference between revisions)
Jump to: navigation, search
Line 1: Line 1:
 
<meta name="keywords" content="recurring contract billing for whmcs, recurring contract billing configuration, whmcs recurring contract billing management, whmcs recurring contract billing installation, whmcs contract billing extended common problems, about whmcs recurring contract billing, whmcs recurring contract billing documentation, whmcs recurring contract billing faq, whmcs recurring contract billing help, whmcs recurring contract billing guide, whmcs recurring contract billing wiki, whmcs recurring contract billing tutorial, whmcs recurring contract billing tips, whmcs recurring contract billing wiki"></meta>
 
<meta name="keywords" content="recurring contract billing for whmcs, recurring contract billing configuration, whmcs recurring contract billing management, whmcs recurring contract billing installation, whmcs contract billing extended common problems, about whmcs recurring contract billing, whmcs recurring contract billing documentation, whmcs recurring contract billing faq, whmcs recurring contract billing help, whmcs recurring contract billing guide, whmcs recurring contract billing wiki, whmcs recurring contract billing tutorial, whmcs recurring contract billing tips, whmcs recurring contract billing wiki"></meta>
 
<meta name="description" content="ModulesGarden Wiki Contains All The Information You Need About The Recurring Contract Billing For WHMCS Module."></meta>
 
<meta name="description" content="ModulesGarden Wiki Contains All The Information You Need About The Recurring Contract Billing For WHMCS Module."></meta>
−
 
−
<h4 style="color: #ff0000; font-weight:bold; text-align:center;">Article update is ongoing on this page, watch out for broken links, unclear descriptions and images!<br/>
 
−
We are sorry for the inconvenience caused.</h4>
 
  
 
=About [https://www.modulesgarden.com/products/whmcs/recurring-contract-billing Recurring Contract Billing For WHMCS]=
 
=About [https://www.modulesgarden.com/products/whmcs/recurring-contract-billing Recurring Contract Billing For WHMCS]=
Line 17: Line 14:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ View And Manage Signed Contracts
+
|style="padding: 0px 0px 0px 30px;"|✔ View, Create And Manage Signed Contracts
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Send Contracts To Signature Upon Creating Order
 
|}
 
|}
 
{|
 
{|
Line 82: Line 82:
 
{|
 
{|
 
|style="padding: 0px 0px 0px 45px;"|✔ DocuSign
 
|style="padding: 0px 0px 0px 45px;"|✔ DocuSign
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Define Contract Signature Phrase And Placement
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Define Contract Length Selection Type:
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Dropdown Menu
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Radio Buttons
 
|}
 
|}
 
{|
 
{|
Line 107: Line 119:
 
{|
 
{|
 
|style="padding: 0px 0px 0px 30px;"|✔ View Contract Content Before Accepting It
 
|style="padding: 0px 0px 0px 30px;"|✔ View Contract Content Before Accepting It
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Sign Contract Using Configured Signature Type
 
|}
 
|}
 
{|
 
{|
Line 112: Line 127:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 10px 30px;"|✔ View History Of Any Signed Contract
+
|style="padding: 0px 0px 0px 30px;"|✔ View History Of Any Signed Contract
 +
|}
 +
{|
 +
|style="padding: 0px 0px 10px 30px;"|✔ Receive Contract Email Notification Upon Order Creation
 
|}
 
|}
 
*'''General Info:'''
 
*'''General Info:'''
Line 122: Line 140:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Supports WHMCS Themes "Six" And "Twenty-One"
+
|style="padding: 0px 0px 0px 30px;"|✔ Supports WHMCS Themes "Six", "Twenty-One"  And "Lagom WHMCS Client Theme"
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Supports WHMCS V8.1 And Later
+
|style="padding: 0px 0px 0px 30px;"|✔ Supports WHMCS V8.2 And Later
 
|}
 
|}
 
{|
 
{|
Line 209: Line 227:
 
{|
 
{|
 
|style="padding: 0px 0px 15px 15px;"|'''9. Now it is time to insert proper integration codes.'''<br/><br/>
 
|style="padding: 0px 0px 15px 15px;"|'''9. Now it is time to insert proper integration codes.'''<br/><br/>
−
*'''WHMCS V6 x.x. and V7'''<br/>
+
The module requires alterations into your order form template. Open your currently used order form and follow the instructions.<br/>
−
Module requires alterations into your order form template. Open your currently used order form and follow the instructions.<br/>
+
You will find it in: '' '''yourWHCMS/templates/orderforms/'''yourOrderForm'''/checkout.tpl''' ''<br/><br/>
−
You will find it in: '' '''yourWHCMS/templates/orderforms/'''yourOrderForm'''/viewcart.tpl''' ''<br/><br/>
+
 
Find line:
 
Find line:
−
<pre>
+
<div class="sub-heading">
−
{if $securityquestions && !$loggedin}
+
        <span>{$LANG.orderForm.paymentDetails}</span>
−
</pre>
+
</div>
 
Insert this code snippet above that line:
 
Insert this code snippet above that line:
 
<pre>
 
<pre>
 
  <div class="sub-heading" id="recurring-biling-contracts">
 
  <div class="sub-heading" id="recurring-biling-contracts">
−
    <span>{$contractTitle}</span>
+
        <span>{$contractTitle}</span>
−
</div>
+
    </div>
−
{$contractOutput}  
+
    {$contractOutput}
 
</pre>
 
</pre>
 
This is how a properly inserted code should look like:<br/>
 
This is how a properly inserted code should look like:<br/>
Line 229: Line 246:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|''Note: For illustration purposes we have used '''modern''' orderform, please make changes in the form you are using!<br/> Remember that the content of other order forms may slightly vary from the description above!<br/>Check the 'Utilities' → 'Integration' tab in your module for valid code.''
+
|style="padding: 0px 0px 20px 15px;"|''Note: For illustration purposes we have used '''standard_cart''' orderform, please make changes in the form you are using!<br/> Remember that the content of other order forms may slightly vary from the description above!<br/>Check the 'Utilities' → 'Integration Code' tab in your module for valid code.''
 
|}
 
|}
 
<!--
 
<!--
 
{|
 
{|
 
|style="padding: 0px 0px 15px 15px;"|
 
|style="padding: 0px 0px 15px 15px;"|
−
*'''WHMCS V5 x.x'''<br/>
 
 
Open your currently used '''order form''' and follow the instructions.<br/>
 
Open your currently used '''order form''' and follow the instructions.<br/>
 
You will find it in: '' '''yourWHCMS/templates/orderforms/'''yourOrderForm'''/viewcart.tpl''' ''<br/><br/>
 
You will find it in: '' '''yourWHCMS/templates/orderforms/'''yourOrderForm'''/viewcart.tpl''' ''<br/><br/>
Line 257: Line 273:
 
You will find it in: '' '''yourWHCMS/templates/'''yourTemplate'''/header.tpl''' ''<br/><br/>
 
You will find it in: '' '''yourWHCMS/templates/'''yourTemplate'''/header.tpl''' ''<br/><br/>
 
Find line:
 
Find line:
−
  <nowiki>{include file="$template/includes/navbar.tpl" navbar=$primaryNavbar}</nowiki>
+
  <nowiki>
−
Insert this code snippet below the above shown line:
+
  <div class="sub-heading">
−
  <nowiki><li><a id="Menu-Billing-My_Contracts" href="{$contractLink}">{$contractTitle}</a></li></nowiki>
+
        <span>{$LANG.orderForm.paymentDetails}</span>
 +
  </div>
 +
</nowiki>
 +
Insert this code snippet above that line:
 +
  <nowiki>
 +
    <div class="sub-heading" id="recurring-biling-contracts">
 +
        <span>{$contractTitle}</span>
 +
    </div>
 +
    {$contractOutput}
 +
</nowiki>
 
This is how a properly inserted code should look like:<br/>
 
This is how a properly inserted code should look like:<br/>
 
|}
 
|}
Line 276: Line 301:
 
{|
 
{|
 
|style="padding: 10px 0px 30px 15px;"|'''Once you have properly installed and activated the product you may move to its actual configuration.'''<br/>
 
|style="padding: 10px 0px 30px 15px;"|'''Once you have properly installed and activated the product you may move to its actual configuration.'''<br/>
−
Read the below sections to learn how to use '''Recurring Billing Extended For WHMCS''' completely.
+
Read the below sections to learn how to use '''Recurring Contract Billing For WHMCS''' completely.
 
|}
 
|}
 
==Configuration==
 
==Configuration==
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|In order to start using your Recurring Billing Extended For WHMCS move to '' 'Addons → Recurring Billing'. ''<br/>
+
|style="padding: 10px 0px 15px 15px;"|In order to start using your Recurring Contract Billing For WHMCS move to '' 'Addons → Recurring Contract Billing'. ''<br/>
 
By default, you will be moved to the addon's dashboard with a guide opened. You will find there short notes on how to configure the product.<br/>
 
By default, you will be moved to the addon's dashboard with a guide opened. You will find there short notes on how to configure the product.<br/>
 
In this article we will expand these instructions a bit more.
 
In this article we will expand these instructions a bit more.
Line 499: Line 524:
 
|style="padding: 0px 0px 30px 25px;"|[[File:RB_15.png]]
 
|style="padding: 0px 0px 30px 25px;"|[[File:RB_15.png]]
 
|}
 
|}
−
 
 
===Configuration===
 
===Configuration===
 
{|
 
{|
−
|style="padding: 10px 0px 20px 15px;"|The last step mentioned in the '' 'Guide' '' is setting up '' 'Notifications' '' and '' 'Penalty'. '' These options can be found under '' 'Configuration' '' tab in '' 'Utilities' '' section.<br/> If you wish to provide the phrase under which a client will sign a contract (this phrase has to be included in its content), please use the '' 'DocuSign Phrase' '' configuration.  
+
|style="padding: 10px 0px 20px 15px;"|The last step mentioned in the '' 'Guide' '' is setting up '' 'Notifications' '' and '' 'Penalty'. '' These options can be found under '' 'Configuration' '' tab in '' 'Utilities' '' section.<br/> If you wish to provide the phrase under which a client will sign a contract (this phrase has to be included in its content), please use the '' 'Sign Phrase' '' configuration.  
 
|}
 
|}
 
{|
 
{|
Line 522: Line 546:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|Here you can also turn off the guide or turn it on again once you have hidden it.<br/>
+
|style="padding: 0px 0px 20px 15px;"|Here you can also turn off the guide or turn it on again once you have hidden it.<br/>
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:RB_19.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Finally, you may decide if services shall be suspended after the provided number of days pass, without the client signing the contract.<br/> You may exclude services ordered before a certain date from this option.<br/>
 
'' 'Save' '' the changes once your configuration is ready.
 
'' 'Save' '' the changes once your configuration is ready.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:RB_19.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:RB_19_1.png]]
 
|}
 
|}
  
Line 536: Line 566:
 
====Place Order====
 
====Place Order====
 
{|
 
{|
−
|style="padding: 10px 0px 20px 15px;"|To illustrate the process, let's say a client orders one of your products with recurring payment (it is important that you have previously prepared a contract for this product).
+
|style="padding: 10px 0px 20px 15px;"|To illustrate the process, let's say a client orders one of your products with recurring payment ''(it is important that you have previously prepared a contract for this product).''<br/>
−
|}
+
On the order form, there is a box where a client needs to select one of the available billing cycles.
−
{|
+
−
|style="padding: 0px 0px 20px 25px;"|[[File:RB_20.png]]
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 20px 15px;"|On the order form, there is a box where a client needs to select one of the available billing cycles.
+
 
|}
 
|}
 
{|
 
{|
Line 548: Line 573:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|Once a billing cycle is chosen, in '' 'Additional Required Information' '' a client must select contract length from the available.
+
|style="padding: 0px 0px 20px 15px;"|Once a billing cycle is chosen, in '' 'Additional Required Information' '' a client must select the contract length from the available.
 
|}
 
|}
 
{|
 
{|
Line 570: Line 595:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:RB_25.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:RB_25.png]]
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 20px 15px;"|In the cart all contracts are available to view, make sure you accepted all of them before you check out.<br/> Otherwise, you will not be allowed to proceed.
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 30px 25px;"|[[File:RB_26.png]]
+
 
|}
 
|}
  
 
====Service Contracts====
 
====Service Contracts====
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|To view all accepted contracts, find '' 'Service Contracts' '' section.<br/>
+
|style="padding: 10px 0px 15px 15px;"|To view all accepted contracts, find '' 'My Contracts' '' tab or use a shortcut: '' 'Service Contracts'.''
−
''Note, if you are working with WHMCS V 5 x.x., you will find 'Service Contracts' tab in your navigation menu under 'Billing' section.''  
+
 
|}
 
|}
 
{|
 
{|
Line 598: Line 616:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|View the contract's details page:
+
|style="padding: 0px 0px 20px 15px;"|View the contract's details. Press '' 'Vie Contract' '' to see its details directly in the client area or press '' 'View Document' '' to download its PDF.
 
|}
 
|}
 
{|
 
{|
 
|style="padding: 0px 0px 20px 25px;"|[[File:RB_28_1.png]]
 
|style="padding: 0px 0px 20px 25px;"|[[File:RB_28_1.png]]
−
|}
 
−
{|
 
−
|style="padding: 0px 0px 20px 15px;"|View PDF version:
 
−
|}
 
−
{|
 
−
|style="padding: 0px 0px 20px 25px;"|[[File:RB_29.png]]
 
 
|}
 
|}
 
{|
 
{|
Line 616: Line 628:
 
|style="padding: 0px 0px 30px 25px;"|[[File:RB_30.png]]
 
|style="padding: 0px 0px 30px 25px;"|[[File:RB_30.png]]
 
|}
 
|}
 +
 
===Admin Area===
 
===Admin Area===
 
{|
 
{|
−
|style="padding: 10px 0px 30px 15px;"|Come back to your admin area addon view to manage signed contracts.
+
|style="padding: 10px 0px 15px 15px;"|Come back to your admin area product view page. <br/>
 +
After submitting a new order from the admin area, an email with a link to view and accept the contract will be sent to the client if only the service has a contract template assigned.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:RB_30_0.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 15px;"|Now, go back to the addon view to manage signed contracts.
 
|}
 
|}
 
====Signed Contracts====
 
====Signed Contracts====
Line 624: Line 644:
 
|style="padding: 10px 0px 15px 15px;"|In '' 'Signed Contracts' '' section you will find a list of all contracts accepted by your clients.<br/>
 
|style="padding: 10px 0px 15px 15px;"|In '' 'Signed Contracts' '' section you will find a list of all contracts accepted by your clients.<br/>
 
On the main page you can see name of the client with service used, recurring payment amount for their product and contract details such as signing and ending dates, length and status. <br/>
 
On the main page you can see name of the client with service used, recurring payment amount for their product and contract details such as signing and ending dates, length and status. <br/>
−
Use action buttons to cancel or edit contracts. If you use edit button, you will be moved to a full view of the contract.
+
Use action buttons to cancel or edit contracts. If you use edit button, you will be moved to a full view of the contract.  
 
|}
 
|}
 
{|
 
{|
Line 630: Line 650:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|On this page you can see once again details of a contract accepted between a client and you.  
+
|style="padding: 0px 0px 20px 15px;"|On this page you can see once again details of a contract accepted between a client and you. <br/>
 +
You are allowed to modify the content of this very contract. Note that used '' 'Contract Content' '' will not be altered, only the signed item.
 
|}
 
|}
 
{|
 
{|
Line 636: Line 657:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|Here, you are allowed to modify the content of this very contract. Note that used '' 'Contract Content' '' will not be altered, only this signed item.
+
|style="padding: 0px 0px 15px 15px;"|In case you decide to make any changes to the contract, the previous (before changes) version of the contract is added to the '' 'History'. '' <br/>
 +
Thanks to that, you may always come back to the original, restore it (changes made will be overwritten with the previous content) or view PDF version.<br/> In this step you may also add notes for future reference.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:RB_33.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:RB_34.png]]
 
|}
 
|}
 +
=====Upload Signed Contracts=====
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|In case you decide to make any changes to the contract, the previous (before changes) version of the contract is added to the '' 'History'. '' <br/>
+
|style="padding: 10px 0px 15px 15px;"|Below the list of '' 'Signed Contracts','' you will find a button redirecting you to the form where existing contracts, for example signed manually, can be uploaded into the module and managed here.<br/> Press the button to see how to do that.
−
Thanks to that, you may always come back to the original, restore it (changes made will be overwritten with the previous content) or view PDF version.
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:RB_34.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:RB_34_1.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|First of all select the client and the service the uploaded contract is related to.<br/>
 +
Choose the contract length and signing date, note that the ending date is selected automatically based on the contract length.  <br/> You may also add your private notes. Save the changes to finalize the action.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:RB_34_2.png]]
 
|}
 
|}
  
Line 668: Line 697:
 
|style="padding: 0px 0px 30px 25px;"|[[File:RB_38.png]]
 
|style="padding: 0px 0px 30px 25px;"|[[File:RB_38.png]]
 
|}
 
|}
 +
 
==Advanced Billing For WHMCS Integration==
 
==Advanced Billing For WHMCS Integration==
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|It is possible to combine your Recurring Billing For WHMCS module with one of our most favored products which is Advanced Billing For WHMCS.<br/>  
+
|style="padding: 10px 0px 15px 15px;"|It is possible to combine your Recurring Contract Billing For WHMCS module with one of our most favored products which is Advanced Billing For WHMCS.<br/>  
 
In order to configure the two modules to work together move to '' 'Advanced Billing addon' → 'Configuration' '' and find the product you want to work with. <br/>Move to '' 'Settings' → 'Recurring Billing' '' section, as billing type select ''''' 'Bill On Invoice Generation' ''''' option.<br/>
 
In order to configure the two modules to work together move to '' 'Advanced Billing addon' → 'Configuration' '' and find the product you want to work with. <br/>Move to '' 'Settings' → 'Recurring Billing' '' section, as billing type select ''''' 'Bill On Invoice Generation' ''''' option.<br/>
 
Learn more about Advanced Billing configuration [https://www.docs.modulesgarden.com/Advanced_Billing_For_WHMCS#Recurring_Billing here].
 
Learn more about Advanced Billing configuration [https://www.docs.modulesgarden.com/Advanced_Billing_For_WHMCS#Recurring_Billing here].
Line 678: Line 708:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|When ready, Recurring Billing For WHMCS will be in constant cooperation with the other module within the configured product. If you want to combine the functionalities<br/> of the two modules for more than one product, please remember to select '' 'Bill On Invoice Generation' '' option for all of them!
+
|style="padding: 0px 0px 20px 15px;"|When ready, Recurring Contract Billing For WHMCS will be in constant cooperation with the other module within the configured product. If you want to combine the functionalities<br/> of the two modules for more than one product, please remember to select '' 'Bill On Invoice Generation' '' option for all of them!
 
|}
 
|}
 
<!--
 
<!--
Line 747: Line 777:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 10px 15px;"|2. Remember that Recurring Billing Extended For WHCMS contracts can be applied to products with recurring payment type only.
+
|style="padding: 0px 0px 10px 15px;"|2. Remember that Recurring Contract Billing For WHMCS contracts can be applied to products with recurring payment type only.
 
|}
 
|}
 
{|
 
{|
 
|style="padding: 0px 0px 10px 25px;"|[[File:RB_41.png]]
 
|style="padding: 0px 0px 10px 25px;"|[[File:RB_41.png]]
 
|}
 
|}

Revision as of 13:34, 29 September 2022

Contents

About Recurring Contract Billing For WHMCS

Recurring Contract Billing For WHMCS will allow you to draw up fixed-term contracts for your clients in relation to the offered products and services.

You will be able to define which products require contract acceptance, then set the time span of each contract along with its possible discount and penalty amount.
The module will also let you preview vital statistics and logs gathered in transparent manner on the dashboard.

  • Admin Area Features:
✔ Create Multiple Contracts Per Product
✔ View, Create And Manage Signed Contracts
✔ Send Contracts To Signature Upon Creating Order
✔ Configure Contract Signature Types
✔ Define Time & Modify Contract End Notifications
✔ Modify Contract Renewal Notifications
✔ Define Time After Which Contract Is Defined As Broken
✔ View Logs
  • Contact Features:
✔ Define Contract Content In Multiple Languages
✔ Assign Product To Contract
✔ Define Promo And Penalty Types
✔ Define Multiple Contracts Sets:
✔ Define Contract Length - Up To 10 Years
✔ Define Promo And Penalty Amounts
✔ Define Days Before Expiration To Cancel Contract Without Penalty
✔ Define Trial Period Length
✔ Define Time To Send Renewal Notification
✔ View Total And Recurring Prices
✔ View Amount Of Penalty
✔ Choose Contract Signature Type:
✔ Checkbox
✔ File Upload
✔ Adobe Sign
✔ DocuSign
✔ Define Contract Signature Phrase And Placement
✔ Define Contract Length Selection Type:
✔ Dropdown Menu
✔ Radio Buttons
✔ Allow Orders Without Contract
✔ Define Renewal Type
✔ Renewal Without Contract
✔ Renewal With Contract
✔ Cancel
✔ Toggle Availability Of Cancellation Request
  • Client Area Features:
✔ Choose Contract Length During Order
✔ View Contract Content Before Accepting It
✔ Sign Contract Using Configured Signature Type
✔ View Details Of All Signed Contracts
✔ View History Of Any Signed Contract
✔ Receive Contract Email Notification Upon Order Creation
  • General Info:
✔ Multi-Language Support
✔ Supports PHP 7.2 Up To PHP 7.4
✔ Supports WHMCS Themes "Six", "Twenty-One" And "Lagom WHMCS Client Theme"
✔ Supports WHMCS V8.2 And Later
✔ Easy Module Upgrade To Open Source Version

Installation

This tutorial will show you how to successfully install and configure Recurring Contract Billing For WHMCS.

We will guide you step by step through the whole installation and configuration process.

Installation

1. Log in to our client area and download the module.
RB 1.png
2. In the downloaded file you might find one or two packages that support different PHP versions.

In the most recent versions of the module, you will find only one package that supports PHP 7.2 and later.

PHP72 74.png
Previous updates of the module may contain two packages dedicated to various PHP versions.

The first one that supports PHP 5.6 up to PHP 7.1, and the second one addressed to PHP 7.2 up to PHP 7.4.
Note: Keep in mind that PHP versions 5.6 up to 7.1 are no longer officially supported and their security issues are not fixed or released any more. Find more info here.

PHP56 74.png
Note: You can check the current PHP version in your WHMCS. To do so, proceed to 'Utilities' → 'System' → 'PHP Info'.
3. Extract the package and upload its content into the main WHMCS directory.

The content of the package to upload should look like this.

Drter.png
4. When you install Recurring Contract Billing For WHMCS for the first time you have to rename 'license_RENAME.php' file.

File is located in 'modules/addons/recurring_billing/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

RB 3.png
5. The next step is setting up 'storage' folder as writable.

It is located in 'your_whmcs/modules/addons/recurringBilling/'.

RB 3 2.png
6. In order to configure your license key, you have to edit the previously renamed 'license.php' file.

Enter your license key between quotation marks as presented on the following screen. You can find your license key in our client area → 'My Products'.

RB 4.png

Activation

7. Now, you have to activate the module in your WHMCS system.

Log in to your WHMCS admin area and proceed to 'Setup' → 'Addon Modules'.
Afterwards, find 'Recurring Contract Billing' and press 'Activate' button.

RB 5.png
8. In the next step you need to permit access to this module.

To do so, click on 'Configure' button, tick checkboxes to assign desired admin roles.
Press 'Save Changes'.

RB 6.png
9. Now it is time to insert proper integration codes.

The module requires alterations into your order form template. Open your currently used order form and follow the instructions.
You will find it in: yourWHCMS/templates/orderforms/yourOrderForm/checkout.tpl

Find line: 

       {$LANG.orderForm.paymentDetails}

Insert this code snippet above that line: 

 <div class="sub-heading" id="recurring-biling-contracts">
        <span>{$contractTitle}</span>
    </div>
    {$contractOutput}

This is how a properly inserted code should look like:

RB 6 1.png
Note: For illustration purposes we have used standard_cart orderform, please make changes in the form you are using!
Remember that the content of other order forms may slightly vary from the description above!
Check the 'Utilities' → 'Integration Code' tab in your module for valid code.
10. You have just successfully installed Recurring Contract Billing For WHMCS!

Configuration and Management

Once you have properly installed and activated the product you may move to its actual configuration.

Read the below sections to learn how to use Recurring Contract Billing For WHMCS completely.

Configuration

In order to start using your Recurring Contract Billing For WHMCS move to 'Addons → Recurring Contract Billing'.

By default, you will be moved to the addon's dashboard with a guide opened. You will find there short notes on how to configure the product.
In this article we will expand these instructions a bit more.

RB 7.png
Hide the guide when you have completed the configuration and learned how to reconstruct the process.

Contract Content

First off all, create your first contract's content. To do so, move to 'Contract Content' section and press 'Add New' button.
RB 8.png
Here you can compose the content of a contract.
  • Type in the 'Name' of a contract
  • Fill out the filed with 'Content', you may use 'Available Merge Fields' to do so
    • Client Fields
    • Product Fields
    • Contract Fields
  • Use advanced edition tool to perfectly shape the contract.
  • Compose the contract translation, just select required language from a dropdown menu and type in the translated content.

Do not forget to 'Save' the changes once you have finished.

RB 9.png
Your newly created contract draft is now visible on the list.

Use action buttons to edit the contract or delete it if you are sure it is useless.

RB 11.png

Sign Types

In this tab you can configure the methods of signing contracts, which you will then be able to use for creating a contract template.
You can configure the following methods:
  • Adobe Sign
  • DocuSign
  • File Upload

Note: The checkbox sign method does not require any configuration, so it is not visible in this tab, but you will still be able to select it when creating a contract template.

RB 42.png

Adobe Sign

The Enterprise plan of Adobe Sign is required to use this option. Take the following steps to set it up:

1. Log in to your Adobe Sign profile.
2. Go to the API tab.
3. Choose the API Applications from the menu on the left and press the + button

RB 43.png

4. Enter the 'Name' and 'Display Name' of your application and select 'CUSTOMER' domain. Press 'Save' when ready.
5. Now, select the created application in the list and click on 'Configure OAuth for Application' .
6. While there, you will find your 'Client ID' and 'Client Secret' which are required for the configuration. Please keep them safe.
7. Next, you need to provide a proper callback 'Redirect URIs' from your WHMCS installation in the following format:

https://yourdomain.com/includes/RecurringBilling/getCode.php

Note: Provided URI also has to start with https:// . You will find the already customized address in your module sign types configuration.
8. Finally you have to enable all the scopes. Press 'Save' when ready.

RB 44.png

9. Now return to the configuration of the WHMCS module and enter the previously obtained data.
As the 'Client Email' use the one from your Adobe Sign login. The 'URL Shard' field contains your region identification. To find it, you need to log in to your Adobe Sign.
The environment identifier is found in the URL address, just before the echosign.com (or adobesign.com) portion. For more info, please click here
Do not forget to 'Save' the settings first because only then you will be able to click the 'Authorization' button.

RB 45.png

10. You will have to confirm your access to the authorization for Adobe Sign.

RB 46.png

10. Finally, if you provided all data correctly you should receive the notice that authorization has been completed successfully.

DocuSign

You need to have at least the Basic API plan of DocuSign to use this option.

1. You can set it up in to ways:

  • for the 'Demo' environment, log in here.
  • for the 'Live' environment, log in here.

2. After successful login to the selected environment, select 'API and Keys' tab from the left menu.
3. Now press the 'ADD APP/INTEGRATION KEY' button as presented below.
Important: Integrator keys can be created only through a developer demo account. To go live with your API integration, you need a live DocuSign production account to promote the key to!

RB 47.png

4. Provide your app name.

RB 47 1.png

5. You should now see the 'Integration Key' . Save the 'Integration Key' which is your 'Client ID' that you will use at a later stage of the configuration.
6. Add 'Secret Key' and optionally links to your 'Privacy Policy' and 'Terms of Use' .
7. In 'Redirect URIs' tab press 'ADD URI' button. There, you need to provide a proper callback 'Redirect URIs' from your WHMCS installation in the following format:

https://yourdomain.com/includes/RecurringBilling/getCodeESignature.php

Note: You will find the already customized address in your module sign types configuration.

RB 48.png

8. Now return to the configuration of the WHMCS module and where you can enter the previously obtained data, but first choose if you are using demo environment.
Next provide:

  • Client ID - it is your 'Integration Key'
  • Client Secret - it is your early created 'Secret Key'
  • Client Email - use the one from your 'DocuSign login'
  • Client Password - use the one from your 'DocuSign password login'

Do not forget to 'Save' first because only then you will be able to click the 'Authorization' button.

RB 50.png

10. You will have to confirm your access authorization for DocuSign.

RB 51.png

11. Finally, if you provided all data correctly you should receive notice that authorization has been completed successfully.

File Upload

Here you can configure the minimum and maximum size of files uploaded by your clients as contract signs.

Note: Currently all image, MS Word and PDF formats are supported for upload.

 The values provided here must be given as bytes (B) units. E.g.:

  • 1024 B = 1 KB
  • 1048576 B = 1024 KB = 1 MB
  • 1073741824 B = 1048576 KB = 1024 MB = 1 GB

So, if you want to allow uploaded files e.g. being in between 1 and 8 megabytes in size provide '1048576' and '8388608' values accordingly.
If you do not want to limit the uploaded file sizes, leave '0' value.

Important: The maximum value of the uploaded file size also depends on the configuration of these values in the php.ini file of the server.
If you want to give a higher value, you must also increase the 'upload_max_filesize' and 'upload_max_filesize' in php.ini file accordingly.
Otherwise, the higher value specified in the module will automatically be decreased to the values specified in the php.ini configuration file.

RB 52.png

Contract Templates

Now, that you have a contract's content draft, move to 'Contract Templates'.

In this section you can predefine which contract content draft a specific product a template will refer to.
Press 'Add New' to begin.

RB 12.png
Fill out the contract template form. Name the template, as mentioned before, choose content name from the ones you prepared previously (see 'Contract Content' section).
Select product that this template will be available with.
Note: You can assign only one template to a single product, it is not possible to alter the product assignment once you save the changes!

Define one of the methods by which your customers will be able to sign contracts. Choose from the following:

  • Adobe Sign
  • Checkbox
  • DocuSign
  • File Upload

Note: Don't forget to set up their initial configuration.
Choose Fixed or Percentage values for Promotion and Penalty amounts.
Define contract renewal option:

  • Renew with contract
  • Renew without contract
  • Cancel

Finally, you may decide whether ta allow your clients to cancel the contract while it is active or not.
Once ready, remember to 'Save' the changes.

RB 13.png
Once you have added a new template, you have to fill out contract's details. An appropriate box should appear next to the template form.

You will find there a payment type and the price, number of signed contracts and a checkbox,
which, when selected, allows to order assigned product without the need to accept this contract.
Press '+' to see more.

RB 14.png
In this form you can define:
  • Length - how long such contract shall last
  • Promo Amount - as fixed amount or percentage, depending on the previously selected type in the template form
  • Penalty Amount - as fixed amount or percentage, depending on the previously selected type in the template form
  • Days To Cancel - number of days to the end of the contract from which the customer will no longer have to pay a cancellation penalty
  • Trial Period - number of days when a client may resign from the contact without any consequences or giving reason of resignation
  • Notice Time - define time when a renewal notification will be sent

Next to each of the options (except 'Trial Period') there will appear counted pricing of product.
Remember to 'Save' the changes again.

RB 15.png

Configuration

The last step mentioned in the 'Guide' is setting up 'Notifications' and 'Penalty'. These options can be found under 'Configuration' tab in 'Utilities' section.
If you wish to provide the phrase under which a client will sign a contract (this phrase has to be included in its content), please use the 'Sign Phrase' configuration.
RB 16.png
Select which email notifications you want your clients to receive, enter number of days before due date to send the notification.

Move to 'Setup' → 'Email Templates' → 'General Messages' in your WHMCS to view and edit the notifications. You will find them under 'Ending Contract Notification' name.
Enabled notifications are sent automatically with daily cron run.

RB 17.png
Define number of days when a client can be late with payment.
If a client misses to make payment for longer than the specified here number of days, a penalty will be imposed on such client.
Note: penalty type and amount are specified in 'Contract Template' details.
RB 18.png
Here you can also turn off the guide or turn it on again once you have hidden it.
RB 19.png
Finally, you may decide if services shall be suspended after the provided number of days pass, without the client signing the contract.
You may exclude services ordered before a certain date from this option.

'Save' the changes once your configuration is ready.

RB 19 1.png

Management

In the following sections we will try to explain how previously configured contracts are forced on clients.

Client Area

Place Order

To illustrate the process, let's say a client orders one of your products with recurring payment (it is important that you have previously prepared a contract for this product).

On the order form, there is a box where a client needs to select one of the available billing cycles.

RB 21.png
Once a billing cycle is chosen, in 'Additional Required Information' a client must select the contract length from the available.
RB 22.png
Before accepting any Terms of Use, a client may view the contract and read it.
RB 23.png
Once familiar with the content of the contract accept 'Contract Terms of Use', only then you will be allowed to view the cart with the selected product.

Note: 'Checkbox' method is used in the following example.

RB 24.png
If you do not accept the terms of use you will not be allowed to move to the cart.
RB 25.png

Service Contracts

To view all accepted contracts, find 'My Contracts' tab or use a shortcut: 'Service Contracts'.
RB 27.png
There is a full list of client's contracts with the most important information about them.

Use action buttons to:

  • view the contract details page
  • open a PDF version of the contract
  • see the contract content changes history
RB 28.png
View the contract's details. Press 'Vie Contract' to see its details directly in the client area or press 'View Document' to download its PDF.
RB 28 1.png
History of any changes in the contract content:

View PDF to see the previous version of the contract.

RB 30.png

Admin Area

Come back to your admin area product view page.

After submitting a new order from the admin area, an email with a link to view and accept the contract will be sent to the client if only the service has a contract template assigned.

RB 30 0.png
Now, go back to the addon view to manage signed contracts.

Signed Contracts

In 'Signed Contracts' section you will find a list of all contracts accepted by your clients.

On the main page you can see name of the client with service used, recurring payment amount for their product and contract details such as signing and ending dates, length and status.
Use action buttons to cancel or edit contracts. If you use edit button, you will be moved to a full view of the contract.

RB 31.png
On this page you can see once again details of a contract accepted between a client and you.

You are allowed to modify the content of this very contract. Note that used 'Contract Content' will not be altered, only the signed item.

RB 32.png
In case you decide to make any changes to the contract, the previous (before changes) version of the contract is added to the 'History'.

Thanks to that, you may always come back to the original, restore it (changes made will be overwritten with the previous content) or view PDF version.
In this step you may also add notes for future reference.

RB 34.png
Upload Signed Contracts
Below the list of 'Signed Contracts', you will find a button redirecting you to the form where existing contracts, for example signed manually, can be uploaded into the module and managed here.
Press the button to see how to do that.
RB 34 1.png
First of all select the client and the service the uploaded contract is related to.

Choose the contract length and signing date, note that the ending date is selected automatically based on the contract length.
You may also add your private notes. Save the changes to finalize the action.

RB 34 2.png

Dashboard

On the Dashboard of your addon you will find the most important information in a nutshell.

These are:

  • Recently Signed Contracts
  • Recently Ended Contracts (including finished, canceled and broken ones)
  • Contract Status
  • Logs
RB 35.png

Logs

In 'Logs' section you have a full view on any attempted action on any contract.
RB 38.png

Advanced Billing For WHMCS Integration

It is possible to combine your Recurring Contract Billing For WHMCS module with one of our most favored products which is Advanced Billing For WHMCS.

In order to configure the two modules to work together move to 'Advanced Billing addon' → 'Configuration' and find the product you want to work with.
Move to 'Settings' → 'Recurring Billing' section, as billing type select 'Bill On Invoice Generation' option.
Learn more about Advanced Billing configuration here.

RB 40.png
When ready, Recurring Contract Billing For WHMCS will be in constant cooperation with the other module within the configured product. If you want to combine the functionalities
of the two modules for more than one product, please remember to select 'Bill On Invoice Generation' option for all of them!

Tips

1. If you mark checkbox 'Select to permit orders without contract' in a contract template, while placing an order a client will be allowed
to select 'I do not want to sign a contract' option form 'Contract Length'.
No 'Terms of Use' will have to be accepted then and the client will not be charged according to the contract's details.
RB 39.png
2. The contracts are automatically broken in two cases:
  • The invoice has not been paid - module counts the number of days set up in configuration 'penalty after x days' until the moment the payment is noted in the system.
  • Client has sent a cancellation request for the product.
3. As this module supports templates system, any changes made in the module's templates files will be saved after the upgrade process.
4. Please remember that the 'Accept Contract' checkbox with the possibility to view the contract in the preview of placing an order is visible only for logged in users.
For not logged in users, it will be visible when they proceed to the checkout step.
5. To assure correct integration of the module with the 'Lagom Client Theme', the following integration code must be added into ' viewcart.tpl'.

Open the ' viewcart.tpl' file at /templates/orderforms/lagom2/viewcart.tpl directory, find following line (89): 

<input type="hidden" name="submit" value="true" />

Insert the following code below that line: 

                 <div class="section mg-recurring-billing">
                    <div class="section-header">
                        <div class="section-title h3" id="recurring-biling-contracts">
                            <span>{$contractTitle}</span>
                        </div>
                    </div>
                    <div class="section-body">
                        {$contractOutput}
                    </div>
                    {literal}
                    <style>
                        .mg-recurring-billing p {
                            display: flex;
                            align-items: center;
                        }
                    </style>
                    {/literal}
                </div>

Update Instructions

Essential guidance through the process of updating the module is offered here.

Keep in mind there is a quick and easy option in our client area that will let you upgrade the license of your module to an open source version at any time - and at a lower price!
To take advantage of it, simply use the License Upgrade button located on the product's page and a discounted invoice will be generated automatically.

Common Problems

1. When you have problems with connection, check whether your SELinux or firewall does not block ports.
2. Remember that Recurring Contract Billing For WHMCS contracts can be applied to products with recurring payment type only.
RB 41.png
Retrieved from "https://www.docs.modulesgarden.com/index.php?title=Recurring_Contract_Billing_For_WHMCS&oldid=60577"
Navigation
WHMCS Modules
WHMCS Widgets
Translations
cPanel Modules
General
FAQ
Community
Recurring Contract Billing For WHMCS