WooCommerce (WordPress)

WooCommerce is a WordPress plugin that transforms a WordPress website into a fully functional e-Commerce platform. WooCommerce enables website owners to set up online stores with ease. It provides a range of features for managing products, inventory, orders, and payments, making it a popular choice for businesses and individuals looking to establish an online presence for selling goods or services. With WooCommerce, users can customize their online stores and leverage various extensions and themes to enhance the functionality and appearance of their e-Commerce websites.

---

Requirements

Before you integrate your WordPress website with DOKU, make sure that you have fulfilled the following requirements:

1. Create a website with WordPress

2. Create a DOKU Business Account

3. WordPress 5.6 or higher. This plugin is tested with Wordpress 6.7.2

4. WooCommerce 4.9.0 or higher. This plugin is tested with WooCommerce v8.0.0

5. PHP v5.6 or higher

6. MySQL v5.6 or higher

---

Integration Guide

Step 1: Install DOKU Plugin on WooCommerce

1. Log in to your Wordpress Dashboard

2. Navigate to Plugins > Add New Plugin

3. Search for DOKU Payment, then click Install Now

Step 2: Configure DOKU Payment in WooCommerce

1. Go to WooCommerce > Settings > Payments tab

2. Make sure DOKU-Checkout and DOKU General-Configuration are enabled, then click Manage on DOKU General-Configuration.

3. Configure the following required fields:

   • Enable DOKU: Checkbox must be ticked

   • Environment

     • For testing transactions, select Sandbox

     • For processing real transactions, select Production

   • Sandbox Client ID: Client ID retrieved from DOKU Sandbox
   • Sandbox Secret Key: Secret Key retrieved from DOKU Sandbox
   • Production Client ID: Client ID retrieved from DOKU Dashboard
   • Production Secret Key: Secret Key retrieved from DOKU Dashboard
   • Expiry Time: Checkout page expiry time in minutes

Visit API Keys for instructions on how to retrieve integration credentials (Client ID and Secret Key)

Step 3: Set Up Payment Notification on DOKU Dashboard

If you skip this step, your payment status on Woocommerce Dashboard will not be synced with DOKU Dashboard

1. Copy the Notification URL from the WooCommerce settings (DOKU-General Configuration)

2. Log in to your DOKU Dashboard

   • For testing transactions, visit DOKU Sandbox
   • For processing real transactions, visit DOKU Dashboard
3. Navigate to Settings > Payments Settings, then go to each payment method settings page

1. Set up the payment notification URL for each payment method that you have activated. Visit Set Up Payment Notification for instructions

Once payment notification has been configured, you can start accepting payments with DOKU.

---

Checkout Page Configuration

By configuring your checkout page, you will be able to:

1. Show or hide, and sort payment methods for your customers Choose which payment methods (e.g., cards, e-wallets, and virtual accounts) tp appear on your checkout page. You can also reorder them based on your preference or customer behavior to optimize conversions.

2. Customize the interface Adjust the look and feel of your checkout page to align with your brand. This includes modifying button colors, fonts, logos, and layout to ensure a seamless and branded customer experience.

3. Set a default expiry time Define how long a payment session remains valid before it expires. This is useful for limiting pending transactions and encouraging quicker payments, especially for methods like virtual accounts or retail outlets.

Visit Customize Checkout Page for more detailed information.

---

Error Log

​Error log, also known as doku_log, helps simplify the process of identifying issues related to the payment process when using the DOKU Plugin. If any issues arise while using the plugin, you can contact our support team and provide the doku_log file to assist with troubleshooting. The doku_log file records all transaction activity by date, regardless of the payment method used.

How to Enable and Access the doku_log:

1. Open the WooCommerce_dir directory on your store’s web server.

2. Create a new folder named doku_log in your store’s directory. This enables the plugin to automatically log activity to your web server.

3. Navigate to the doku_log folder and open the log file corresponding to the date of the issue.

4. You can view or download the log file as needed.

If an issue occurs, please send the relevant doku_log file to our support team. This helps us investigate and resolve the issue more efficiently.

---

FAQ

How to retrieve my integration credentials (Client ID and Secret Key) ?

Please refer to the guide on API Keys to obtain your integration credentials.

Why is my payment status not updated on WooCommerce?

Payment notification URL must be set up on DOKU Dashboard for the transaction status to be updated on WooCommerce Dashboard. Please be sure to not skip step number 3 in the Integration Guide section.