Ozow Hub

WHMCS

Accept Ozow payments on WHMCS 8.0 and higher with the Ozow payment gateway module.

2 min read
On this page8 sections

Accept Ozow payments on your WHMCS installation. The Ozow WHMCS payment gateway is compatible with WHMCS 8.0 and higher.

Older versions

Modules for older versions of WHMCS are available on request. Contact support@ozow.com or your account manager if you need a module for an older WHMCS version.

Before you start

  • You need an active Ozow merchant account. If you don't have one, sign up at ozow.com/merchants.
  • You need a working WHMCS 8.0 or higher installation.
  • Requires PHP 7.2 or higher.
  • Ozow only accepts payments in South African RandZAR The ISO 4217 code for the South African rand, and the currency every amount on this site is in unless a page says otherwise. Amounts are decimal rand rather than cents, so 100.00 is one hundred rand. (ZAR). Payments in other currencies are not supported.
  • Back up your WHMCS files and database before proceeding.

Download

Download Ozow Gateway for WHMCS

Installation

  1. Download the plugin using the link above
  2. Extract the zip file
  3. Copy the modules folder into your WHMCS root directory, merge if prompted
  4. Log in to your WHMCS admin area
  5. Navigate to Addons → Apps & Integrations
  6. Search for "Ozow" and click Ozow Payment Gateway to activate
  7. Enter your merchant credentials, your site codeSite code The unique code for a site registered under a merchant. A site is a place to transact: a website, or a branch of a store. A merchant can have several, and each transaction names the one it belongs to, so sending the wrong code files the payment against the wrong place., private key, and API key are available in your Ozow Dashboard
  8. Set Test Mode to Yes for testing or No for live payments
  9. Click Save Changes

Credentials

You will need the following from your Ozow Dashboard:

Credential Where to find it
API key Merchant Details section
Private key Merchant Details section
Site code Site section

Upgrading from an older integration

If you are upgrading from the previous "iPay" gateway, remove the old iPay files before installing the Ozow module to avoid conflicts. Delete the following files if they exist:

  • modules/gateways/ipay.php
  • modules/gateways/ipaylib.inc
  • modules/gateways/callback/ipay.php

Once removed, follow the installation steps above.

Uninstalling

To remove the Ozow gateway, deactivate it in your WHMCS admin and delete the following:

  • modules/gateways/ozow.php
  • The entire modules/gateways/ozow/ directory and its contents

Troubleshooting

The gateway does not appear: ensure the module files are in the correct location and that file permissions are set correctly.

Payments are not updating: check the Gateway Log in your WHMCS admin and ensure your server can reach Ozow's API endpoints. If you need to investigate further, enable Debug Logging in the gateway settings to record detailed communication with Ozow.

Important

Disable debug logging in your production environment once you have finished troubleshooting. Debug logs may contain sensitive information.

Support

For assistance with your WHMCS integration contact support@ozow.com or reach out to your account manager.

Last updated