FB Checkout URL Handler for Woocommerce

WC requires at least: 3.0
WC tested up to: 8.0

If you find this plugin helpful, please consider buying me a coffee. If you need website help, please consider using Pixel Canopy. Get more info about our services at https://pixelcanopy.com.

Handle Facebook Commerce Platform checkout URLs for WooCommerce. Because Facebook decided to make this unnecessarily complicated for all WooCommerce store owners!

To install, just download the zip file and upload it through the WP Add Plugin interface.

Disclaimer!!!!

This was somewhat hastily vibe-coded with AI, so there are probably some bugs, but it's tested and works for normal situations.

Description

This plugin handles Facebook Commerce Platform checkout URLs so your customers can seamlessly purchase from Facebook ads and shops. Because apparently Facebook decided to make this unnecessarily complicated for all WooCommerce store owners!

When Facebook discontinued on-platform checkout, they introduced a new system where customers are redirected to your website with product information in the URL. This plugin automatically processes those URLs, adds the products to the customer's WooCommerce cart, and redirects them to either the cart or checkout page.

Why am I making this plugin and not Facebook themselves? Who knows?!?!? Maybe they ran out of money for developers. Maybe they hate you, me, and all of us (except Shopify users, those guys are cool. Works right out of the box for those guys). Anyway, who cares? This plugin will be totally irrelevant in... oh, probably 2027 when FB replaces the Commerce Manager entirely with the new Economy Manager plugin, where you'll create your own free economy, mediated by FB, but not checkout though, just shopping, but sometimes checkout, but only if the customer uses IG pay, but only for certain shops - documentation unclear. But your Commerce Manager will DEFINITELY BE DISABLED IF YOU DON"T UPGRADE TO THE NEW ECONOMY MANGER PLUS by building an altar on your coffee table, adorning it with a pair of Meta Glasses and praying to Zuck while wearing one of their VR headsets. I look forward to making a WooCommerce plugin for that.

How It Works

1. Customer clicks "Buy Now" on Facebook
2. Facebook redirects to your site: yoursite.com/facebook-checkout?products=123:2&coupon=SAVE10
3. Plugin processes the URL and adds products to cart
4. Customer is redirected to cart or checkout page
5. Customer completes purchase on your site

Product ID Matching

The plugin tries to match Facebook product IDs in this order:

1. WooCommerce Product ID
2. Product SKU
3. Custom field "facebook_content_id" (for different IDs)

Meta Pixel Events (as of 1.1.0)

The plugin also fires Meta Pixel standard events for WooCommerce: ViewContent (single product pages), AddToCart (both AJAX/shop and single-product adds), and Purchase (order received page). The events prefer the per-product "facebook_content_id" field for content_ids and fall back to the WooCommerce product ID when it's empty.

IMPORTANT: This plugin does NOT initialize a pixel. It only fires track events against an existing fbq. Your theme (or another plugin) must load the base Meta Pixel code (the fbq init + PageView snippet) in the page head. If no pixel is present, the events no-op silently. Variations are not handled — the facebook_content_id field lives on the parent product.

Installation

1. Upload the plugin files to /wp-content/plugins/ directory, or install through WordPress admin
2. Ensure WooCommerce is installed and activated
3. Activate the plugin through the 'Plugins' menu in WordPress
4. Go to Settings → FB Checkout Handler to configure the plugin
5. Copy your checkout URL and paste it in Facebook Commerce Manager

Facebook Commerce Manager Setup

1. Go to Facebook Commerce Manager
2. Navigate to Commerce → Settings → Checkout
3. Paste your checkout URL: yoursite.com/facebook-checkout
4. Save settings and test

Important Notice

If Facebook is passing random Content ID's in the url, you will have to MANUALLY UPDATE every single you product on your site with the custom field "facebook_content_id". (Thanks, Zuck!) To add Facebook Content IDs to your products:

Method 1 - Individual Product Edit:

1. On your site dashboard, go to Products → All Products
2. Click "Edit" on any product
3. In the Product Data section, General tab, look for the "Facebook Content ID" field (also can see it in the Custom Fields section)
4. Enter the Content ID from your Facebook Commerce Manager
5. Update the product

Method 2 - Quick Edit (Faster for Multiple Products):

1. On your site dashboard, go to Products → All Products
2. Hover over any product and click "Quick Edit"
3. Look for the "Facebook Content ID" field at the bottom
4. Enter the Content ID and click "Update"

Frequently Asked Questions

Does this work with Facebook Shops?

Yes! This plugin works with Facebook Shops, Instagram Shopping, and any Facebook Commerce Platform feature that uses checkout URLs.

What if my Facebook product IDs don't match my WooCommerce product IDs?

No problem! The plugin can match by SKU or you can use the custom "Facebook Content ID" field on each product to specify the exact ID Facebook will send.

Can I redirect customers directly to checkout?

Yes! In the plugin settings, you can choose to redirect customers to either the cart page (so they can review) or directly to the checkout page for a streamlined experience.

Will this work with my existing cart contents?

By default, the plugin clears the cart before adding Facebook products to avoid confusion. This can be disabled in settings if you prefer to add to existing cart contents.

What happens if a product is out of stock?

The plugin checks stock availability and will show an error message if a product is out of stock, rather than adding it to the cart.

Does this support variable products?

The plugin works with simple products. Variable product support depends on how Facebook sends the variation information in the URL.

Can I debug issues?

Yes! Enable debug mode in the settings to log all Facebook checkout requests to your WordPress error log.

Changelog

1.1.0

• Added Meta Pixel standard events: ViewContent, AddToCart, and Purchase
• Events use the facebook_content_id field with fallback to the WooCommerce product ID
• Note: requires the base pixel (fbq init) to be loaded by the theme; events no-op if absent. Variations not handled.

1.0.0

• Initial release
• Facebook Commerce Platform checkout URL handling
• Multiple product support with quantities
• Coupon code application
• Product matching by ID, SKU, or custom field
• Configurable cart clearing
• Configurable redirect destination (cart or checkout)
• Debug logging option
• Admin interface for easy setup
• Error handling and validation
• WooCommerce integration

Upgrade Notice

1.1.0

Adds Meta Pixel ViewContent, AddToCart, and Purchase events. Requires the base pixel (fbq init) to be loaded by your theme.

1.0.0

Initial release. Install to handle Facebook Commerce Platform checkout URLs.

Support

For support, please visit pixelcanopy.com or consider supporting development at ko-fi.com/pixelcanopy.

Important Note: Make sure your Facebook product catalog uses the same IDs as your WooCommerce products (Product ID or SKU). Otherwise, products won't be found and customers will see errors. Check your Facebook Commerce Manager product Content ID fields to see what Facebook will send in the checkout URLs.