{"id":316322,"date":"2026-06-29T14:52:17","date_gmt":"2026-06-29T14:52:17","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/ultrafan\/"},"modified":"2026-06-29T14:51:40","modified_gmt":"2026-06-29T14:51:40","slug":"ultrafan","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/ultrafan\/","author":23499451,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.30.1","stable_tag":"1.30.1","tested":"7.0","requires":"6.2","requires_php":"7.4","requires_plugins":null,"header_name":"Ultrafan","header_author":"NewPlay Technology (Ultrafan TM)","header_description":"Connects WooCommerce to the Ultrafan affiliate network \u2014 tracks affiliate clicks, fires conversion pixels, settles COD payments, handles refunds\/cancellations, and sends periodic reconciliation reports.","assets_banners_color":"","last_updated":"2026-06-29 14:51:40","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/ultrafan\/","header_author_uri":"https:\/\/ultrafan.world","rating":0,"author_block_rating":0,"active_installs":0,"downloads":13,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.30.1":{"tag":"1.30.1","author":"ultrafan","date":"2026-06-29 14:51:40"}},"upgrade_notice":{"1.30.0":"

Initial release \u2014 not uploaded in WordPress Plugin Directory.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.jpg":{"filename":"icon-128x128.jpg","revision":3590303,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.jpg":{"filename":"icon-256x256.jpg","revision":3590303,"resolution":"256x256","location":"assets","locale":"","width":256,"height":257},"icon.svg":{"filename":"icon.svg","revision":3590303,"resolution":false,"location":"assets","locale":false}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.30.1"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Settings page<\/strong> \u2014 Configure Merchant ID, API Key, cron schedule, and endpoint URLs under WooCommerce \u2192 Settings \u2192 Integration.","2":"Reconciliation Runs<\/strong> \u2014 History of every reconciliation attempt with status, record count, HTTP response, and date range.","3":"Order meta<\/strong> \u2014 Affiliate tracking data (transaction ID, network, UTM params, conversion\/settlement status) visible on the WooCommerce order detail page."}},"plugin_section":[],"plugin_tags":[369,984,456,550,286],"plugin_category":[35,36,55],"plugin_contributors":[269477],"plugin_business_model":[],"class_list":["post-316322","plugin","type-plugin","status-publish","hentry","plugin_tags-affiliate","plugin_tags-conversion","plugin_tags-marketing","plugin_tags-tracking","plugin_tags-woocommerce","plugin_category-advertising","plugin_category-analytics","plugin_category-seo-and-marketing","plugin_contributors-ultrafan","plugin_committers-ultrafan"],"banners":[],"icons":{"svg":"https:\/\/ps.w.org\/ultrafan\/assets\/icon.svg?rev=3590303","icon":"https:\/\/ps.w.org\/ultrafan\/assets\/icon.svg?rev=3590303","icon_2x":false,"generated":false},"screenshots":[],"raw_content":"\n

Ultrafan<\/strong> is the official WooCommerce integration for the Ultrafan<\/a> affiliate network. It automates the full affiliate lifecycle inside your WooCommerce store without requiring any JavaScript snippets or external tag managers.<\/p>\n\n

