How it works
- At checkout, the customer chooses the Komerza payment option.
- The plugin creates a Komerza order for the WooCommerce order’s total and sends the customer to the Komerza checkout to pay.
- Komerza tells your site when the payment arrives, and the WooCommerce order is marked paid.
Requirements
- WordPress 6.2, WooCommerce 8.0 and PHP 7.4 or newer.
- A site reachable over HTTPS from the internet, so Komerza can report payments to it.
- A Komerza store with at least one payment method enabled, in the same currency as your WooCommerce shop.
Set up
1
Download the plugin
Download komerza-for-woocommerce.zip, the latest release. Keep it zipped.
2
Install it in WordPress
- In WordPress, go to Plugins → Add New Plugin and click Upload Plugin
- Choose the zip file and click Install Now
- Click Activate Plugin
3
Create an API key
- In your Komerza dashboard, open Developers → API Keys and create a key
- Name it something you will recognise, such as “WooCommerce”
- Give it these permissions: View Stores, View Orders, Create Orders, Create Webhooks and Delete Webhooks
- Copy the key
4
Copy your store ID
In your Komerza dashboard, go to Settings → General. The Store ID is in the Store card, with a copy button next to it.
5
Connect the plugin
- In WordPress, go to WooCommerce → Settings → Payments and open Komerza
- Paste your API key and store ID
- Choose a Default payment method
- Tick Offer Komerza at checkout and click Save changes
Settings
How orders are updated
The plugin keeps each WooCommerce order in step with the Komerza order paying for it.
A WooCommerce order is only marked paid when Komerza has taken at least its total, in the same currency. Anything else is put on hold with a note, so you can check the payment in Komerza before fulfilling the order.
Refunds
Refund the order from your Komerza dashboard. The WooCommerce order is marked refunded automatically.Currency and taxes
Komerza charges in your Komerza store’s currency, so the payment option only appears at checkout when your WooCommerce shop uses the same currency. If they differ, the plugin’s settings page tells you. Komerza charges the total WooCommerce calculates, taxes included. If tax collection is enabled on your Komerza store and set to Exclusive (under Settings → Tax), Komerza adds its tax on top and customers are taxed twice. Set it to Inclusive, or turn tax collection off if you only sell through WooCommerce.With Komerza Pay, Komerza is the seller and adds
VAT where it applies, so a customer paying with Komerza Pay can pay more than
the WooCommerce total.
Updating the plugin
Download the latest release and upload it the same way you installed it. WordPress asks whether to replace the version you have. Choose Replace current with uploaded. Your settings are kept.Troubleshooting
Komerza does not appear at checkout
Komerza does not appear at checkout
Open the plugin’s settings. Check that Offer Komerza at checkout is ticked, that the page says you are connected, and that your WooCommerce currency matches your Komerza store’s.
Saving the settings shows an error
Saving the settings shows an error
Check the API key and store ID, and that the key has all five permissions listed above. If the key was deleted or rolled in Komerza, create a new one and paste it in.
An order stays on Pending payment after the customer paid
An order stays on Pending payment after the customer paid
Komerza could not reach your site to report the payment. Make sure your site is reachable over HTTPS from the internet, and that no security plugin or firewall blocks requests to
?wc-api=komerza. The Webhook Execution Logs card on the order’s page in your Komerza dashboard shows each attempt and why it failed.I moved my site to a new address
I moved my site to a new address
Open the plugin’s settings and click Save changes. The plugin registers its webhook again at the new address.
Where can I see what went wrong?
Where can I see what went wrong?
In WordPress, go to WooCommerce → Status → Logs and choose the log named komerza.