This addon module will allow you to provide your customers with support pin numbers for easy verification.

Key Features

  • 5 types of pin: (Main pin, 3rd party pin, temporary pin, Service Pin (1.30), Domain Pin (1.32))
  • Variable length and pin combo (numeric vs alphanumeric)
  • Adjustable pin code valid period
  • Autogenerate when a code expires
  • Easy to install, no template code modification needed
  • WHMCS Six template compatible
  • Easily translatable using WHMCS language files
  • Display in the sidebar, navigation menu, homepage panel
  • Allow customer to request temporary support pin (New in 1.34)

Main pin 

is intended for all general purpose verification. Such as billing modification, account changes… etc

3rd party pin

is intended for the account holder providing account support access to a 3rd party individual without providing the main account. Such as contacting your company for support.

Temporary pin 

is intended for providing quick verification if the account owner can't login but still have email access. Temporary keys are generated by your company staff and it is emailed to the customer's email

Service Pin

is intended for all purpose pin for a particular service a customer have

Domain Pin

is intended for all purpose pin for a particular domain a customer have


Make sure you have the ioncube10 loader installed for your web server. If you are running ioncube 5 or prior loader then you can either run easyapache to rebuild the ioncube extension automatically or download and modify the loader manually

You must be using a template that's build off of the six template engine as it utilizes the sidebar function.

Installation Instructions

Copy all the files into your WHMCS modules/addons directory. No template modification is needed

Language Files

The module includes English as the base language. If you wish to translate it to your enabled language in WHMCS. Make a copy of the english.php in /modules/addons/customerpin/lang/ to your associated language. For example, french.php. The filename must match to the ones in the WHMCS/lang/french.php

Template Files

There are no template modification. The support pins will be displayed in the sidebar of the template.

Starting the module

Enable the module like you would for any other WHMCS module. WHMCS Admin → Setup → Addon Modules → Activate

Once activated you can set the options below

Modifying the email template

Upon installation of this module, a new email template will be installed onto your WHMCS. You can view and edit the template named WHMCS Customer Pin Template

Module Config Options

There are several options you can set with the mod. Here is a quick breakdown.

Request Pin PageThis will allow client to request temporary support pin for non-login validation
Request Pin Time IntervalThe number of seconds the client can request a temporary support pin email again
Show Request Pin LinkThis will insert a Request Support Pin link for non-logged in client to the Client Area
Date display formatChange the display format for the pin expiry date
Per Service PinEnable Service Support Pin
Disable Per Account PinEnabling this will disable the Account Support Pin when Per Service Pin is enabled. Otherwise no effect
Allow 3rd party support pinThis will enable the customer's ability to generate a 3rd party support code
Main pin styleSet the main account's pin either numeric (0-9) or alphanumeric (A-z0-9)
Main pin lengthThe length of the main pin
Main pin valid durationThe number of days the pin is valid for until it get regenerated again
Temp pin valid durationThe number of minutes the temporary pin is valid for (it will not regenerate, it is has to be sent manually)
3rd party optionsSame as the main pin options
Email Template IDThe name the email template the module will use to send out the temporary pin (The name must be exact)
Display optionsThese options will determine which template page the module will display on

Request Pin Page

If your WHMCS template is not based on Six, then you can add a link manually to your template to link to the Request Pin Page


  • No labels