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

# Overview

> Introduction to the Monime GiveWP integration.

The **Monime WordPress** plugin includes a GiveWP adapter for donation flows. It lets donors complete payments through Monime's hosted checkout while keeping donation records and form management inside GiveWP.

In practice, GiveWP remains the system where you manage donation forms, donor records, and donation statuses. Monime handles the payment step itself by creating a hosted checkout session, redirecting the donor to Monime, then returning the donor to your WordPress site after payment.

The GiveWP integration uses Monime's [Checkout Session API](/apis/versions/caph-2025-08-23/checkout-session/object) to create and track each payment session. That gives you a hosted checkout flow instead of handling card or mobile money entry directly on your WordPress site.

## Key Features

* **Hosted Checkout:** Redirects donors to a secure Monime payment page, reducing the amount of payment data handled by your WordPress site.
* **Donation-First Flow:** GiveWP stays responsible for donation forms, donor records, and donation status management.
* **Channel Support:** Accept cards, mobile money, bank transfers, and digital wallets.
* **Provider Controls:** Allow or block specific payment providers for finer routing control.
* **Webhook Status Updates:** Donation completion is confirmed through Monime webhooks, not just the browser redirect.
* **Optional Financial Routing:** Route donation settlement to a specific Monime financial account if needed.
* **One-Time Donations:** Built for standard GiveWP donation flows.
* **Shared Credentials:** Uses the main Monime settings page for API credentials and webhook configuration.

## Requirements

* **WordPress:** 6.2 or higher
* **GiveWP:** Installed and active
* **PHP:** 7.4 or higher
* **Monime Account:** A business account with an active Space, API token, and webhook secret
* **Monime Gateway:** Installed and active so the GiveWP adapter can register itself

You also need to be able to configure inbound webhooks from Monime to your site. If your WordPress installation is behind a firewall, security plugin, or local-only environment, webhook delivery may fail until the endpoint is publicly reachable.

## How It Works

1. A donor opens a GiveWP donation form and selects **Monime** as the payment method.
2. GiveWP passes the donation details to the Monime adapter.
3. The adapter creates a Monime checkout session.
4. The donor is redirected to Monime's hosted checkout page.
5. The donor completes payment using the providers you enabled.
6. Monime returns the donor to your site after checkout.
7. Monime sends a webhook to confirm the donation and update the GiveWP record.

This split is important: the redirect gives the donor a smooth checkout experience, but the webhook is what makes payment confirmation reliable.

## When To Use It

Use the GiveWP integration when you need to:

* collect one-time donations,
* keep donation management inside GiveWP,
* accept payments through multiple Monime channels,
* or settle donations into a specific Monime financial account.

If you are building a custom donation or fundraising flow outside GiveWP, use the custom plugin integration instead.
