WooCommerce
Install and configure the deema WooCommerce plugin for Kuwaiti dinar stores, add webhook settings, and process refunds from WooCommerce orders.
Install and configure the deema WooCommerce plugin, then use WooCommerce order actions to process deema refunds.
Supported Currency is only KWDThe deema WooCommerce plugin supports stores that use Kuwaiti dinar as the store currency.
Prerequisites
Before you start, complete these steps:
- Sign in to your WordPress admin dashboard.
- Download the deema WooCommerce plugin file from the deema Payment Gateway plugin page.
- Set up your WooCommerce store, including shipping methods and store currency. For WooCommerce setup instructions, see Start with WooCommerce.
- Get your deema API keys for the environment you want to use: Sandbox or Production.
Configure the plugin
- In WordPress admin, go to Plugins > Add New.
- Click Upload Plugin, then click Choose File.

- Select the deema plugin file, install it, and activate the plugin.
- Go to WooCommerce > Settings > Payments.
- Enable deema Payment.
- Open the deema payment settings and enter the API keys for your selected environment: Sandbox or Production.

-
Add your webhook URL in the plugin settings by appending
wc-api/wc_deema/to your website base URL.Example webhook URL:
https://example.com/wc-api/wc_deema/ -
Add the same base URL in the deema merchant portal.
Configure your webhook URL in the deema Merchant Dashboard under Settings → Webhooks for each environment independently.Sandbox: Sandbox Webhook Configuration
Production: Production Webhook Configuration
Configure refunds
-
Sign in to WordPress admin by adding
wp-login.phpto your website base URL.Example WordPress admin login URL:
https://example.com/wp-login.php -
Go to WooCommerce > Orders.

- Open the order you want to refund.
- In the order item section, click Refund.
- Enter the refund amount.
- Click Refund with deema payment.

Optional: Set permalinks for a fresh WordPress install
If you are using a fresh WordPress install, set the permalink structure to Post name before testing payments or refunds.
- In WordPress admin, go to Settings > Permalinks.
- Select Post name.
- Save your changes.

Troubleshooting
| Issue | What to check |
|---|---|
| deema does not appear as a payment method | Confirm that the plugin is installed, activated, and enabled under WooCommerce > Settings > Payments. |
| Webhooks are not received | Confirm that the webhook URL ends with wc-api/wc_deema/ and uses your website base URL. |
| Refund action is unavailable | Confirm that you opened an eligible WooCommerce order and that deema payment is enabled. |
| Payment or refund testing fails on a fresh install | Confirm that Settings > Permalinks is set to Post name. |