> For the complete documentation index, see [llms.txt](https://help.fungies.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.fungies.io/integrations/woocommerce.md).

# WooCommerce

### Overview

GitHub: <https://github.com/dukenukemall/fungies-wp-plugin>

```
  ┌─────────────────────┐         ┌─────────────────────┐
  │   WooCommerce Store │         │    Fungies.io        │
  │                     │         │                      │
  │  ┌───────────────┐  │  Sync   │  ┌────────────────┐ │
  │  │   Products    │◄─┼─────────┼──│   Products     │ │
  │  └───────────────┘  │         │  └────────────────┘ │
  │                     │         │                      │
  │  ┌───────────────┐  │ Webhook │  ┌────────────────┐ │
  │  │    Orders     │◄─┼─────────┼──│   Payments     │ │
  │  └───────────────┘  │         │  └────────────────┘ │
  │                     │         │                      │
  │  ┌───────────────┐  │Redirect │  ┌────────────────┐ │
  │  │   Customer    │──┼─────────┼─►│ Hosted Chkout  │ │
  │  └───────────────┘  │         │  └────────────────┘ │
  └─────────────────────┘         └─────────────────────┘
```

Fungies acts as your **Merchant of Record** — handling payments, taxes, and compliance. WooCommerce is your **storefront**. This plugin bridges them seamlessly.

<figure><img src="/files/bEWNI96Q3NNGGInhXz7R" alt=""><figcaption><p>Fungies Checkout as one of the checkout options in WooCommerce</p></figcaption></figure>

### Features

| Feature                | Description                                                                                                           |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------- |
| API Key Management     | Production + Staging keys in WC Settings                                                                              |
| Sandbox / Staging Mode | Routes to `api.stage.fungies.net`                                                                                     |
| Product Sync           | OneTimePayment offers → WooCommerce products (other product types like Digital Downloads, Subscriptions are excluded) |
| Hosted Checkout        | Redirect to Fungies checkout page                                                                                     |
| Webhook Integration    | Real-time order sync                                                                                                  |
| Order Creation         | Auto from payment webhooks                                                                                            |
| Refund Handling        | Auto status updates                                                                                                   |
| Subscription Support   | Create / Renew / Cancel                                                                                               |
| Post-Purchase Redirect | Returns customer to WC order page                                                                                     |
| WooCommerce Logging    | Full audit trail                                                                                                      |

### How It Works

1. **Configure** — Paste your Fungies API keys and Store URL in WooCommerce → Settings → Fungies
2. **Sync Products** — Click "Sync Now" or let the hourly cron pull OneTimePayment products automatically
3. **Customer Shops** — Customers browse your WC store and proceed to checkout
4. **Fungies Checkout** — Customer is redirected to Fungies hosted checkout to pay
5. **Payment Complete** — Fungies redirects customer back to your WooCommerce thank-you page
6. **Webhook Sync** — Fungies sends `payment_success` → plugin completes the WC order

### Requirements

| Requirement     | Version                        |
| --------------- | ------------------------------ |
| WordPress       | ≥ 5.8                          |
| WooCommerce     | ≥ 6.0                          |
| PHP             | ≥ 7.4                          |
| Fungies Account | [Sign up](https://fungies.io/) |

### Installation

#### Manual Upload

1. Download the plugin `.zip` from the [latest release](https://github.com/dukenukemall/fungies-wp-plugin/releases)
2. Go to **WordPress Admin → Plugins → Add New → Upload Plugin**
3. Upload the zip and click **Activate**

#### From Source

```
cd wp-content/plugins/
git clone https://github.com/dukenukemall/fungies-wp-plugin.git
```

Then activate via **WordPress Admin → Plugins**.