Billing Alerts

[LFA]

View File

Billing Alerts

---

This module gets the next due date and trial expiration date from WHMCS and shows alerts in TCAdmin.

Features

• Supports toast and control panel messages/emails.
• Toast and email messages are configured in Settings > Mail Templates.

Requirements

• TCAdmin 2.0.179.1 or greater
• WHMCS API credentials that allows the GetClientsProducts action.

Configuration

• Go to Settings > Billing Alerts.
• Enable the module.
• Configure your WHMCS API URL, ID and secret. Allow your IP in the WHMCS or configure an access key.
• If you offer trials configure the trial length in days.
• Configure when you want TCAdmin to start showing toast and send messages/emails.
• Update the toast click URLs. By default the trial URL takes you to the product and due date URL takes you to unpaid invoices.
• Extract extract-to-whmcs-tcadmin2_advanced.zip located in TCAdmin2\ControlPanel.MVC\bin-extensions\billing-alerts-1.0.0 or /home/tcadmin/ControlPanel.MVC/bin-extensions/billing-alerts-1.0.0 to your tcadmin2_advanced folder in WHMCS. This will remove the toast notification after the user pays the invoice or upgrades from a trial.

Testing
To test connectivity with WHMCS:

• Select a game server.
• Click on More...
• Execute the [ Billing Alerts ] action.
• The script's output will show the game server's next due date or trial expiration date. If there's an error you can enable API logging in WHMCS: https://help.whmcs.com/m/troubleshooting/l/1420554-troubleshooting-debugging-api
• If this works the module's recurring task will execute every day at 6AM (master server time).
• If you don't want to wait you can go to Settings > Scheduled Tasks. Look for the task "[BillingAlerts] Update all trial expirations/due dates" and start it.

---

• Submitter
  LFA
• Submitted
  6/21/2022
• Category
  Modules

 

[GG Hosting]

Thanks for this module, it's very handy.

Just some requests for enhancements:

1. Some WHMCS implementatins require that headers are included in the API calls. Can the scripts for this module be updated to accomodate this where needed?
2. As the update script only runs once a day, new customers will see an error message in the toast pop-up for the entire first day. Could a script be added to run after service creation as well?
3. Users with dedicated servers don't have billing IDs in their services. Where a servive runs on a server that is assigned an owner (thus a dedicated server), could the billing ID of that server be used in the Billing Alert for that service? Alternatively, could a way be added to mirror the service ID of a dedicated server in each of the services on that server?

[tangogc]

On 6/21/2022 at 11:16 PM, LFA said:

View File

Billing Alerts

---

This module gets the next due date and trial expiration date from WHMCS and shows alerts in TCAdmin.

Features

• Supports toast and control panel messages/emails.
• Toast and email messages are configured in Settings > Mail Templates.

Requirements

• TCAdmin 2.0.179.1 or greater
• WHMCS API credentials that allows the GetClientsProducts action.

Configuration

• Go to Settings > Billing Alerts.
• Enable the module.
• Configure your WHMCS API URL, ID and secret. Allow your IP in the WHMCS general settings > security settings or configure an access key
• If you offer trials configure the trial length in days.
• Configure when you want TCAdmin to start showing toast and send messages/emails.
• Update the toast click URLs. By default the trial URL takes you to the product and due date URL takes you to unpaid invoices.
• Extract extract-to-whmcs-tcadmin2_advanced.zip located in TCAdmin2\ControlPanel.MVC\bin-extensions\billing-alerts-1.0.0 or /home/tcadmin/ControlPanel.MVC/bin-extensions/billing-alerts-1.0.0 to your tcadmin2_advanced folder in WHMCS. This will remove the toast notification after the user pays the invoice or upgrades from a trial.

Testing
To test connectivity with WHMCS:

• Select a game server.
• Click on More...
• Execute the [ Billing Alerts ] action.
• The script's output will show the game server's next due date or trial expiration date. If there's an error you can enable API logging in WHMCS: https://help.whmcs.com/m/troubleshooting/l/1420554-troubleshooting-debugging-api
• If this works the module's recurring task will execute every day at 6AM (master server time).
• If you don't want to wait you can go to Settings > Scheduled Tasks. Look for the task "[BillingAlerts] Update all trial expirations/due dates" and start it.

---

• Submitter
  LFA
• Submitted
  6/21/2022
• Category
  Modules

 

thanks for this LFA.

But seem to work only for game server and not detect teamspeak expiration , it is correct ?

[tangogc]

On 9/6/2022 at 1:41 PM, tangogc said:

thanks for this LFA.

But seem to work only for game server and not detect teamspeak expiration , it is correct ?

why doesn't work with teamspeak expiration ?

[4evergaming]

Hi, the API call takes almost a minute and a half to return the results as it gets all the products (including finished and cancelled). Something like 3000 products.

Any alternative solution can be implemented?

[Dennis]

@4evergaming which API call is that?