> ## Documentation Index
> Fetch the complete documentation index at: https://docs.khaime.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install the KhaimePay plugin for WooCommerce.

# WooCommerce Plugin Installation

## Requirements

* WordPress 5.8+
* WooCommerce 6.0+
* PHP 7.4+
* A [Khaime merchant account](https://app.khaime.com)

## Install

<Steps>
  <Step title="Download the plugin">
    <Card title="Download KhaimePay for WooCommerce" icon="download" href="https://api.khaime.com/wordpress/download/khaimepay-for-woocommerce">
      khaimepay-for-woocommerce.zip
    </Card>
  </Step>

  <Step title="Upload to WordPress">
    Go to **Plugins → Add New → Upload Plugin** and select the zip file. Click **Install Now**.
  </Step>

  <Step title="Activate">
    Click **Activate** after installation completes.
  </Step>

  <Step title="Configure">
    Go to **WooCommerce → Settings → KhaimePay** and enter your credentials.

    [Configuration guide →](/plugins/woocommerce/configuration)
  </Step>
</Steps>

## What Gets Installed

The plugin adds:

* **KhaimePay** payment gateway in WooCommerce → Settings → Payments (works with both classic and block-based checkout)
* **KhaimePay Settings** page under WooCommerce → Settings (with diagnostics panel)
* **Floating currency switcher** on your storefront (auto-injected, configurable per page)
* **Currency Switcher** widget (Appearance → Widgets)
* **Webhook endpoint** at `/wp-json/khaime/v1/webhook`
* `[khaime_currency_switcher]` shortcode
* Automatic multicurrency conversion for all product prices, cart totals, and shipping rates

## Uninstalling

Deactivating the plugin removes all hooks. Deleting the plugin removes:

* All `khaime_*` options from the database
* Cached exchange rates
* Webhook event deduplication records

Order metadata is preserved for record-keeping.