Skip to content
Cobalz Affiliate

WooCommerce integration

The WooCommerce affiliate plugin built like a SaaS, not a 2014 plugin.

5-minute install. HMAC-signed outbox with retry. PII hashing on the WC side. Real WooCommerce Subscriptions support. No theme edits required.

Start free trialSetup walkthrough

What ships

One plugin, complete WooCommerce coverage.

Order hooks

woocommerce_checkout_order_processed, woocommerce_new_order, woocommerce_order_status_changed.

Refund hooks

woocommerce_order_refunded → triggers our clawback decision tree.

Subscription hooks

Subscription cancel / hold / pending-cancel / switch_completed.

Coupon hooks

Auto-pushed coupons, applied-coupon attribution at checkout.

Product hooks

Created / updated / deleted, so per-product commission rules stay in sync.

Pairing flow

8-character pairing code generates a per-merchant HMAC shared secret. Stored in Vault.

Heartbeat

Every 5 min via Action Scheduler. Dashboard green-dot status.

Outbox queue

wp_cobalz_outbox table with backoff, retry, dead-letter. Survives transient platform downtime.

Storefront tracker

t.js loaded via wp_head with merchant + API URL data attrs. ~1.6 KB gzipped.

Setup

From "no plugin" to "first commission" in five minutes.

  1. 1

    Install the WordPress plugin

    Download cobalz-affiliate from your dashboard, upload via Plugins → Add New → Upload Plugin. Activate. Or grab it from the WordPress.org plugin directory once we list there.
  2. 2

    Generate a pairing code

    In the Cobalz dashboard go to Settings → Store connection and click Generate code. The code is valid for 15 minutes.
  3. 3

    Pair from WooCommerce

    In WP admin: WooCommerce → Cobalz Affiliate, paste the pairing code, click Pair with Cobalz. The plugin creates an HMAC shared secret and stores it in your dashboard's Vault.
  4. 4

    Watch the heartbeat go green

    The plugin checks in every 5 minutes via Action Scheduler. Within 30 seconds you should see a green dot in the dashboard overview.
  5. 5

    Approve your first affiliate

    Send affiliates to /a/<your-slug>/signup. Approve in Approval queue. We auto-generate a unique coupon code and push it to WooCommerce Coupons.
Detailed walkthrough →

Why it's better

What modern WordPress affiliate plugins still don't do.

  • Yes Real refund clawback (most plugins void everything when a refund hits).
  • Yes Subscription-aware: detects renewals vs new sign-ups vs trials, applies per-merchant strategy.
  • Yes PII hashed at the WC layer with a per-merchant salt.
  • Yes HMAC-signed outbox with backoff so transient platform downtime doesn't lose orders.
  • Yes Multi-tenant by design — same WC site can pair with multiple Cobalz merchants if you split brands.
  • Yes Modern PHP 8.1 codebase, namespaced, PSR-4. PHPUnit tests on 8.1, 8.2, 8.3.

FAQ

WooCommerce questions.

Do I need to modify my WooCommerce theme?+
No. The plugin injects the t.js tracker via wp_head. No theme edits, no shortcodes, no template overrides.
Does it work with WooCommerce Subscriptions?+
Yes. The plugin detects subscriptions via wcs_order_contains_subscription and enriches the order payload with subscription_id, is_renewal, and is_trial fields. Recurring commissions are configurable at the merchant level.
What about coupon-only attribution (no clicked link)?+
Yes — when a customer applies an affiliate-tagged coupon at checkout, attribution falls back to coupon. The hooks/AppliedCoupon module fires a server event the moment the coupon applies.
How does the plugin handle WC plugin conflicts?+
The plugin only reads — it never modifies orders, products, or customers. The single write is _cobalz_session_id meta on the order, used to join clicks to orders server-side.
What WordPress + WooCommerce versions are supported?+
WordPress 6.0+, WooCommerce 7.0+, PHP 8.1+. Tested on the latest 3 majors of each.

Install the plugin in five minutes.

Free for up to 25 affiliates. No credit card. Cancel anytime.

Start freeRead the docs