Ambikly Docs

Appearance

Affiliate System PRO ​

Tracks ?ref= referrals with a cookie window and records a commission on every qualifying order.

Category: Marketing · Enable at: Ambikly → Add-ons → Affiliate System

What it does ​

Captures a referral code from the URL into a cookie and a de-duplicated visit log, snapshots it onto the order at creation, and writes a pending commission when the order is paid. Affiliates get a shortcode dashboard with their link, visits, referred orders and pending versus paid balances; you mark commissions paid when you settle them.

Capabilities ​

  • ?ref=CODE capture with a configurable cookie window and visit log
  • Referral snapshotted at order creation, so gateway webhooks and offline payments still credit it
  • Commission on subtotal minus discount (not shipping or tax); rate clamped 0–100%
  • Self-referral blocked by matching the order email to the affiliate’s account
  • Reversed on cancel, failure or full refund; prorated on partial refunds
  • Minimum payout threshold before an affiliate can be paid
  • Per-affiliate status (active, suspended, rejected) and rate override

Turn it on ​

  1. Make sure Ambikly Pro is active and your license is activated under Ambikly → Settings → License.
  2. Go to Ambikly → Add-ons, find Affiliate System and switch it on. There is nothing else to install.
  3. Open its settings panel and set the options listed below.
  4. Visit your storefront to confirm the new surface appears: [ambikly_affiliate_dashboard] shortcode — link, rate, visits, orders, pending and paid totals.

Settings ​

Open the add-on's settings panel from Ambikly → Add-ons → Affiliate System.

  • Default commission rate (%)
  • Cookie window (days)
  • URL parameter name
  • Minimum payout

Where it appears ​

On the storefront

  • [ambikly_affiliate_dashboard] shortcode — link, rate, visits, orders, pending and paid totals

In the admin

  • Mark commissions paid
  • Update affiliate status or per-affiliate rate

For developers ​

REST routes

  • GET /ambikly-pro/v1/affiliate/dashboard
  • POST /ambikly-pro/v1/affiliate/register
  • POST /ambikly-pro/v1/affiliate/mark-paid
  • POST /ambikly-pro/v1/affiliate/{id}

Every route enforces the same capability checks as the rest of the API — see the REST API guide.

Core hooks it listens to

  • ambikly_order_created
  • ambikly_order_paid
  • ambikly_order_status_changed
  • ambikly_order_refunded
  • init
  • rest_api_init

The full list is in the hooks reference.

Questions ​

Does it pay affiliates for me? ​

No. It records what is owed and lets you mark commissions paid; the payout itself is settled outside Ambikly.

Do cash-on-delivery orders earn commission? ​

Yes. For payment methods that can’t refund, commission settles when you move the order to processing or completed.

What happens on a partial refund? ​

The pending commission is recomputed in proportion to the refunded amount.

Works well with ​

Multi-vendor · Advanced Reports

Turning it off ​

Switch the add-on off from Ambikly → Add-ons. Its settings and data stay in the database, so turning it back on restores exactly what you had. A lapsed license pauses it the same way — the store keeps selling on the free core, and nothing is deleted.

PROAffiliate System is part of Ambikly Pro

One license covers all 35 add-ons — $199 a year or $549 once for a single site. Nothing here is sold separately.

See pricing →