Skip to main content

​
WooCommerce Plugin Installation

​
Intro

Khaime for WooCommerce adds Khaime as a payment gateway on your existing WooCommerce store — install the plugin, connect your Khaime account, and multicurrency checkout is live.

​
Context

This is the first step in the WooCommerce integration lifecycle: install → configure → understand the payment flow → multicurrency display → webhooks → developer reference. Nothing else needs to happen before this — the plugin only needs WordPress, WooCommerce, and a Khaime merchant account.

​
Hows

​
Requirements

​
Install

1

Download the plugin

Download Khaime for WooCommerce

khaime-for-woocommerce.zip
2

Upload to WordPress

Go to Plugins → Add New → Upload Plugin and select the zip file. Click Install Now.
3

Activate

Click Activate after installation completes.
4

Configure

Go to WooCommerce → Khaime and enter your credentials.Configuration guide →

​
What gets installed

  • Khaime payment gateway in WooCommerce → Settings → Payments (works with both classic and block-based checkout)
  • Khaime settings page under WooCommerce → Khaime
  • Floating currency switcher on your storefront (configurable per page)
  • Khaime Currency Switcher widget (Appearance → Widgets) and the [khaime_currency_switcher] shortcode
  • Automatic price conversion for product prices, cart totals, and shipping

​
Uninstalling

Deactivating the plugin turns off its features. Deleting the plugin removes its settings and cached data. Your orders and their payment records are kept.

​
Whys

The plugin registers itself as a standard WooCommerce payment gateway rather than a separate checkout page, so it inherits everything WooCommerce already does well — order management, refunds, subscriptions (via WooCommerce Subscriptions), and both the classic and block-based checkout — instead of reimplementing any of it. That’s also why there’s no product sync step in installation: the plugin is product-agnostic and reads whatever total WooCommerce computes at checkout.

​
Why nots

  • Requires WooCommerce. The plugin checks for an active WooCommerce installation and shows an admin notice (rather than fatal-erroring) if it’s missing — it does nothing on a bare WordPress site. For that case, see the WordPress plugins instead.
  • Doesn’t work until configured. Activating the plugin only registers the gateway and settings page — it stays disabled at checkout until you complete Configuration and explicitly enable it.
  • Uninstalling doesn’t touch past orders. Order history and payment references are WooCommerce order data, not plugin data, so removing the plugin never deletes them.