> ## 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 GiveWP and Monime issues and fixes.

If you encounter issues with the Monime GiveWP integration, check the following common problems and solutions.

## Common Issues

### "Payment gateway not configured"

**Symptom:** Donors see an error message when trying to pay.

**Cause:** The shared Monime credentials are missing or incorrect in the main Monime settings.

**Solution:**

1. Go to **Monime > Settings**.
2. Verify that both the **API Token** and **Space ID** are filled in.
3. Save the settings again and reload the GiveWP payment page.

### Monime does not appear in GiveWP

**Symptom:** Monime is missing from the list of available donation gateways.

**Cause:** The Monime Gateway plugin, GiveWP, or both are inactive, or the shared settings have not been saved.

**Solution:**

1. Confirm that **Monime Gateway** is active.
2. Confirm that **GiveWP** is installed and active.
3. Verify that the main Monime credentials are saved.
4. Refresh the GiveWP settings page after saving.

If the gateway still does not appear, confirm that no plugin conflict is preventing GiveWP from loading its payment gateway extensions.

### Donations remain pending

**Symptom:** A donor paid, but the donation still shows as pending.

**Cause:** Your site is not receiving or processing webhooks correctly.

**Solution:**

1. Check that the webhook URL is configured in Monime exactly as shown in the plugin settings.
2. Ensure your website is publicly reachable. Webhooks cannot reach `localhost` or password-protected sites.
3. Check whether a firewall or security plugin is blocking the `/wp-json/monime/v1/webhook` route.

### "Invalid Signature" in logs

**Symptom:** The donation does not update and the webhook is rejected.

**Cause:** The Webhook Secret in WordPress does not match the webhook secret configured in Monime.

**Solution:**

1. Copy the signing secret again from the Monime Dashboard.
2. Update the **Webhook Secret** field in Monime settings.
3. Save the settings and test the webhook again.

### Donor is redirected to a 404 page or back to the cart

**Symptom:** After clicking pay, the donor lands on a 404 page or is sent back to the cart.

**Cause:** Permalink settings or a redirect conflict is interfering with the offsite return flow.

**Solution:**

1. Go to **Settings > Permalinks** in WordPress and click **Save Changes** to flush rewrite rules.
2. Confirm that the donation form and success/failed pages exist.
3. Check for redirects introduced by caching, security, or page builder plugins.

## Debugging Tips

If a donation does not complete cleanly, check the following in order:

1. WordPress debug logs or PHP error logs.
2. Monime webhook delivery status.
3. The donation record inside GiveWP.
4. The browser return URL the donor received after payment.

## Support

If you cannot resolve the issue, contact Monime support.

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

When contacting support, include:

1. Your **Space ID**.
2. The donation reference or session ID.
3. The exact time the payment was attempted.
4. A copy of any relevant logs or webhook payloads.