> ## 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 & Order Management

> Understanding the payment flow and managing orders in WooCommerce with Monime Payment Gateway.

## The Customer Experience

1. **Checkout:** The customer proceeds to checkout and selects **Monime Checkout**.
2. **Redirection:** Upon clicking "Place Order", they are redirected to `https://checkout.monime.io/...`.
3. **Payment:** They choose their preferred payment method (Mobile Money, Card, etc.) and complete the transaction.
4. **Return:** After success, they are redirected back to your store's "Order Received" (Thank You) page.

## Order Statuses

The plugin automatically manages order statuses based on the payment lifecycle.

| Status              | Meaning                                                                                                   |
| :------------------ | :-------------------------------------------------------------------------------------------------------- |
| **Pending Payment** | The order has been created, and the user has been redirected to Monime. The payment is not yet confirmed. |
| **Processing**      | Payment was **successful**. The webhook was received and verified. You can now fulfill the order.         |
| **Failed**          | The payment failed, or the checkout session expired (usually after 30 minutes of inactivity).             |
| **Cancelled**       | The user explicitly clicked "Cancel" on the Monime checkout page.                                         |

<Note>
  If your products are strictly **Virtual** and **Downloadable**, WooCommerce may automatically move the order from "Processing" to **Completed** depending on your store settings.
</Note>

## Admin Management

### Viewing Payment Details

When viewing a single order in **WooCommerce > Orders**, you will see a **Monime Payment Details** box in the sidebar (or below the order details).

It provides:

* **Session ID:** The unique ID for the checkout session (useful for support).
* **Monime Order #:** The transaction reference number from the Monime system.

### Refunds

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

To refund a payment:

1. Log in to your [Monime Dashboard](https://my.monime.io).
2. Locate the transaction using the **Monime Order #** found in the WooCommerce order details.
3. Process the refund from the Monime Dashboard.
4. Manually mark the order as "Refunded" in WooCommerce to keep your records in sync.

### Logging

The plugin logs important events and errors to the WooCommerce logging system. This is useful for debugging.

1. Go to **WooCommerce > Status > Logs**.
2. Select `monime-woocommerce-...` from the dropdown.
3. Click **View**.
