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

# Troubleshooting

> Common issues and solutions for the Monime WooCommerce plugin.

If you encounter issues with the Monime WooCommerce plugin, check the following common problems and solutions.

## Common Issues

### "Payment gateway not configured"

**Symptom:** Customers see an error message when trying to pay.
**Cause:** The **API Token** or **Space ID** is missing or incorrect in the plugin settings.
**Solution:**

1. Go to **WooCommerce > Settings > Payments > Monime WooCommerce**.
2. Verify that both fields are filled.
3. Ensure you copied the correct **Space ID** from your Monime Dashboard.

### Orders remain "Pending Payment"

**Symptom:** Customers have paid, and money has left their account, but the WooCommerce order status stays "Pending Payment".
**Cause:** Your website is not receiving or processing **Webhooks** correctly.
**Solution:**

1. Check that you configured the **Webhook URL** in the Monime Dashboard exactly as shown in the plugin settings.
2. Ensure your website is publicly accessible (webhooks cannot reach `localhost` or password-protected sites).
3. Check if you have a security plugin (like Wordfence) blocking incoming REST API requests. Whitelist the `/wp-json/monime/v1/webhook` route.

### "Invalid Signature" in Logs

**Symptom:** You see "Invalid webhook signature" in the logs, and orders don't update.
**Cause:** The **Webhook Secret** in your plugin settings does not match the **Signing Secret** of the webhook in the Monime Dashboard.
**Solution:**

1. Copy the Signing Secret again from the Monime Dashboard.
2. Update the **Webhook Secret** field in WooCommerce.
3. Alternatively, clear the field in WooCommerce to disable signature verification (not recommended for production).

### Checkout Page 404 or Redirect Loop

**Symptom:** When clicking "Place Order", the user is redirected to a 404 page or back to the cart.
**Cause:** Permalink settings issues or API communication failure.
**Solution:**

1. Go to **Settings > Permalinks** in WordPress and click **Save Changes** to flush rewrite rules.
2. Check the **WooCommerce Logs** (`WooCommerce > Status > Logs > monime-woocommerce-...`) for API error messages.

## Support

If you cannot resolve the issue, please contact Monime support.

* **Email:** [support@monime.io](mailto:support@monime.io)
* **Developer Docs:** [https://docs.monime.io](https://docs.monime.io)

When contacting support, please provide:

1. Your **Space ID**.
2. The **Session ID** of a failed transaction (if available in the order notes).
3. A copy of the relevant logs from **WooCommerce > Status > Logs**.