Adobe Commerce (Magento)
Last updated
Was this helpful?
Last updated
Was this helpful?
Adobe Commerce (Magento) is an e-Commerce platform built on open source technology which provides online merchants with a flexible shopping cart system, as well as control over the look, content and functionality of their online stores. Magento offers powerful marketing, search engine optimization, and catalog-management tools. Magento's ability to scale allows shops with only a few products and simple needs to easily expand to tens of thousands of products and complex custom behavior without changing platforms.
Before integrating your Magento store with DOKU, please ensure that the following requirements have been met:
Create a store with Magento
Create a
Magento v2.3 or higher. This plugin is tested with Magento v2.3.4, v.2.3.6, v.2.4.0, v.2.4.1
PHP v7.4.0 or higher
MySQL v8.0 or higher
Download DOKU Plugin for Magento
Copy Jokul folder into your MAGENTO_DIR/app/code directory on your store's webserver.
Run php bin/magento module:status. You should see Jokul_Magento2 on list of disabled modules.
Run php bin/magento module:enable Jokul_Magento2
Run php bin/magento setup:upgrade
Run php bin/magento module:status again to ensure Jokul_Magento2 is enabled already.
Flush Magento cache by running php bin/magento cache:flush
Compile Magento with newly added module by running php bin/magento setup:di:compile
Flush Magento cache again php bin/magento cache:flush
Log in to your Magento Admin Panel
Navigate to Stores > Configuration
Go to Sales > Payment Methods
Locate DOKU section
Click the dropdown arrow icon to view the details
Configure the following required fields:
Environment:
For testing transactions, select Sandbox
Sandbox Client ID: Client ID retrieved from DOKU Sandbox
Sandbox Secret Key: Secret Key retrieved from DOKU Sandbox
For processing real transactions, select Production
Production Client ID: Client ID retrieved from DOKU Dashboard
Production Secret Key: Secret Key retrieved from DOKU Dashboard
Expiry Time: Expiration time in minutes
Notification URL: Payment notification URL for all payment methods
QRIS Notification URL: Payment notification URL for QRIS payment method
Email Sender Address: You can fill this column with your email address. This will later be used as info to send notifications to your customers
Email Sender Name: You can fill this column with your name. This will be used to email send notifications to your customers
CC Email Adress: You can fill this column other email adress. This will be used to email send notifications to your customers
Email Notifications: You can send an email containing a guide on how to complete the payment using specific payment methods
Click Save Config
If you skip this step, your payment status on Magento Admin Panel will not be synced with DOKU Dashboard
Copy the Notification URL from the Magento Admin Panel
Log in to your DOKU Dashboard
For testing transactions, visit DOKU Sandbox
For processing real transactions, visit DOKU Dashboard
Navigate to Settings > Payments Settings, then go to each payment method settings page
Once payment notification has been configured, you can start accepting payments with DOKU.
By configuring your checkout page, you will be able to:
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.
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.
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, 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:
Open the MAGENTO_DIR directory on your store’s web server.
Create a new folder named doku_log in your store’s directory. This enables the plugin to automatically log activity to your web server.
Navigate to the doku_log folder and open the log file corresponding to the date of the issue.
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.
Visit for instructions on how to retrieve integration credentials (Client ID and Secret Key)
Set up the payment notification URL for each payment method that you have activated. Visit for instructions
Please refer to the guide on to obtain your integration credentials.
