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

# Usage

> How donors complete a Monime-backed GiveWP donation.

## Donation Flow

1. A donor fills out a GiveWP donation form.
2. The donor selects **Monime** as the payment method.
3. GiveWP creates a Monime checkout session using the donation details.
4. The donor is redirected to Monime checkout.
5. The donor completes the payment using the payment channels you enabled.
6. After payment, the donor returns to the site.
7. Monime sends a webhook to confirm the donation.

The redirect handles the user experience, while the webhook confirms the actual payment result. You should rely on the webhook, not only on the browser return, when deciding whether a donation is complete.

## Donation Statuses

| Status        | Meaning                                                                        |
| :------------ | :----------------------------------------------------------------------------- |
| **Pending**   | The checkout session was created, but payment is not yet confirmed.            |
| **Complete**  | The payment was successful and the webhook confirmed it.                       |
| **Failed**    | The donor cancelled the payment or the checkout did not complete successfully. |
| **Abandoned** | The checkout session expired before payment was completed.                     |
| **Cancelled** | The donor explicitly cancelled the payment on Monime.                          |

Depending on your GiveWP configuration, some donations may move from Complete to a final processed state inside GiveWP after Monime confirms the payment.

## Admin Management

### Viewing Donation Details

When viewing a donation inside GiveWP, check the donation notes and payment metadata for Monime references.

Useful details include:

* the Monime session or reference ID,
* the donation amount,
* the final status returned from the webhook,
* and any Monime payload stored for debugging.

### Refunds

<Warning>
  Refunds are not yet supported directly within GiveWP.
</Warning>

To refund a payment:

1. Log in to your [Monime Dashboard](https://my.monime.io).
2. Locate the transaction using the Monime reference found in the donation details.
3. Process the refund from the Monime Dashboard.
4. Update the donation record manually in GiveWP if you need your records to show the refund.

### Logging and Debugging

The GiveWP integration stores useful payment metadata and webhook payloads on the donation record. Use those details, along with your WordPress and PHP logs, when troubleshooting.

If a donor says they paid but the donation still shows as pending, check the webhook delivery first. In most cases, the browser return already happened, but the payment confirmation was never received by WordPress.