> For the complete documentation index, see [llms.txt](https://changelog.doku.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://changelog.doku.com/october-2026/shopify-onboarding-and-integration.md).

# Shopify Onboarding and Integration

Effective Date: 26 October 2026

Connecting your Shopify store to DOKU is now a guided process. Install the DOKU Payment App, sign in to your DOKU account, and click **Allow** to authorize the connection.

You can also manage your integration through the **Manage Shopify** page in DOKU Dashboard. From there, configure how orders are handled in Shopify, manage abandoned checkout access, and connect your Sandbox account for testing.

For more information, refer to the DOKU Documentation: \[Shopify Integration Guide].

***

### 🔍 What’s New?

The updated DOKU Payment App introduces a guided connection flow and a dedicated page for managing your Shopify integration.

* **Guided connection:** Start the installation from DOKU Dashboard or Shopify Admin, then follow the on-screen instructions to authorize the connection.
* **Brand selection:** If you manage multiple brands, select which brand to connect to your Shopify store.
* **Permission review:** Review the permissions requested by DOKU before authorizing the connection.
* **Centralized integration management:** Use the Manage Shopify page to configure order handling, manage abandoned checkout access, connect Sandbox, or uninstall the integration.

***

### 💡 Why It Matters

**The updated integration flow provides a more straightforward way to connect your Shopify store to DOKU and manage your payment setup.**

With the DOKU Payment App, you can connect the appropriate brand to your store, configure how orders and inventory are handled, and test the integration in Sandbox before accepting live payments.

***

### ⚙️ How to Get Started&#x20;

Follow the steps below to connect your Shopify store to DOKU. The login and brand selection steps only appear when applicable to your account.

#### 1. Install the Shopify Platform

You can start the installation from either DOKU Dashboard or Shopify Admin.

**Option 1: From DOKU Dashboard**

<table data-header-hidden><thead><tr><th width="374"></th><th></th></tr></thead><tbody><tr><td>Log in to DOKU Dashboard.</td><td><p></p><p><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FNRlL3OHJdak9tRx42Q0K%2FScreenshot%202026-10-25%20at%2018.18.12.png?alt=media&amp;token=94efaf2f-df40-4a54-8d53-459bcae4452a" alt="" data-size="original"></p><p></p></td></tr><tr><td>Navigate to <strong>Integration → Shopify</strong> and click <strong>Install</strong>.</td><td><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FiRBeavU1DxbUOYK91mz5%2Fdetail%20plugin.png?alt=media&amp;token=65acfa8e-ac98-4030-aa1f-2ffe4474e429" alt=""></td></tr><tr><td>On the Shopify App Store, select the DOKU Payment App and click <strong>Install</strong>.</td><td><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FcXK0Cw705qG7x5XON8l3%2FScreen%20Shot%202025-09-24%20at%2014.34.29.png?alt=media&amp;token=2dc2e7b1-7419-4b5e-b293-33a28b9a86df" alt=""></td></tr></tbody></table>

**Option 2: From Shopify Admin**

<table data-header-hidden><thead><tr><th width="374"></th><th></th></tr></thead><tbody><tr><td>Log in to DOKU Dashboard.</td><td><p></p><p><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2F9IgKBpoYi9mrUWG5jFkA%2FScreenshot%202026-10-25%20at%2018.31.16.png?alt=media&amp;token=8ed85e25-5489-496c-99ed-c42aea7816cc" alt=""></p><p></p></td></tr><tr><td>Navigate to <strong>Settings → Payments</strong>.</td><td><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FcXK0Cw705qG7x5XON8l3%2FScreen%20Shot%202025-09-24%20at%2014.34.29.png?alt=media&amp;token=2dc2e7b1-7419-4b5e-b293-33a28b9a86df" alt=""></td></tr><tr><td>On the Shopify App Store, select the DOKU Payment App and click <strong>Install</strong>.</td><td><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FHNdnuazIN6KHRo52rM7y%2FScreen%20Shot%202025-09-24%20at%2014.34.56.png?alt=media&amp;token=be788110-4868-4739-8bd6-06658b870939" alt=""></td></tr></tbody></table>

#### 2. Sign In to DOKU

After installation, DOKU checks whether you're already signed in.

* **If you're already signed in:** You'll be redirected to the authorization page.
* **If you're not signed in:** A new browser tab opens the DOKU Dashboard login page. After signing in, you'll be redirected to the authorization page

{% columns %}
{% column width="50%" %}

<figure><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FtrBf1MOjUqg1OZFs0PU3%2Fdetail%20plugin.png?alt=media&amp;token=6fc71b1b-03c0-49b7-b16f-bf5a844f22ba" alt=""><figcaption></figcaption></figure>

Already Signed In
{% endcolumn %}

{% column width="50%" %}

<figure><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FNRlL3OHJdak9tRx42Q0K%2FScreenshot%202026-10-25%20at%2018.18.12.png?alt=media&amp;token=94efaf2f-df40-4a54-8d53-459bcae4452a" alt=""><figcaption></figcaption></figure>

Not Signed In
{% endcolumn %}
{% endcolumns %}

#### 3. Select Your Brand

* If your account manages multiple brands, select the brand you want to connect to your Shopify store, then click Integrate.
* If your account has only one eligible brand, the brand selection step may not be required.

{% columns %}
{% column width="50%" %}

<figure><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FtrBf1MOjUqg1OZFs0PU3%2Fdetail%20plugin.png?alt=media&amp;token=6fc71b1b-03c0-49b7-b16f-bf5a844f22ba" alt=""><figcaption></figcaption></figure>

One Eligible Brand
{% endcolumn %}

{% column width="50%" %}

<figure><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FrYpkLS46EMHPFdAMonMV%2Fdetail%20plugin.png?alt=media&amp;token=3d04f259-49db-420c-8137-6b1463fed5f3" alt=""><figcaption></figcaption></figure>

Multi Brand
{% endcolumn %}
{% endcolumns %}

#### 4. Review and Authorize Permissions

Review the permissions requested by DOKU, including access to brand details, payment status, and customer data. Click **Allow** to authorize the connection.

#### 5. Confirm the Connection

Once the connection is successful, a confirmation page appears. Click **Continue to Shopify** to return to Shopify.

{% columns %}
{% column width="50%" %}

<figure><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FE3LIushejzbFNJAeDKLD%2Fdetail%20plugin.png?alt=media&amp;token=d75a2d60-d50f-46dd-8218-8ce2dd2d5286" alt=""><figcaption></figcaption></figure>

On Progress
{% endcolumn %}

{% column width="50%" %}

<figure><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FAB5AprmFT8yvNZrQa3lL%2Fdetail%20plugin.png?alt=media&amp;token=d6d7c33a-e38a-4239-b340-7d5215936a1e" alt=""><figcaption></figcaption></figure>

Connection Sucesfully
{% endcolumn %}
{% endcolumns %}

#### 6. Activate DOKU Payment

In Shopify Admin, open the DOKU Payment settings. Enable the payment icons you want to display at checkout, then scroll down and click Activate.

<figure><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FhlJpJsnBvKGsdceo96r5%2Fimage%203.png?alt=media&amp;token=c86aa02a-317f-4985-8547-4d91058b0ca2" alt=""><figcaption></figcaption></figure>

***

### 🎛️ Manage Your Integration

You can access the **Manage Shopify** page from either location:

* **DOKU Dashboard:** Go to **Integration → Shopify → Manage**.
* **Shopify Admin:** Open the DOKU Payment App and select **More actions → Manage**.

Once the connection is successful, a confirmation page appears. Click **Continue to Shopify** to return to Shopify.

{% columns %}
{% column width="50%" %}

<figure><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FiIHeeikLLVyStDkhOg2u%2Fdetail%20plugin.png?alt=media&amp;token=cdbd5687-bbc7-42ee-998c-9d84b2a226c2" alt=""><figcaption></figcaption></figure>

DOKU Dashboard
{% endcolumn %}

{% column width="50%" %}

<figure><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FjTZhYTn3xfVoPlfKeZJk%2Fimage%20(1)%201.png?alt=media&amp;token=3901780c-c8cc-4274-99f1-970f7e45cd9b" alt=""><figcaption></figcaption></figure>

Shopify&#x20;
{% endcolumn %}
{% endcolumns %}

The Manage Shopify page provides the following settings.

* **Order Display Type:**
  * **Abandoned Cart:** only paid orders appear in the Orders tab. Unpaid orders are listed under Abandoned Checkout. Stock is reduced only after payment.
  * **Pending Order:** paid and unpaid orders both appear in the Orders tab. Stock is reduced immediately to prevent overselling.
* **Recover Abandoned Cart:** choose Yes or No. When on, customers can still open the checkout page after it expires.
* **Duration:** set how long that access lasts: Tomorrow, 7, 14, or 31 days, or a custom value from 1 to 31 days
* Click **Save** to apply your changes. Click **Uninstall Shopify** to remove the integration. You’ll be asked to confirm first.

<figure><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FnaIcqz70ZuZcGI9FjcLT%2FOrder%20Configuration.png?alt=media&amp;token=dcba1b22-0cf4-4e50-aa90-2ced06a1a61a" alt=""><figcaption></figcaption></figure>

***

### 🧪 Test Payments in Sandbox

Before going live, you can connect a DOKU Sandbox account to test the payment flow.

<table data-header-hidden><thead><tr><th width="374"></th><th></th></tr></thead><tbody><tr><td>Open Manage Shopify and click Log In to Sandbox.</td><td><p></p><p><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FMmwRuSrjz9YMvAiGnqwh%2Fscreencapture-sandbox-doku-bo-login-2025-10-29-15_35_40%201.png?alt=media&amp;token=5a132c59-d4b1-428e-9fe6-2d11345bf595" alt=""></p><p></p></td></tr><tr><td>Log in to your Sandbox account and click Allow. The connected Sandbox account then appears on the Manage Shopify page.</td><td><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FtrBf1MOjUqg1OZFs0PU3%2Fdetail%20plugin.png?alt=media&amp;token=6fc71b1b-03c0-49b7-b16f-bf5a844f22ba" alt=""></td></tr><tr><td><p></p><p>In Shopify Payment settings, turn on <strong>Test mode</strong> and save.</p></td><td><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FQfQOCck7UeXoN7Dw73NG%2Fdetail%20plugin.png?alt=media&amp;token=2295268f-494c-46b5-b10f-0f01dcdbfe0c" alt=""></td></tr><tr><td><p></p><p>Set the payment notification URL in your DOKU Sandbox Dashboard, under <strong>Settings → Payment Settings</strong>, for each payment method you’ve activated.</p></td><td><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FJ4zQHeqGSNmrx8rdONqA%2Fimage%204.png?alt=media&amp;token=09d9aedc-35e8-4433-bc54-022a5f4f5bdf" alt=""></td></tr></tbody></table>

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

> ⚠️ The notification URL is required for Sandbox testing and not required for production. If you skip it, payment status in Shopify won’t sync with DOKU Sandbox.

***

### 🚫 Disconnect Your Sandbox Account

To disconnect the Sandbox account, open the Manage Shopify page and click **Remove Integration** next to the connected Sandbox account.

{% columns %}
{% column width="50%" %}

<figure><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FA6iftrS9cjYHZR53VYU8%2FOrder%20Configuration.png?alt=media&amp;token=cc97f384-7219-4fa4-9870-7945353d8b96" alt=""><figcaption></figcaption></figure>

Ask to Remove Integration
{% endcolumn %}

{% column width="50%" %}

<figure><img src="https://2961485474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XrPPWlRNNTQG72DaVGd%2Fuploads%2FSse8iLb7P5XyWFMCnAu1%2FModal.png?alt=media&amp;token=a84e9048-8e52-4877-b748-726f356af986" alt=""><figcaption></figcaption></figure>

Removed&#x20;
{% endcolumn %}
{% endcolumns %}

***

### &#x20;⚠️ Important Notes

* Only admin users can connect a Shopify store to DOKU. Other users see an **Access Restricted** page and need to contact their admin.
* If your Shopify store is already connected, you’ll see **Account Already Integrated to Shopify**. Manage it from your settings. You’re redirected to DOKU Dashboard automatically after 15 seconds, or you can click **Back to DOKU Dashboard**.
* You can cancel during setup by clicking **Cancel** and confirming **Cancel Integration**. The process stops, and you can integrate again later.
* Payment icons at Shopify checkout are for display only. Actual payment method availability depends on your DOKU configuration.
* The notification URL is only required for Sandbox testing.

***

For assistance, contact our Care Team at <care@doku.com> or (021) 1500963.

***

Thank you and best regards,\
**DOKU Product Team**
