Skip to main content
Accept payments through Shopify on your Komerza store. Komerza creates draft orders on your Shopify store and redirects customers to Shopify’s hosted checkout to complete payment.

​
Prerequisites

1

Create an app in the Shopify Dev Dashboard

  1. Go to the Shopify Dev Dashboard
  2. Click Create an app and give it a name (e.g. “Komerza Integration”)
  3. Set the App URL to https://dashboard.komerza.com
  4. Add this Allowed redirection URL - exactly as written, with no trailing slash:
  5. In Access scopes, paste:
  6. Set the Webhook version to 2026-04
  7. Click Create app
The allowed redirection URL is the step people miss. Shopify requires the exact callback URL to be registered on the app before it will show the install screen, so without it authorization fails no matter how correct your credentials are.
All four scopes are required. Missing any of them will cause connection errors later.
2

Copy your credentials

Open the app’s Settings and copy the Client ID and Client secret.
Keep these secure - they grant access to your Shopify store’s order data.
3

Connect Shopify to Komerza

  1. In your Komerza dashboard, go to Settings → Payment Methods → Shopify
  2. Enter your Shop URL: your myshopify.com domain only, e.g. mystore.myshopify.com
  3. Paste the Client ID and Secret from the previous step
  4. Click Connect Shopify
The Shop URL must be the bare mystore.myshopify.com domain. Do not include https://, do not add a trailing slash, and do not use your custom storefront domain or the admin.shopify.com/store/... address from your browser’s address bar - none of those work for authorization or for creating orders.
4

Authorize the connection

  1. You’ll be redirected to Shopify to approve the app’s permissions
  2. Click Install app on the Shopify authorization screen
  3. You’ll be redirected back to your Komerza dashboard - the connection is now active
Finish this step. Saving your credentials makes Shopify available at your checkout, but orders cannot be created until authorization completes - so an abandoned connection leaves customers unable to pay.
The status will show:
  • Active - Everything is connected and working
  • Inactive - Authorization has not completed, or the credentials are wrong

​
How It Works

  1. A customer selects Shopify at checkout
  2. Komerza creates a draft order on your Shopify store
  3. The customer is redirected to Shopify’s hosted checkout to complete payment
  4. Once payment is confirmed, Komerza automatically marks the order as delivered

​
Managing Payments

  • Refunds - You can issue refunds through Komerza. The refund is processed via the Shopify Orders API and reflected in both platforms.
  • Webhooks - Komerza listens for order and refund events from Shopify to keep everything in sync.

​
Disconnecting Shopify

Go to Settings → Payment Methods → Shopify and click Disconnect. Your existing orders are not affected - only new checkouts will no longer offer Shopify.

​
Troubleshooting

Last modified on August 1, 2026