Title: PixelCue CAPI Events for WooCommerce
Author: storeopswp
Published: <strong>September 30, 2026</strong>
Last modified: September 30, 2026

---

Search plugins

![](https://ps.w.org/pixelcue-capi-events-for-woocommerce/assets/banner-772x250.
png?rev=3720528)

![](https://ps.w.org/pixelcue-capi-events-for-woocommerce/assets/icon-256x256.png?
rev=3720528)

# PixelCue CAPI Events for WooCommerce

 By [storeopswp](https://profiles.wordpress.org/storeopswp/)

[Download](https://downloads.wordpress.org/plugin/pixelcue-capi-events-for-woocommerce.1.0.1.zip)

 * [Details](https://wordpress.org/plugins/pixelcue-capi-events-for-woocommerce/#description)
 * [Reviews](https://wordpress.org/plugins/pixelcue-capi-events-for-woocommerce/#reviews)
 *  [Installation](https://wordpress.org/plugins/pixelcue-capi-events-for-woocommerce/#installation)
 * [Development](https://wordpress.org/plugins/pixelcue-capi-events-for-woocommerce/#developers)

 [Support](https://wordpress.org/support/plugin/pixelcue-capi-events-for-woocommerce/)

## Description

PixelCue CAPI Events for WooCommerce is a lightweight server-side purchase tracking
plugin for WooCommerce stores.

The plugin sends one server-side **Purchase** event to the Meta Conversions API 
when a WooCommerce order first reaches **Processing** or **Completed** status. It
is designed to keep WooCommerce order status handling as the source of truth and
to avoid duplicate Purchase events by storing a sent marker on each order.

Features:

 * Sends WooCommerce Purchase events to the Meta Conversions API.
 * Triggers from WooCommerce order status changes.
 * Sends only for Processing and Completed orders by default.
 * Sends each order only once.
 * Supports Test mode and Live mode.
 * Includes hashed customer matching data when available.
 * Includes `_fbp`, `_fbc`, IP address, and user agent when available.
 * Includes commerce fields such as currency, value, order ID, content IDs, contents,
   and number of items.
 * Compatible with WooCommerce High-Performance Order Storage (HPOS).
 * Provides developer filters for consent checks, allowed statuses, payload customization,
   and API version control.

PixelCue does not add a browser pixel, consent banner, or consent-management interface.
Store owners are responsible for configuring any required consent, privacy disclosures,
and browser-side event deduplication.

### Third-party services

This plugin connects to the Meta Graph API / Conversions API to send configured 
WooCommerce Purchase events.

Service endpoint used by default:

    ```
    https://graph.facebook.com/v25.0/{pixel_id}/events
    ```

Data sent may include:

 * Purchase event name, time, event ID, and order-received URL.
 * Order currency, total value, order ID, item IDs, item quantities, item prices,
   and item count.
 * Hashed customer matching fields such as email, phone, name, city, state, postcode,
   and country when available.
 * `_fbp` and `_fbc` cookies when available.
 * Customer IP address and browser user agent when available.

This data is sent only when the plugin is configured with a Pixel ID and Conversions
API access token, and when an eligible WooCommerce order reaches Processing or Completed
status.

Meta terms and policies:

 * https://www.facebook.com/legal/terms
 * https://www.facebook.com/privacy/policy/
 * https://developers.facebook.com/docs/marketing-api/conversions-api/

### Developer filters

Allow or block a Purchase event before it is sent:

    ```
    pixelcue_capi_events_can_send_purchase_event
    ```

Customize the eligible statuses:

    ```
    pixelcue_capi_events_allowed_purchase_statuses
    ```

Customize the outgoing payload:

    ```
    pixelcue_capi_events_purchase_payload
    ```

Customize the Graph API version:

    ```
    pixelcue_capi_events_api_version
    ```

## Installation

 1. Upload the plugin files to the `/wp-content/plugins/pixelcue-capi-events-for-woocommerce/`
    directory, or install the plugin through the WordPress Plugins screen.
 2. Activate the plugin.
 3. Go to **WooCommerce > PixelCue CAPI**.
 4. Enter your Meta Pixel ID and Conversions API access token.
 5. Choose Test mode or Live mode.
 6. In Test mode, enter the Test Event Code from Meta Events Manager.
 7. Save settings and place a new test order.

## FAQ

### When does PixelCue send a Purchase event?

By default, PixelCue sends one Purchase event when an order first reaches Processing
or Completed status.

### Does PixelCue send events for On hold orders?

No. By default, PixelCue sends Purchase events only for Processing and Completed
orders.

### Does PixelCue send duplicate Purchase events?

PixelCue stores a sent marker on each order after Meta accepts the event. If the
same order changes status again later, the event is skipped.

### Does PixelCue add a browser pixel?

No. PixelCue sends server-side Purchase events only. It does not add browser pixel
code.

### What event ID does PixelCue use?

PixelCue uses this format:

    ```
    wc_order_ORDER_NUMBER
    ```

For browser/server deduplication, your browser Purchase event should use the same
event ID.

### Does PixelCue include a consent banner or consent gate?

No. PixelCue does not include a consent banner or consent-management interface. 
Developers can use the `pixelcue_capi_events_can_send_purchase_event` filter to 
prevent sending when consent is not available.

### Is PixelCue compatible with HPOS?

Yes. PixelCue declares compatibility with WooCommerce High-Performance Order Storage.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“PixelCue CAPI Events for WooCommerce” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ storeopswp ](https://profiles.wordpress.org/storeopswp/)

[Translate “PixelCue CAPI Events for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/pixelcue-capi-events-for-woocommerce)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/pixelcue-capi-events-for-woocommerce/),
check out the [SVN repository](https://plugins.svn.wordpress.org/pixelcue-capi-events-for-woocommerce/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/pixelcue-capi-events-for-woocommerce/)
by [RSS](https://plugins.trac.wordpress.org/log/pixelcue-capi-events-for-woocommerce/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.1

 * Removed the Plugin URI header so the plugin and author URI values are not duplicated
   for WordPress.org submission.

#### 1.0.0

 * Initial release.

## Meta

 *  Version **1.0.1**
 *  Last updated **2 days ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.5 or higher **
 *  Tested up to **7.1.2**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [CAPI](https://wordpress.org/plugins/tags/capi/)[Conversions API](https://wordpress.org/plugins/tags/conversions-api/)
   [ecommerce](https://wordpress.org/plugins/tags/ecommerce/)[woocommerce](https://wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://wordpress.org/plugins/pixelcue-capi-events-for-woocommerce/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/pixelcue-capi-events-for-woocommerce/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/pixelcue-capi-events-for-woocommerce/reviews/)

## Contributors

 *   [ storeopswp ](https://profiles.wordpress.org/storeopswp/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/pixelcue-capi-events-for-woocommerce/)