Magento
Accept Ozow payments on Magento 2.4.x with the standard payment gateway module, plus modules for Capitec Pay, Voucher and Buy Now Pay Later.
On this page9 sections
Accept Ozow payments on your Magento store. Ozow provides a standard payment gateway module for Magento 2.4.x, as well as additional payment-specific modules for Capitec PayCapitec Pay Capitec's own payment method. The payer gives a cellphone, account or ID number rather than card details, and approves the payment in the Capitec app, so no card number and no banking login is ever entered at checkout. It gets its own button rather than sitting inside the bank list, and it requires Customer Identity Verification.Capitec, Voucher, and Buy Now Pay Later (Happy Pay).
Older versions
Modules for older versions of Magento are available on request. Contact support@ozow.com or your account manager if you need a module for an older Magento 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 Magento 2.4.x installation.
- 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.00is one hundred rand. (ZAR). You will need to add ZAR as a currency in your Magento store before activating the module. - You will need command line (CLI) access to your Magento server to complete the installation.
Ozow Gateway for Magento
The standard Ozow gateway enables your customers to pay using any Ozow-supported payment method at checkout.
Download Ozow Gateway for Magento
Installation
Step 1: Add ZAR as a currency
- In your Magento admin panel, navigate to Stores → Configuration → General → Currency Setup
- Add ZAR under Currency Symbols and Rates
Step 2, Upload the module
- Download the plugin using the link above
- Extract the zip file
- Upload the
Ozowfolder into your Magento directory atmagentorootfolder/app/code/
Note
This will not override any existing files on your system.
Step 3: Run the installation commands
Run the following commands in order from your Magento root directory:
php bin/magento module:enable Ozow_Ozow
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento indexer:reindex
php bin/magento cache:clean
Step 4, Configure the module
- Log in to your Magento admin panel
- Navigate to Stores → Configuration → Sales → Payment Methods
- Click on Ozow
- Enter your merchant credentials, your API key, private key, and 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. are available in your Ozow Dashboard
- Click Save Config
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 |
Payment-specific modules
In addition to the standard gateway, Ozow provides dedicated modules for specific payment methods. These can be installed alongside the standard gateway to offer additional payment options at checkout. The installation process for each follows the same pattern as the standard gateway.
Capitec Pay via Ozow
Enables Capitec Pay as a standalone payment method at checkout.
Installation
Step 1: Add ZAR as a currency (skip if already done)
In your Magento admin panel, navigate to Stores → Configuration → General → Currency Setup and add ZAR under Currency Symbols and Rates.
Step 2, Upload the module
- Download the plugin using the link above
- Extract the zip file
- Upload the
Ozowfolder into your Magento directory atmagentorootfolder/app/code/
Step 3: Run the installation commands
php bin/magento module:enable Ozow_OzowCapitec
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento indexer:reindex
php bin/magento cache:clean
Step 4, Configure the module
- In your Magento admin panel, navigate to Stores → Configuration → Sales → Payment Methods
- Click on Capitec Pay via Ozow
- Enter your merchant credentials
- Click Save Config
Voucher via Ozow
Enables Cash Voucher redemption as a standalone payment method at checkout.
Download Cash Voucher via Ozow
Installation
Step 1: Add ZAR as a currency (skip if already done)
In your Magento admin panel, navigate to Stores → Configuration → General → Currency Setup and add ZAR under Currency Symbols and Rates.
Step 2, Upload the module
- Download the plugin using the link above
- Extract the zip file
- Upload the
Ozowfolder into your Magento directory atmagentorootfolder/app/code/
Step 3: Run the installation commands
php bin/magento module:enable Ozow_OzowVoucher
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento indexer:reindex
php bin/magento cache:clean
Step 4, Configure the module
- In your Magento admin panel, navigate to Stores → Configuration → Sales → Payment Methods
- Click on Cash Voucher via Ozow
- Enter your merchant credentials
- Click Save Config
Buy Now Pay Later: Happy Pay via Ozow
Enables Buy Now Pay Later (Happy Pay) as a standalone payment method at checkout.
Download Buy Now Pay Later: Happy Pay via Ozow
Note
The Happy Pay module requires the Happy Pay widget to be displayed on your product pages. See the Buy Now Pay Later product page for widget implementation guidance.
Installation
Step 1: Add ZAR as a currency (skip if already done)
In your Magento admin panel, navigate to Stores → Configuration → General → Currency Setup and add ZAR under Currency Symbols and Rates.
Step 2, Upload the module
- Download the plugin using the link above
- Extract the zip file
- Upload the
Ozowfolder into your Magento directory atmagentorootfolder/app/code/
Step 3: Run the installation commands
php bin/magento module:enable Ozow_OzowHappyPay
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento indexer:reindex
php bin/magento cache:clean
Step 4, Configure the module
- In your Magento admin panel, navigate to Stores → Configuration → Sales → Payment Methods
- Click on Happy Pay via Ozow
- Enter your merchant credentials
- Click Save Config
Support
For assistance with your Magento integration contact support@ozow.com or reach out to your account manager.
Last updated