Skip to main content
After activating the plugin, configure the shared Monime settings first. Then configure the GiveWP gateway options. The configuration is split into two layers:
  • Main Monime settings store credentials that every Monime integration uses.
  • GiveWP gateway settings control how donations behave inside GiveWP.
This separation is useful when the same site uses Monime in more than one place, because you do not have to duplicate credentials for each integration.

​
Main Monime Settings

Open the Monime settings page in WordPress admin and enter:
  • Monime Token: your API token used to authenticate requests to Monime.
  • Space ID: the Monime business space where the donation payments should be created.
  • Webhook Secret: the secret used to verify incoming webhook events.
Save the settings after entering your credentials.

​
Why These Fields Matter

  • The token allows WordPress to talk to Monime securely.
  • The Space ID ensures the payment is created for the correct Monime business account.
  • The webhook secret protects your site from accepting forged webhook requests.

​
GiveWP Gateway Settings

Open the GiveWP payment gateway settings and configure the Monime section:
  • Gateway title: the label donors see at checkout, such as “Pay with Monime” or “Monime”.
  • Gateway description: short text that explains the payment method to donors.
  • Financial account ID: optional; use this when you want donations to settle into a specific Monime financial account.
  • Disable or enable card payments: controls whether card checkout is available.
  • Disable or enable mobile money: controls whether mobile money options are available.
  • Disable or enable bank transfers: controls whether bank transfer options are available.
  • Disable or enable digital wallets: controls whether wallet options are available.
  • Allowed or disabled provider IDs: lets you narrow the exact providers shown to donors.

​
Provider IDs

Provider IDs are entered as comma-separated values in the fields that accept them. Use them when you want to allow only a specific set of providers or block individual providers from the checkout page. Examples:
  • m17, m18 to allow two specific mobile money providers.
  • slb001, slb003 to allow specific banks.
  • m13 to disable a provider that you do not want to expose.
If the allow list is filled in, only those providers should be shown. If the allow list is empty, the plugin should fall back to the general channel settings and the disable list.

​
Webhook Endpoint

Use this endpoint in your Monime dashboard: https://your-site.com/wp-json/monime/v1/webhook Monime uses the webhook secret to verify incoming events before updating donations. Configure Monime to send payment completion and failure-related events to this endpoint so GiveWP can update the donation record reliably. If your webhook configuration supports event selection, include the events that correspond to:
  • successful checkout completion,
  • expired checkout sessions,
  • cancelled checkout sessions.

​
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.