About this plugin
Ultrafan is the official WooCommerce integration for the Ultrafan affiliate network. It automates the full affiliate lifecycle inside your WooCommerce store without requiring any JavaScript snippets or external tag managers.
Key Features
- Click tracking — Captures transaction_id, network_id, offer_id, and all UTM parameters from affiliate landing URLs. Parameters are stored in first-party cookies so attribution survives the entire checkout journey.
- Conversion pixel — Fires POST /conversion to the Ultrafan server the moment an order is placed, with full order details (amount, currency, items, payment method).
- COD settlement — When a cash-on-delivery order’s invoice is marked paid, the plugin fires POST /conversion/settle automatically.
- Refund & cancellation webhooks — On credit-memo creation or order cancellation the plugin notifies Ultrafan in real time ( POST /conversion/refund ).
- Periodic reconciliation — A configurable cron job (default: Monday 02:00) batches paid orders and refunds into a signed POST /reconcile report. A Run Now button in WP Admin lets you send ad-hoc reports for any date range.
- Admin transparency — A dedicated Ultrafan → Reconciliation menu in WP Admin shows every reconciliation run with status, record count, HTTP response, and the exact date range covered.
- HPOS compatible — Fully compatible with WooCommerce High-Performance Order Storage.
External Service
This plugin communicates with the Ultrafan affiliate API operated by NewPlay Technology:
- Service URL: https://affiliate.newplay.tech (production) / https://test-affiliate.newplay.tech (test&development)
- Endpoints used: /conversion, /conversion/settle, /conversion/refund, /reconcile
- Data sent: affiliate transaction ID, order ID, order total, currency, payment method (normalised to a short code), base64-encoded item list, delivery cost, subtotal, and discount amount.
- Privacy policy: https://www.ultrafan.world/privacy-policy
- Terms of service: https://www.ultrafan.world/terms-conditions
No personal data (name, email, address) is included in any outbound request. The plugin uses a pre-shared API key (stored in WP options) to authenticate with the server.
Cookies & localStorage
Cookies and localStorage parameters are GDPR compliant, as they do not contain and client data, and they are in favour of the client.
The parameters are:
– transaction_id, user id (utm_conten t), conversion id (utm_term) – ultrafan affiliate parameters
– utm_source=”ultrafan”, utm_medium=”affiliate”, utm_campaign=… (not defined, future use) – the merchant to see, that this purchase is from affiliate
– network_id = whether it is prod/stage/test/dev