An order through a referral link was not attributed
Check:
- Is the affiliate active? A pending, rejected or suspended affiliate's link sets no cookie.
- Is the programme on? With Run the affiliate programme off, nothing is attributed.
- Did the visitor already have a referral cookie? With "first" attribution (always, in the free edition) an earlier affiliate keeps the credit for the cookie's lifetime.
- Was it the affiliate's own order? Orders from the affiliate's account, or with their account's email as the billing email, never earn.
- Did the order come through the checkout within the referral window? The cookie lasts 30 days in the free edition, or the days you set in the full edition, and lives in that one browser.
- Does a cache or a cookie-consent tool block the cookie? See below.
Does it work with page caching?
The referral is caught when the page with ?ref= is served by WordPress. A full-page cache that serves a cached copy for ?ref= addresses never runs WordPress, so no cookie is set and no visit is counted. Most cache plugins skip pages with query strings; if yours does not, exclude the ref query argument.
Does it work with cookie-consent banners?
The cookie gmaf_ref is set with WooCommerce's own wc_setcookie(). If your consent tool blocks cookies until consent is given, referrals from visitors who decline will not be tracked.
Does it work with the Checkout block and HPOS?
Yes. Orders from the classic checkout and from the Checkout block are both attributed, and the plugin reads and writes order data through WooCommerce's own order API, so HPOS and the legacy order storage behave the same.
Is commission paid on shipping or tax?
No. It is worked out on the product lines after discounts, net of refunds.
What happens when an order is refunded?
A full refund (order status Refunded), a cancellation or a failure reverses a commission that is waiting or earned. A partial refund re-states the commission on the goods left, at the rate frozen on it: a £100 order at 10% refunded down to £40 pays £4, not £10. A commission that has been recorded as paid is never reversed or rewritten.
Can I change the rate for one affiliate?
Full edition: yes — the Set field in their row. In the free edition everyone earns the one programme rate.
How do I pay my affiliates?
However you already pay people. The plugin never moves money. In both editions, Record payout on the affiliate's row marks their earned commissions as paid, so the ledger — and the Paid out figure on their dashboard — matches what you sent.
Can an affiliate see my customers or orders?
No. Their dashboard shows dates, amounts and statuses only.
The Affiliate tab gives a "page not found"
The plugin flushes the rewrite rules once, after adding the endpoint. If another plugin flushed them before that, go to Settings → Permalinks and press Save Changes.
A rejected applicant wants to try again
They can. A rejected or suspended affiliate is shown the application form again in My Account → Affiliate; applying moves their existing row back to pending, for you to approve or reject. Full edition: Approve applications automatically never reactivates a rejected or suspended affiliate — that always waits for you. You can also press Approve on their row at any time.
I am moving from the free edition to the full edition
Install and activate the full edition. Both editions use the same tables (column for column), the same gmaf_settings option, the same gmaf_ref cookie, the same ref link format, the same order meta and the same My Account endpoint. Every affiliate, every link already shared and every commission carries over. The free edition stands by while the full edition is active.
What happens when I uninstall?
Neither edition ever drops the affiliate or commission tables, and order meta is never removed. They are a ledger of money owed to, or paid to, real people.
- Full edition: deleting it removes
gmaf_settings,gmaf_endpoint_added,gmaf_license, the cached update data and the licence cron event, and flushes the rewrite rules. - Free edition: deleting it removes
gmaf_settingsandgmaf_endpoint_addedonly when the full edition has never been licensed on the site, and flushes the rewrite rules.
If you want the ledger gone, drop the two tables yourself after exporting what you need.
Does the plugin contact any external service?
The free edition makes no HTTP requests. The full edition contacts gatemi.com only for licence checks and updates, once a licence key is entered.
