Knowledgebase

This article covers common issues with the Snowtech BPAY Gateway in WHMCS and how to resolve them.

Quick checks (do these first)

• Confirm you are running WHMCS 9.0.1+ and PHP 8.3+.
• Confirm the gateway is Activated in:
  Configuration > System Settings > Payment Gateways
• Confirm /modules/gateways/bpay.php exists on the server.
• Confirm /modules/gateways/bpay/licensing.php exists (if using Snowtech licensing).

Issue: “BPAY does not appear as a payment method”

Cause: The gateway is not activated or WHMCS cannot see the gateway file.

Fix:

1. Confirm bpay.php is located at /modules/gateways/bpay.php.
2. In WHMCS Admin, activate BPAY under Payment Gateways.
3. If it still doesn’t appear, clear WHMCS template cache:
   Utilities > System > System Cleanup > Empty Template Cache

Issue: “License Status: Licensing helper not loaded”

Cause: The module cannot load the Snowtech licensing helper file.

Fix:

1. Confirm the file exists: /modules/gateways/bpay/licensing.php
2. Confirm permissions allow PHP to read it (typical: 644).
3. Confirm the folder permissions (typical: 755).

Issue: “License Status: Invalid / Expired / Suspended / No key”

Cause: The license key is missing or not valid.

Fix:

1. Open BPAY gateway settings and re-enter the Snowtech License Key.
2. Save changes and refresh the page to re-check the status.
3. If the status remains invalid, confirm the license is issued for the correct domain/installation.

Issue: BPAY details show but the “Reference” looks wrong

Cause: CRN settings may not match your desired format (invoice vs client based), or a prefix/min-length is applied unexpectedly.

Fix:

1. Check CRN Source:
   • invoiceid = unique per invoice (recommended for reconciliation)
   • userid = consistent per client
2. Check CRN Prefix and remove it if not required.
3. Check CRN Min Length and remove/adjust it if references are longer than expected.

Issue: BPAY logo does not display

Cause: The image URL is blank, unreachable, or blocked by mixed content rules.

Fix:

1. Confirm BPAY Image URL is a valid public URL.
2. Use https:// to avoid mixed content warnings on secure invoice pages.
3. If you do not want a logo, leave the field blank and the gateway will display a text label instead.

Issue: Custom HTML is not showing as expected

Cause: The Custom HTML field overrides the default output, and placeholders must be typed correctly.

Fix:

• Confirm your HTML includes placeholders exactly as:
  • BILLERCODE
  • CUSTREF
• Remove Custom HTML temporarily to confirm the default output works.

Issue: Invoices aren’t being marked “Paid” automatically

Expected behaviour: BPAY is an offline payment method. WHMCS will not automatically confirm payment.

Fix / Process:

1. Reconcile BPAY deposits in your bank merchant reporting.
2. Apply payments to invoices in WHMCS manually (or via a custom import/reconciliation process).

Still stuck?

If you need help, send Snowtech Support the following:

• Your WHMCS version and PHP version
• A screenshot of the BPAY gateway settings (hide the license key)
• The exact error message shown (if any)
• The invoice ID you tested with