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 KWD

The deema WooCommerce plugin supports stores that use Kuwaiti dinar as the store currency.

Prerequisites

Before you start, complete these steps:

  1. Sign in to your WordPress admin dashboard.
  2. Download the deema WooCommerce plugin file from the deema Payment Gateway plugin page.
  3. Set up your WooCommerce store, including shipping methods and store currency. For WooCommerce setup instructions, see Start with WooCommerce.
  4. Get your deema API keys for the environment you want to use: Sandbox or Production.

Configure the plugin

  1. In WordPress admin, go to Plugins > Add New.
  2. Click Upload Plugin, then click Choose File.
  1. Select the deema plugin file, install it, and activate the plugin.
  2. Go to WooCommerce > Settings > Payments.
  3. Enable deema Payment.
  4. Open the deema payment settings and enter the API keys for your selected environment: Sandbox or Production.
  1. 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/
  2. Add the same base URL in the deema merchant portal.

    📘

    Configure your webhook URL in the deema Merchant Dashboard under SettingsWebhooks for each environment independently.

    Sandbox: Sandbox Webhook Configuration
    Production: Production Webhook Configuration

Configure refunds

  1. Sign in to WordPress admin by adding wp-login.php to your website base URL.

    Example WordPress admin login URL:

    https://example.com/wp-login.php
  2. Go to WooCommerce > Orders.

  1. Open the order you want to refund.
  2. In the order item section, click Refund.
  3. Enter the refund amount.
  4. 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.

  1. In WordPress admin, go to Settings > Permalinks.
  2. Select Post name.
  3. Save your changes.

Troubleshooting

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