Skip to main content

Shopify Integration

Requirements#

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

  1. Create an online store with Shopify.
  2. Register as Jokul merchant here.
  3. Complete the business registration form as described here.
  4. Retrieve the Client ID & Secret Key as described here.
NOTE
  • You can use Shopify Trial Program and test the integration with your Jokul Sandbox Account. To setup Jokul 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).

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
Sandboxhttps://api-sandbox.doku.com/middle/v1/shopify/notify
Productionhttps://api.doku.com/middle/v1/shopify/notify

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

Install Jokul Shopify Extensions#

  1. Login to your Shopify Store account.
Login to Shopify Store account
  1. Click the following link to install the Jokul Shopify Extensions.

  2. When prompted, login with your Shopify Store account. And click Install Payment Provider on the tab.

Install Jokul Shopify Extensions
  1. You will be redirected to the Shopify Payment setting page. Then click the Choose alternative payment button on the Alternative payment method section.
Setup Jokul Shopify Extensions
  1. Search Jokul Checkout in the Search field. And you will find Jokul Checkout will be visible in the list.
Search Jokul Shopify Extensions
  1. Fill the Client ID and Secret Key that you retrieved from the Jokul Back Office.
    • If you are using Sandbox Client ID and Secret Key, make sure to check the Test mode
    • If you are using Production Client ID and Secret Key, make sure to uncheck the Test mode
Configure Jokul Shopify Extensions
  1. Click Activate Jokul Checkout button.

Testing the Payment#

Now you are good to go! You can give it a try.

  1. Go to your Store view.
  2. Checkout a product and try to complete the process.
  3. Select Jokul Checkout as the payment method.
Checkout with Jokul Checkout
  1. You will be redirected to the Jokul Payment Page to complete the payment.
Select payment method on Jokul Checkout Page
  1. Upon the payment completion, you can redirect back to your store.
Redirect back to Shopify Store

Going Live#

If you already have Jokul 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 Jokul Checkout.
  3. Input your Production Client ID and Secret Key.
  4. Make sure to uncheck the Test mode.
  5. Click Save button.
Configure Jokul Shopify Extensions for Production

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