Skip to content
Cobalz Affiliate

How it works · WooCommerce

Install Cobalz on WooCommerce in five minutes.

No theme edits. No template overrides. No code. Pair your store with the dashboard, watch the heartbeat go green, configure Mercury, and you're live.

Step by step.

  1. 1

    1. Install the WordPress plugin

    Download cobalz-affiliate.zip from your dashboard onboarding panel (or fetch from wordpress.org once we're listed). Upload via Plugins → Add New → Upload Plugin. Activate.
  2. 2

    2. Generate a pairing code

    In Cobalz dashboard, navigate to Settings → Store connection and click Generate code. The 8-character code is valid for 15 minutes.
  3. 3

    3. Pair from WooCommerce admin

    WP Admin → WooCommerce → Cobalz Affiliate. Paste the pairing code, confirm the API base URL (defaults to https://affiliate.cobalz.com), click Pair. The plugin creates a per-merchant HMAC shared secret and stores it.
  4. 4

    4. Verify the heartbeat

    Within 30 seconds the Cobalz dashboard Overview page should show a green “Connected” dot. If it doesn't, the plugin will retry every 5 minutes via Action Scheduler.
  5. 5

    5. Connect a payout rail

    Settings → Payouts → Connect Mercury. Paste your Mercury API key (we validate it live), pick a checking/savings destination account, click Register webhook. Or skip Mercury and use PayPal / Stripe Connect / Wise instead.
  6. 6

    6. Approve your first affiliate

    Send affiliates to /a/[your-slug]/signup. They register; you approve in Approval queue. We auto-generate a unique coupon and push it to WooCommerce Coupons (if auto_coupon_on_approval is on, which is the default).

What just happened

Tracking is now live on every page of your storefront.

  • Yes The plugin injects t.js via wp_head on every page
  • Yes First-party 90-day cookie + 30-day session id, honour DNT + Consent Mode v2
  • Yes Order webhooks fire HMAC-signed to /api/wc/order
  • Yes Coupon-applied attribution at checkout (no link click required)
  • Yes Refund webhook triggers our clawback decision tree automatically
  • Yes Heartbeat every 5 min for monitoring + plugin version reporting

Next: Recruit affiliates →

Ready to install?

14-day free trial of every paid plan. Free tier covers 25 affiliates.

Start freeSee WooCommerce features