Skip to main content

Shopify Integration


Before you integrate your Shopify Store with DOKU, make sure to complete the steps below:

  1. Create an online store with Shopify.
  2. Register as DOKU merchant here.
  3. Complete the business registration form as described here.
  4. Retrieve the Client ID & Secret Key as described here.
  • You can use Shopify Trial Program and test the integration with your DOKU Sandbox Account. To setup DOKU Sandbox account, follow the steps described here.
  • You might be required by Shopify to subscribe Shopify Paid Plan in order to receive payment in Production (real transaction).
Jokul Checkout will automatically turn off by July 31, 2022

All DOKU users must migrate to new DOKU Payment's App and to start accepting payments.

Integration steps

Setup Notification URL on each Channel

  1. Please setup this Notification URL in each of the payment channel configuration that you would like to integrate:
EnvironmentNotification URL

More details about how to setup this Notification URL, please refer to this section.

Install DOKU Payment for Shopify

  1. Login to your DOKU Back Office
Login to DOKU Back Office account
  1. Login to your Shopify Store
Login to Shopify Store account
  1. Click the following link to install the DOKU Payment for Shopify.

  2. When redirected to Shopify App Store, click Add App on the tab.

Add DOKU Payment's App on your Shopify Store
  1. You will be redirected to Installation page on Shopify. Review and click the Install App button on the tab.
Review and Click Install App
  1. When prompted, confirm Your Store Domain in confirmation page. Click Confirm button.
Confirmation for Store Domain
  1. After you click confirm button, you will be redirected to Payment Settings on Shopify Admin Dashboard. And that page will indicated that your store has been connected to DOKU Payment's App.
DOKU Payment's App has been connected to your Shopify
  1. To activate, Click Activate DOKU Payment button. You can also tick/untick for test mode and payment channel icons in your store.
Activate DOKU Payment
  1. Done. Now your Shopify Store is ready to process payment by DOKU Payment's App !

Testing the Payment in Sandbox Mode

Now you are good to go! You can give it a try. Test Mode can be used to create testing transactions. You can pay the transaction using our Simulator.


For Test Mode, use this credential to see the report in DOKU Back Office.

  1. On your payment settings page, go to Settings > Payment.
  2. Click Manage button on DOKU Payment's App
  3. In the DOKU Payment's App Detail, tick the Enable test mode Option.
  4. Click Save button
  5. Go to your Store view.
  6. Checkout a product and try to complete the process.
  7. Select DOKU Payment as the payment method.
Checkout with DOKU Payment
  1. You will be redirected to the DOKU Payment Page to complete the payment.
Select payment method on DOKU Payment Page
  1. Upon the payment completion, you can redirect back to your store.
Redirect back to Shopify Store

Going Live

If you already have DOKU account on Production verified, you can simply:

  1. Login to your Shopify Store account.
  2. Go to Settings > Payments and click Edit button in the DOKU Payment.
  3. Make sure to uncheck the Test mode.
  4. Click Save button.

Congratulations! You can now accept payment with DOKU in your Shopify Store.


  1. Can I custom the expiry time for payment URL ?

Unfortunately, since Shopify implement Hosted Payment Page, you can't custom expiry time. But, no worries, default expiry time for payment URL is 100 minutes. So your customer have a long time to decide to make a payment. If your customer lost the payment url, don't worry! You can retrieve the payment URL via the admin dashboard in the abandonent cart.

  1. Is it possible to change the payment provider name instead of using DOKU Payment? Unfortunately, in shopify's new platform, this doesn't to be possible.