Key Features<\/h4>\n\n
    \n
  • Click tracking<\/strong> \u2014 Captures transaction_id<\/code>, network_id<\/code>, offer_id<\/code>, and all UTM parameters from affiliate landing URLs. Parameters are stored in first-party cookies so attribution survives the entire checkout journey.<\/li>\n
  • Conversion pixel<\/strong> \u2014 Fires POST \/conversion<\/code> to the Ultrafan server the moment an order is placed, with full order details (amount, currency, items, payment method).<\/li>\n
  • COD settlement<\/strong> \u2014 When a cash-on-delivery order's invoice is marked paid, the plugin fires POST \/conversion\/settle<\/code> automatically.<\/li>\n
  • Refund & cancellation webhooks<\/strong> \u2014 On credit-memo creation or order cancellation the plugin notifies Ultrafan in real time (POST \/conversion\/refund<\/code>).<\/li>\n
  • Periodic reconciliation<\/strong> \u2014 A configurable cron job (default: Monday 02:00) batches paid orders and refunds into a signed POST \/reconcile<\/code> report. A Run Now<\/strong> button in WP Admin lets you send ad-hoc reports for any date range.<\/li>\n
  • Admin transparency<\/strong> \u2014 A dedicated Ultrafan \u2192 Reconciliation<\/strong> menu in WP Admin shows every reconciliation run with status, record count, HTTP response, and the exact date range covered.<\/li>\n
  • HPOS compatible<\/strong> \u2014 Fully compatible with WooCommerce High-Performance Order Storage.<\/li>\n<\/ul>\n\n

    External Service<\/h4>\n\n

    This plugin communicates with the Ultrafan affiliate API<\/strong> operated by NewPlay Technology:<\/p>\n\n

      \n
    • Service URL:<\/strong> https:\/\/affiliate.newplay.tech<\/code> (production) \/ https:\/\/test-affiliate.newplay.tech<\/code> (test&development)<\/li>\n
    • Endpoints used:<\/strong> \/conversion<\/code>, \/conversion\/settle<\/code>, \/conversion\/refund<\/code>, \/reconcile<\/code><\/li>\n
    • Data sent:<\/strong> 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.<\/li>\n
    • Privacy policy:<\/strong> https:\/\/www.ultrafan.world\/privacy-policy<\/li>\n
    • Terms of service:<\/strong> https:\/\/www.ultrafan.world\/terms-conditions<\/li>\n<\/ul>\n\n

      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.<\/p>\n\n

      Cookies & localStorage<\/h3>\n\n

      Cookies and localStorage parameters are GDPR compliant, as they do not contain and client data, and they are in favour of the client.\nThe parameters are:\n- transaction_id, user id (utm_conten t), conversion id (utm_term) - ultrafan affiliate parameters\n- utm_source=\"ultrafan\", utm_medium=\"affiliate\", utm_campaign=... (not defined, future use) - the merchant to see, that this purchase is from affiliate\n- network_id = whether it is prod\/stage\/test\/dev<\/p>\n\n\n

      From the WordPress Plugin Directory (recommended):<\/strong><\/p>\n\n

        \n
      1. Go to Plugins \u2192 Add New<\/strong> in your WP Admin.<\/li>\n
      2. Search for \"Ultrafan\".<\/li>\n
      3. Click Install Now<\/strong> then Activate<\/strong>.<\/li>\n
      4. Go to WooCommerce \u2192 Settings \u2192 Integration \u2192 Ultrafan Affiliate<\/strong> to enter your credentials.<\/li>\n<\/ol>\n\n

        Manual upload:<\/strong><\/p>\n\n

          \n
        1. Download the plugin zip from the WordPress Plugin Directory.<\/li>\n
        2. Go to Plugins \u2192 Add New \u2192 Upload Plugin<\/strong> and upload the zip.<\/li>\n
        3. Activate and configure as above.<\/li>\n<\/ol>\n\n

          Configuration:<\/strong><\/p>\n\n

          After activation, navigate to WooCommerce \u2192 Settings \u2192 Integration \u2192 Ultrafan Affiliate<\/strong>:<\/p>\n\n\n\n\n Setting\n Description\n\n\n\n\n Merchant ID\n Your shop_id<\/code> from the Ultrafan server. Sent as X-Merchant-ID<\/code> on reconciliation and settlement calls.\n\n\n Merchant Name\n Display name included in reconciliation headers.\n\n\n API Key\n Per-merchant secret provided by NewPlay Technology. Stored encrypted.\n\n\n Enable Reconciliation\n Enables or disables the automatic reconciliation cron job.\n\n\n Cron Schedule\n Standard cron expression \u2014 default 0 2 * * 1<\/code> (Monday 02:00).\n\n\n

          \n

          What affiliate network does this plugin support?<\/h3><\/dt>\n

          This plugin is built exclusively for the Ultrafan<\/strong> affiliate network operated by NewPlay Technology. It is not a generic affiliate plugin.\nThe support is via email help@ultrafan.world.<\/p><\/dd>\n

          What data is sent to the Ultrafan server?<\/h3><\/dt>\n

          Each conversion call includes: an anonymised affiliate transaction ID, the WooCommerce order ID, grand total, currency, normalised payment method code, base64-encoded item list (SKU, name, price, quantity), delivery cost, subtotal, and discount amount. No customer name, email, or shipping address is ever transmitted.<\/p><\/dd>\n

          Is the plugin compatible with WooCommerce HPOS?<\/h3><\/dt>\n

          Yes. The plugin explicitly declares compatibility with WooCommerce High-Performance Order Storage (custom order tables).<\/p><\/dd>\n

          Can I trigger a reconciliation report manually?<\/h3><\/dt>\n

          Yes. Go to WooCommerce \u2192 Ultrafan \u2192 Reconciliation<\/strong>, choose a date range, and click Run Now<\/strong>.<\/p><\/dd>\n

          What payment method codes are sent?<\/h3><\/dt>\n
          \n\n\n Code\n Meaning\n\n\n\n\n COD<\/code>\n Cash on delivery \/ deferred payment\n\n\n WAL<\/code>\n PayPal, Apple Pay, Google Pay, or other digital wallets\n\n\n CRC<\/code>\n Credit\/debit card (Stripe, Braintree, Adyen, etc.)\n\n\n DEF<\/code>\n Bank transfer\n\n\n OTR<\/code>\n Any unrecognised gateway\n\n\n<\/dd>\n

          What happens if the Ultrafan server is unreachable?<\/h3><\/dt>\n

          The plugin retries failed conversion and settlement calls. Reconciliation failures are logged in the Reconciliation Runs<\/strong> admin screen and will be retried on the next cron run (unreconciled records are never lost).<\/p><\/dd>\n

          Does this plugin set cookies?<\/h3><\/dt>\n

          Yes. First-party cookies (ultrafan_transaction_id<\/code>, ultrafan_network_id<\/code>, UTM cookies) are set for 5\u201330 days when a visitor lands via an affiliate link. A long-lived affiliate_ultrafan<\/code> cookie (365 days) is also set for returning-customer attribution. All cookies use SameSite=Lax; Secure<\/code> attributes.<\/p><\/dd>\n\n<\/dl>\n\n\n

          1.30.1<\/h4>\n\n
            \n
          • Added check for network id to avoid invalid captures<\/li>\n<\/ul>\n\n

            1.30.0<\/h4>\n\n
              \n
            • Initial public release (aligned with other stores).<\/li>\n
            • Click tracking with first-party cookies (transaction_id<\/code>, network_id<\/code>, UTMs).<\/li>\n
            • Conversion webhook: POST \/conversion<\/code> with JSON body and API key authentication.<\/li>\n
            • COD settlement webhook: POST \/conversion\/settle<\/code>.<\/li>\n
            • Refund and cancellation webhooks: POST \/conversion\/refund<\/code>.<\/li>\n
            • Reconciliation cron: POST \/reconcile<\/code> with per-merchant API key, refund records included.<\/li>\n
            • Admin UI: Reconciliation Runs log with Run Now button.<\/li>\n
            • HPOS compatibility declaration.<\/li>\n
            • All cookies use SameSite=Lax; Secure<\/code>.<\/li>\n<\/ul>","raw_excerpt":"Connects WooCommerce to the Ultrafan affiliate network - handles clicks, conversion pixels, COD payments, refunds, and sends reconciliation reports.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/316322","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=316322"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ultrafan"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=316322"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=316322"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=316322"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=316322"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=316322"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=316322"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}