Shopify
Shopify is an e-Commerce platform that helps merchants to create and manage online stores without the need of extensive technical knowledge. Shopify is suitable for a wide range of businesses, from small startups to large enterprises. It caters to various industries and allows users to sell physical products, digital goods, and services.
Requirements
Before you integrate your Shopify Store with DOKU, make sure that you have completed the following requirements:
Create an online store with Shopify
Create a DOKU Business Account
(Optional) Create a DOKU Sandbox Account. You can use Shopify Trial Program and test your integration with a DOKU Sandbox Account
Integration Guide
Step 1: lnstall DOKU Payment App on Shopify App Store
Log in to your DOKU Dashboard
Log in to your Shopify Store
lnstall DOKU Payment App on Shopify App Store
Step 2: Configure DOKU Payment with Shopify
On DOKU Payment Configuration page, select DOKU
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)
Click Continue Integration With Shopify
You will be redirected to the Payment Settings page in Shopify Admin Dashboard, then switch on the toggles for the payment icons you wish to display on your Shopify checkout page.
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
Copy the below Notification URL
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
Set up the payment notification URL for each payment method that you have activated. Visit Set Up Payment Notification for instructions
Once payment notification has been configured, you can start accepting payments with DOKU.
Checkout Page Configuration
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.
Testing Payments
Please ensure your sandbox credentials have been set up during your integration inStep 2: Configure DOKU Payment with Shopify.
You can simulate transactions in your Shopify store using DOKU Sandbox by following the steps below:
Log in to your Shopify Store
Go to Settings > Payment
Under Supported Payment Methods section, select DOKU | senangPay Payments
Scroll down to Test Mode section and ensure that the toggle is switched on
Click Save
Visit your Shopify storefront and check out a product
At checkout, select DOKU | senangPay Payments as your payment method
You will be redirected to DOKU Checkout page, where you can select your preferred payment method
Complete the payment using DOKU Sandbox Simulator. Visit Simulate Transactions to learn how to use the payment simulator
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.
FAQ
Why is my payment status not updated on Shopify?
Payment notification URL must be set up on DOKU Dashboard for the transaction status to be updated on Shopify Dashboard. Please be sure to not skip step number 3 in the Integration Guide section.
How to retrieve my integration credentials (Client ID and Secret Key)?
Please refer to the guide on API Keys to obtain your integration credentials.
Can I customize the expiry time of the payment URL?
Yes, please refer to the guide on Set Up Expiry Time.
Is it possible to change the payment provider name instead of using DOKU | senangPay Payments?
Currently, it is not possible to change the name of the payment provider.
Is integrating my Shopify store with DOKU free of charge?
Yes, integration with DOKU is free. However, an additional 0.2% fee is applied on top of the standard transaction fee for each payment method. For example, a successful transaction with Bank Transfer payment method will incur a fee of IDR 4,000 + 0.2% (excluding VAT) per transaction via Shopify.
How to enable PayLater payment methods in Shopify?
There are two requirements to enable PayLater payment methods on Shopify:
PayLater payment methods must be activated in your DOKU Dashboard
In your Shopify Dashboard, go to Settings > Checkout, and enable Shipping address phone number
Once the two requirements are met, PayLater payment methods will be available during checkout.
How do I switch payment provider on Shopify to DOKU?
You can only switch the payment provider once you have uninstalled the existing payment service provider app. Once uninstallation is completed, you can follow our Integration Guide for Shopify.
Is it possible to switch store but use my existing business account?
Yes, you can use your existing business account with a different store. However, you must uninstall the app from the current store and complete the integration process again by following our Integration Guide for Shopify.
Please note that the new store must use the same brand name. Using a different brand name may result in account suspension.
My transaction failed to be processed on Shopify. What should I do?
A common reason for a failed transaction is the use of non-alphabetic characters by your customer. Our system only supports alphabetic characters, so please ensure that all input consists solely of alphabetic characters.
If the transaction still fails to process after confirming the input is alphabetic, please submit a support ticket or send an email to [email protected], and our team will assist you in troubleshooting the issue.
Last updated