# Drupal

> Accept Ozow payments on Drupal Commerce with the Ozow module, for Drupal 10 and 11 running Commerce 2 or 3.

Source: https://hub.ozow.com/integration-methods/plugins-and-platforms/drupal/

Accept Ozow payments on your Drupal Commerce store. The Ozow module is compatible with Drupal 10 and
11 running Commerce 2 or 3.

> ℹ️ **Older versions**: Modules for older versions of Drupal are available on request. Contact
> [support@ozow.com](mailto:support@ozow.com) or your account manager if you need a module for an
> older Drupal version.

## Before you start

- You need an active Ozow merchant account. If you don't have one, sign up at [ozow.com/merchants](https://ozow.com/merchants).
- You need a working Drupal 10 or 11 installation with Drupal Commerce 2 or 3 installed and active.
- Ozow only accepts payments in South African Rand (ZAR). Make sure your store currency is set to ZAR.
- You will need admin access to your Drupal installation.

## Download

[Download Ozow Gateway for Drupal](https://ozow-live-cdn.s3.eu-west-1.amazonaws.com/plugins/Drupal.zip)

## Installation

There are two ways to install the Ozow Drupal module, manually or using Composer. Choose the method
that suits your setup.

### Method 1: Manual installation

1. Download the plugin using the link above
2. Extract the zip file
3. Locate the `commerce_ozow` folder inside the extracted files
4. Move or copy the `commerce_ozow` folder into your `website_root/modules` directory
5. Log in to your Drupal admin dashboard
6. Navigate to **Extend**
7. Find **Commerce Ozow** in the module list and install it
8. Navigate to **Store** → **Payment Methods**
9. Click **Add payment method** and select Ozow
10. Complete all fields with your merchant credentials, your site code, private key, and API key are
    available in your [Ozow Dashboard](https://dash.ozow.com)
11. Set **Enable Test Mode** to **Yes** to test your integration, or **No** to go live
12. Click **Save**

### Method 2: Composer installation

1. Download the plugin using the link above
2. Extract the zip file
3. Install the `commerce_ozow` folder into your `website_root/modules` directory using Composer
4. Navigate to **Store** → **Payment Methods**
5. Click **Add payment method** and select Ozow
6. Complete all fields with your merchant credentials
7. Set **Enable Test Mode** to **Yes** to test your integration, or **No** to go live
8. Click **Save**

### Credentials

You will need the following from your [Ozow Dashboard](https://dash.ozow.com):

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

## Support

For assistance with your Drupal integration contact [support@ozow.com](mailto:support@ozow.com) or
reach out to your account manager.