> For the complete documentation index, see [llms.txt](https://docs.doku.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.doku.com/accept-payments/integration-tools/e-commerce-and-plugins/woocommerce-wordpress/woocommerce-integration-1.md).

# 🇲🇾 WooCommerce Integration

## Integration Guide

This integration guide consists of 4 **mandatory** steps:

1. Download Woocomerce Plugin
2. Install DOKU Plugin on WooCommerce
3. Configure DOKU Payment in WooCommerce
4. Set Up Payment Notification on DOKU Dashboard

#### Step 1: Download WooCommerce Plugin

<figure><img src="/files/NUXNEz0hJ1Ec2kvD3Q89" alt=""><figcaption></figcaption></figure>

Download the Zip file from the Woocommerce Integration page

1. Login to DOKU dashboard
2. Go to Integration from the side bar, choose Woocomerce
3. Click on Download button

#### Step 2: Install DOKU Plugin on WooCommerce

<figure><img src="/files/kzVNGtCPccvqX6GVxCOJ" alt=""><figcaption></figcaption></figure>

Before installing DOKU Payment, ensure that WooCommerce is already installed and activated on your WordPress site.

1. Go to Plugins from the sidebar then click on Add Plugin -> Upload Plugin
2. Upload the Zip File (from step 1) -> Install Now - > Activate

#### Step 3: Configure DOKU Payment in WooCommerce

<figure><img src="/files/RsPFwMWGI4UOcVySpGkg" alt=""><figcaption></figcaption></figure>

1. Go to WooCommerce (in sidebar) > Settings > Payments tab.
2. Make sure **DOKU Integration** and **DOKU Payments** are enabled and **click** **Manage** on **DOKU Integration**
3. Configure the following required fields:
   * **Enable DOKU**: Checkbox must be ticked
   * **Environment**
     * For testing transactions, select **Sandbox**
     * For processing real transactions, select **Production**
   * **Credential**
     * **Sandbox Client ID**: Client ID retrieved from [DOKU Sandbox](https://sandbox.doku.com/bo/developer/api-keys?utm_source=docs)
     * **Sandbox Secret Key**: Secret Key retrieved from [DOKU Sandbox](https://sandbox.doku.com/bo/developer/api-keys?utm_source=docs)
     * **Production Client ID**: Client ID retrieved from [DOKU Dashboard](https://dashboard.doku.com/bo/developer/api-keys?utm_source=docs)
     * **Production Secret Key**: Secret Key retrieved from [DOKU Dashboard](https://dashboard.doku.com/bo/developer/api-keys?utm_source=docs)
     * <mark style="background-color:yellow;">Enter the Client ID and Secret Key that match the selected environment. Leave the credential fields for other environments empty.</mark>
   * **Expiry Time**: Checkout page expiry time in minutes
   * **Abandoned Checkout:** Checkout link can be extended past expiry time if toggled on
   * **Duration Abandoned Checkout:** Maximum time the checkout link stays active after expiration

{% hint style="info" %}
Visit [Set Up Integration](/get-started/manage-business/set-up-integration.md#api-keys) for instructions on how to retrieve integration credentials (Client ID and Secret Key)
{% endhint %}

{% hint style="info" %}
For Malaysia sandbox account, register at [DOKU Sandbox Registration](https://sandbox.doku.com/bo/sandbox-registration=country=MY)
{% endhint %}

#### Step 4: Set Up Payment Notification on DOKU Dashboard

{% hint style="warning" %}
If you skip this step, your payment status on WooCommerce Dashboard will not be synced with DOKU Dashboard
{% endhint %}

<figure><img src="/files/Ikwej72E2pfD9GSfrJOT" alt=""><figcaption></figcaption></figure>

1. Copy the **Notification URL** inside the DOKU Integration Settings (Woocomerce Dashboard)
2. Log in to your **DOKU Dashboard**
   * For testing transactions, visit [DOKU Sandbox](https://sandbox.doku.com/bo/login?utm_source=docs)
   * For processing real transactions, visit [DOKU Dashboard](https://dashboard.doku.com/bo/dashboard?utm_source=docs)
3. Navigate to **Settings** > **Webhook,** and create webhook
   1. Description: WooCommerce Webhook
   2. URL Endpoint: Notification URL from step 1
   3. Payment Channel: Select all payment methods.
4. If you have Card payments activated, Navigate to **Settings > Credit Card**
   1. Go to **Payment Configuration** tab
   2. Paste the Notification URL in the **Payment Notification URL** section
   3. Click **Submit**

{% hint style="info" %}
You can use the `....doku/notification` endpoint for all payment methods (including QRIS) if you are using WooCommerce version **1.3.26** and above.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.doku.com/accept-payments/integration-tools/e-commerce-and-plugins/woocommerce-wordpress/woocommerce-integration-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.