🇲🇾 Shopify Integration

Integration Guide for Shopify users in Malaysia

Integration Guide

This integration guide consists of 3 mandatory steps:

1. Install DOKU Payment App on Shopify App Store
2. Configure DOKU Payment App
3. Set Up Payment Notification on DOKU Dashboard

Step 1: lnstall DOKU Payment App on Shopify App Store

1. Log in to your DOKU Dashboard
2. Log in to your Shopify Store

1. lnstall DOKU Payment App on Shopify App Store

Step 2: Configure DOKU Payment App

1. On DOKU Payment Configuration page, select DOKU Malaysia
2. Configure the following required fields:

   • 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

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

For Malaysia sandbox account, register at DOKU Sandbox Registration

1. Click Continue Integration With Shopify
2. You will be redirected to the Payment Settings page in Shopify Admin Dashboard, where you can switch on the toggles for the payment icons you wish to display on your Shopify checkout page. (Important Note: The payment icons on the Shopify checkout page are only for display and do not indicate the actual payment methods that are available for payment).

Payment Settings on Shopify Admin Dashboard

Shopify Checkout Page

1. Scroll down and click Activate

Step 3: Set Up Payment Notification on DOKU Dashboard

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

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

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

1. Log in to your DOKU Dashboard

   • For testing transactions, visit DOKU Sandbox
   • For processing real transactions, visit DOKU Dashboard
2. 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.
3. 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

---

Testing Payments​

Please ensure your sandbox credentials have been set up during your integration in🇲🇾 Shopify Integration.

You can simulate transactions in your Shopify store using DOKU Sandbox by following the steps below:

1. Log in to your Shopify Store
2. Go to Settings > Payment
3. Under Supported Payment Methods section, select DOKU Payment
4. Scroll down to Test Mode section and ensure that the toggle is switched on
5. Click Save
6. Visit your Shopify storefront and check out a product
7. At checkout, select DOKU Payment as your payment method
8. You will be redirected to DOKU Checkout page, where you can select your preferred payment method
9. Complete the payment using the provided simulator
10. 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.