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

# Accept Payments on WooCommerce with the Payzah Plugin

> Install the Payzah Payment Gateway plugin for WooCommerce to accept KNET, Visa, and Mastercard payments on your WordPress store without writing any code.

The Payzah Payment Gateway plugin for WooCommerce adds Payzah as a payment option at your WordPress store's checkout, handling KNET and major credit cards in Kuwaiti Dinars.

<Card title="Payzah Payment Gateway for WooCommerce" icon="wordpress" href="https://wordpress.com/plugins/payzah-payment-gateway-for-woocmmerce">
  Free plugin. Published by Payzah.
</Card>

## Before You Start

* A Payzah merchant account — register through the [Payzah app](http://onelink.to/gjt5ed)
* Your Payzah API key from your dashboard
* WordPress with WooCommerce installed and active
* Administrator access to your WordPress dashboard

## Installation

<Steps>
  <Step title="Install the plugin">
    In your WordPress dashboard, go to **Plugins → Add New** and search for *Payzah Payment Gateway*. Select **Install Now**, then **Activate**.

    If you were given a `.zip` file instead, go to **Plugins → Add New → Upload Plugin**, choose the file, install, and activate.
  </Step>

  <Step title="Open the payment settings">
    Go to **WooCommerce → Settings** and open the **Payments** tab. Payzah will appear in your list of available payment methods.
  </Step>

  <Step title="Enable and configure Payzah">
    Select **Manage** (or **Set up**) next to Payzah, then:

    * **Enable** the payment method so it appears at checkout
    * **Title** — the label customers see at checkout, for example "Pay with KNET or Card"
    * **Description** — optional text shown beneath the payment option
    * **API Key** — paste your private key from the Payzah dashboard
    * **Test mode** — leave enabled while you are testing

    Save your changes.

    <Warning>
      Use your test key while test mode is on, and switch to your production key only when you disable test mode and go live.
    </Warning>
  </Step>

  <Step title="Place a test order">
    With test mode enabled, place an order using the [sandbox test cards](/docs/guides/test-credentials). Confirm the full flow works: checkout, redirect to Payzah, payment, and return with the order marked as paid.
  </Step>

  <Step title="Go live">
    Disable test mode, replace the test key with your production key, and save. Place one small real order to verify, then work through the [Go-Live Checklist](/docs/guides/go-live-checklist).
  </Step>
</Steps>

## What Your Customers See

At checkout, customers select Payzah and are redirected to a secure Payzah-hosted payment page. They choose KNET, Visa, or Mastercard, complete the payment, and return to your store with the order confirmed.

## Refunds

Refunds can be issued from your Payzah dashboard, or programmatically through the [Refund API](/docs/guides/refund).

<Note>
  If your plugin version supports refunding directly from **WooCommerce → Orders**, use the **Refund** button on the order screen. Confirm availability with Payzah support if you do not see the option.
</Note>

## Troubleshooting

| Symptom                                                  | Fix                                                                                                                          |
| -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Payzah does not appear at checkout                       | Confirm the plugin is activated *and* enabled under **WooCommerce → Settings → Payments**                                    |
| Authentication errors on every payment                   | Re-paste the API key with no leading or trailing spaces, and confirm it matches your current mode (test or production)       |
| Test cards rejected                                      | Test cards only work with test mode enabled and a test key configured                                                        |
| Order stays "pending payment" after a successful payment | Check the transaction in your Payzah dashboard. If captured, contact support with the order number and transaction reference |
| Plugin conflicts or blank checkout                       | Temporarily disable other plugins and switch to a default WordPress theme to isolate the conflict                            |

## Support

Contact [Info@payzah.com](mailto:Info@payzah.com) or call [+965 22410760](tel:+96522410760).