Knowledgebase

This guide explains how to configure the Snowtech BPAY Gateway in WHMCS, including your Biller Code, logo, CRN settings, and optional custom display HTML.

Where to configure

In WHMCS Admin go to:
Configuration > System Settings > Payment Gateways
Then open the BPAY gateway settings.

Gateway settings explained

License Key

• License Key: Enter your Snowtech license key for this module.
• License Status: Shows the current status (e.g. Active/Invalid/Expired).

Biller Code

• Biller Code: Your BPAY Biller Code provided by your bank.
• Customers use this code along with the reference number to pay via their bank.

BPAY Image URL

• BPAY Image URL: A public URL to a BPAY logo image.
• Recommended: Use an https:// URL.
• If left blank, the gateway will display a simple BPAY label instead of an image.

CRN Source

• invoiceid (recommended): Generates a unique reference per invoice.
• userid: Generates a reference based on the client ID (same reference across invoices).

CRN Prefix (optional)

• Add a numeric prefix if your bank has specified a required reference format.
• Only digits should be used. Any non-numeric characters are ignored.

CRN Min Length (excluding check digit)

• If set, the reference number is padded with leading zeros to at least this length (before the check digit).
• Example: setting 5 ensures a minimum base length of 5 digits, plus a check digit added at the end.

Custom HTML output (optional)

By default, the module displays a standard BPAY info table. If you want to control the output, you can paste your own HTML into Custom HTML.

Supported placeholders

• BILLERCODE – replaced with your configured Biller Code
• CUSTREF – replaced with the generated Customer Reference Number

Example Custom HTML

<div style="border:1px solid #ddd;padding:12px;border-radius:6px;">
  <strong>Pay via BPAY</strong><br>
  Biller Code: <strong>BILLERCODE</strong><br>
  Reference: <strong>CUSTREF</strong>
</div>

Recommended configuration (most businesses)

• CRN Source: invoiceid
• CRN Prefix: (leave blank unless your bank requires it)
• CRN Min Length: 5 or 6 (optional preference)

Testing your configuration

1. Create or locate an unpaid test invoice.
2. Open the invoice in the client area.
3. Select BPAY as the payment method.
4. Confirm the Biller Code and Reference are displayed correctly.

Next: See the related article: Troubleshooting the Snowtech BPAY Gateway.