Skip to main content
After activating the plugin, you must configure it to connect with your Monime account. Go to Monime > Settings for the shared credentials, then go to GiveWP > Settings > Gateways > Monime to configure the GiveWP-specific gateway options.

​
Main Monime Settings

These credentials authenticate your site with the Monime API.
Keep your API Token secret. Never share it or expose it in frontend code.

​
Webhooks Setup

Webhooks are required for this plugin to work correctly. They ensure your site receives payment confirmations even if the donor closes their browser immediately after paying.
  1. Copy the Webhook URL: In the plugin settings, locate the Webhook URL field and copy it. It will look like https://your-site.com/wp-json/monime/v1/webhook.
  2. Configure in Monime:
    • Log in to the Monime Dashboard.
    • Open the desired Space you want webhook events for.
    • Navigate to Developer > Webhooks.
    • Click Create Webhook.
    • Paste your URL into the Endpoint URL field.
    • Select the following Events:
      • checkout_session.completed
      • checkout_session.expired
      • checkout_session.cancelled
    • Create the webhook.
  3. Set the Webhook Secret (Recommended):
    • When creating the webhook, copy the Generated HMAC Secret or, if you are using ECDSA P-256, copy the Public Key after the webhook is created by clicking the Actions dropdown and then View Public Key.
    • Paste the secret into the Webhook Secret field in the Monime GiveWP plugin settings.
    • This ensures that incoming webhooks actually come from Monime.

​
GiveWP Gateway Settings

The plugin maps these settings directly to the paymentOptions object sent to the Checkout Session API.

​
Gateway Details

​
Channel Control

You can completely disable specific payment channels.

​
Provider Control

For finer control, you can enable or disable specific providers within a channel. You configure this by entering Provider IDs as comma-separated values.
Logic: If an allow list is set, only those providers are shown. If the allow list is empty, all providers are shown except those listed in the disable list.

​
Mobile Money Providers

​
Bank Providers

​
Wallet Providers

​
Common Provider IDs

Note: This list may change. Check the Monime Dashboard or API documentation for the most up-to-date provider IDs.

​
Configuration Checklist

Before you start accepting live donations, confirm the following:
  1. Main Monime settings are saved.
  2. GiveWP gateway settings are saved.
  3. The webhook endpoint is configured in Monime.
  4. The webhook secret matches on both sides.
  5. At least one payment channel is enabled.