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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.fungies.io/integrations/woocommerce.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.