> 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/shopify/shopify-integration-1.md).

# 🇲🇾 Shopify Integration

Integration Guide for Shopify users in Malaysia

<figure><img src="https://1457116080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWIsxU2UGMS7iidoMSuyz%2Fuploads%2Fk7DKT4MSNXtuqQuqbE0p%2Fimage.png?alt=media&amp;token=584f3593-954c-4833-988e-4dcf3f2b13b6" alt=""><figcaption></figcaption></figure>

## Integration Guide <a href="#integration-steps" id="integration-steps"></a>

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

1. Install DOKU Payment App on Shopify App Store.
2. Settings for DOKU Plugins in Shopify.[​](https://dashboard.doku.com/docs/docs/integrations/platform/shopify-integration#install-doku-payment-for-shopify)

#### Step 1: Install DOKU Payment App on Shopify App Store

1. There are 2 ways to start the Integration
   1. **Option 1: Through the DOKU Dashboard**
      1. Log in to [DOKU Dashboard](https://dashboard.doku.com/bo/login).
      2. Navigate to **Integration → Shopify,** then click **Install**
      3. You will be redirected to the Shopify App Store. and click **Install** again to proceed.
   2. **Option 2: Through Shopify Admin**
      1. Log in to your Shopify admin.
      2. Navigate to **Settings → Payments**. Then click Add button.
      3. Search for **DOKU Payment** in search by provider options and click it
2. Both options will direct you to the DOKU Shopify Payment App installation page.

   <figure><img src="https://1457116080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWIsxU2UGMS7iidoMSuyz%2Fuploads%2Fd8QGswPRIMkFLmPM3FQ2%2Fimage.png?alt=media&amp;token=62fec835-4639-49e8-81d6-2cb655720eb2" alt="" width="563"><figcaption></figcaption></figure>
3. After clicking install from previous step, system will check if you have login to DOKU dashboard.
   1. **If you are logged in** to the DOKU Dashboard in another tab on the same device, the system will prompt you to grant permission for DOKU to connect to your Shopify store.
   2. **If you are not logged in** The system will open a new browser tab and redirect you to the DOKU Dashboard login page. After logging in, you will be redirected to the permission page to authorize DOKU to connect to your Shopify store.
4. Click **Allow** to authorize DOKU to connect to your Shopify store.

   <figure><img src="https://1457116080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWIsxU2UGMS7iidoMSuyz%2Fuploads%2FetGsoQsIKD85oI4f1uLf%2Fimage.png?alt=media&amp;token=3506058d-5927-4f84-b8e3-89d33cb6531a" alt="" width="563"><figcaption></figcaption></figure>
5. Once the connection is successful, a confirmation page will appear.

   <figure><img src="https://1457116080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWIsxU2UGMS7iidoMSuyz%2Fuploads%2FtXqRyMsozNSzTQS6Bpsg%2Fimage.png?alt=media&amp;token=e633f47f-2610-40f2-b931-960bb14cdcf5" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
If you manage more then 1 brand, then before step 4 you be promt to choose which brand you want to connect.
{% endhint %}

#### Step 2: DOKU Plugins Setting in Shopify

After connecting your store, activate the DOKU Payment App in Shopify.

1. In DOKU Plugins Settings, enable the toggles for the payment icons you want to display on your Shopify checkout page.
2. Scroll down and click **Activate**.

   <figure><img src="https://1457116080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWIsxU2UGMS7iidoMSuyz%2Fuploads%2FsfrI7pOuLloe1NnbprCt%2Fimage.png?alt=media&amp;token=555cdd4a-e216-4b59-b83a-9ff85441cb2d" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="warning" %}
**Important:** The payment icons displayed on the Shopify checkout page are for display purposes only. They do not indicate which payment methods are available for a transaction. Actual payment method availability depends on your DOKU configuration and the payment methods supported for your store.
{% endhint %}

Your DOKU Payment App is now activated in Shopify and ready to receive payment.

***

## Testing Payments <a href="#testing-the-payment-in-sandbox-mode" id="testing-the-payment-in-sandbox-mode"></a>

To test payments using the DOKU Sandbox environment, complete the following two steps:

1. Connect your Shopify store to your DOKU Sandbox account.
2. Setup payment notification URL in your DOKU Sandbox Dashboard.

#### Step 1 : Connect DOKU Sandbox to your Shopify Store <a href="#testing-the-payment-in-sandbox-mode" id="testing-the-payment-in-sandbox-mode"></a>

1. First, open the **Manage Shopify** page. There are two ways to access this page.

   1. **Option 1: Through the DOKU Dashboard**
      1. Log in to your DOKU Dashboard, navigate to **Integration → Shopify**.
      2. If your Shopify store is already connected, click **Manage**.
   2. **Option 2: Through Shopify Admin**
      1. Open your Shopify admin, navigate to the DOKU Payment App.
      2. Click **More actions → Manage**.

   <figure><img src="https://1457116080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWIsxU2UGMS7iidoMSuyz%2Fuploads%2Fzrcn1Mixf1prqQTKhosq%2Fimage.png?alt=media&amp;token=5bbc4e63-d888-4cb6-a09a-267e0e85d8bc" alt="" width="563"><figcaption></figcaption></figure>
2. On the **Manage Shopify** page, click **Login to Sandbox**.
   1. Click **Allow** to authorize the connection.
3. Once the connection is successful, your connected Sandbox account will be displayed on the **Manage Shopify** page.
4. Go to Payment Settings in Shopify scroll down and activate Test Mode and click save&#x20;

#### **Step 2 : Setup Payment Notification on DOKU Dashboard** <a href="#testing-the-payment-in-sandbox-mode" id="testing-the-payment-in-sandbox-mode"></a>

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

1. Copy the below **Notification URL** dedicated for DOKU Payments on Shopify

```
https://api.doku.com/middle/v2/shopify/notify
```

2. Log in to your **DOKU Dashboard**
   * For testing transactions, visit [DOKU Sandbox](https://sandbox.doku.com/bo/login?utm_source=docs)
3. Navigate to **Settings** > **Webhook,** and create webhook
   1. Description: Shopify 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**
5. Visit your Shopify storefront and check out a product. You will be redirected to DOKU Checkout page, where you can select your preferred payment method. Upon completion of the payment, you will be redirected back to your store. The transaction will be marked as completed, and the order will be confirmed.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.