Troubleshooting Module Problems

From WHMCS Documentation

You can use this module debugging tool to identify and resolve problems communicating with remote API systems. It will record and display the raw API data going to and from the remote system.

Enable Logging

Only enable logging for this tool for testing purposes. At all other times, make certain that you set Module Logging to Off.

If you are experiencing a technical issue with a module, enable logging.

To do this:

  1. Make sure your administrator role has the View Module Debug Log permission.
  2. Go to the Module Log at Configuration () > System Logs or, prior to WHMCS 8.0, Utilities > Logs.
  3. Set Module Logging to On.

    Turn-on-module-log-2.png
  4. Reproduce the issue.
  5. Return to the module log page.

The details of the interaction between WHMCS and the module will display onscreen for your own analysis. You can forward these details to the provider's technical support team if necessary.

To use the Reset Module Debug Log option, temporarily grant the DROP privilege to the WHMCS database user. For more information, see Database Privileges.

Unknown Errors

Sometimes a third-party system or module will provide a response that WHMCS is unable to recognise and interpret. This can result in the display of an Unknown Error message.

In these cases, you can use the System Module Debug Log to obtain the raw response, which will typically help identify the problem.