=== RefRef – Referral Program & Refer a Friend for WooCommerce === Contributors: refref Tags: woocommerce, referral program, refer a friend, coupons, rewards Requires at least: 7.0 Tested up to: 7.1 Requires PHP: 8.3 Requires Plugins: woocommerce Stable tag: 0.1.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Make word of mouth work for your WooCommerce store with referral links, friend discounts, and customer coupon rewards. == Description == Make word of mouth part of your store's growth strategy. Give customers a reason to share and their friends a reason to shop. RefRef connects your WooCommerce store to a referral program with friend discounts and coupon rewards for qualifying referrals. = Give customers a reason to share = * Welcome referred friends with discount offers applied as native WooCommerce coupons. * Reward qualifying referrals with percentage discount coupons that only the customer who earned them can use. * Let signed-in customers get a referral link and see their referral and reward history in My Account, after checkout, or on a page with the [refref] shortcode. * Set a reward delivery hold to allow time for returns. A full refund before coupon issuance cancels the pending coupon; coupons already used cannot be recovered. * Configure your referral program, publish its terms, and manage reward delivery in RefRef Console. = Built for your WooCommerce workflow = RefRef supports classic and block checkout and WooCommerce High-Performance Order Storage (HPOS). Captured payments and product-allocated refunds sync through a signed connection. Visitors choose whether to allow referral tracking, and the plugin also respects WordPress Consent API marketing consent when that plugin is installed. Store administrators can use WordPress personal data export and erasure tools for hosted referral records. = A connected RefRef service is required = You need a RefRef account and a connected Workspace and Project. The plugin is free to download; the hosted service offers Free and paid plans. Manage your plan and payments in RefRef Console. Installing or connecting this plugin does not start or change a paid subscription. RefRef is provided by Exa Labs LLC. For support, email help@refref.ai. Read our [Terms of Service](https://refref.ai/terms) and [Privacy Policy](https://refref.ai/privacy). = Requirements and compatibility = WooCommerce 10.9.4 or later and HTTPS are required. Validated combinations include WooCommerce 10.9.4, 11.0.1, and 11.1.2 on WordPress 7.0.6 and 7.1.2. PHP 8.3 and 8.4 have been tested. Multi-currency plugins are not supported. Gateways must call WooCommerce's payment-complete hook; changing an order status alone is not proof of payment. Guests cannot qualify when the Program requires verified first-purchase history. == External service and privacy == This plugin uses [RefRef](https://refref.ai) to store referral records, evaluate reward eligibility, and manage coupon delivery. The service runs at https://core.refref.ai; the merchant manages it at https://app.refref.ai. It is a required service, not an optional analytics integration. By connecting the plugin, the merchant uses the RefRef service under its [Terms of Service](https://refref.ai/terms) and [Privacy Policy](https://refref.ai/privacy). No hosted requests are sent before a store administrator starts the connection and approves a Project in RefRef Console. Connection approval exchanges the store URL, installation identifier, environment, currency, and a connection secret over HTTPS. The merchant authorizes subsequent background payment/refund synchronization and coupon commands. Opening the connected admin page reads the Workspace's plan and limit status. After a visitor consents to referral tracking, the plugin sends the referral handoff and stores the returned referral handle, an opaque random identifier, in the WooCommerce server-side session. A guest uses an opaque session identifier. Signed-in referral sharing and history use the WordPress customer ID. Paid-order synchronization sends order identifiers, timestamps, currency, discounted product amounts, tax, paid totals, paid-history evidence where available, the referral handle, coupon codes, and refund adjustments. It does not send payment-card details, addresses, customer names, or email addresses. Server logs may record request metadata. Customers can withdraw referral-tracking consent with the storefront button. This clears session attribution and removes the session's friend coupon; it does not erase previously recorded orders. Store administrators can use Tools > Export Personal Data and Tools > Erase Personal Data. WordPress uses the request email locally to find customer and guest order identifiers; only those identifiers are sent to RefRef. Erasure deletes hosted referral records as described in the [Privacy Policy](https://refref.ai/privacy). Order and reward accounting records are retained. Deactivation is not an erasure request. == Installation == 1. Install and activate WooCommerce, then install and activate RefRef. 2. Open WooCommerce > RefRef and choose Connect RefRef. 3. Sign in to RefRef Console and approve the intended Workspace and a Project dedicated to this store. 4. In the Project's integration settings, select a referral Program and its coupon delivery hold. Configure and publish its terms in Console. 5. Test referral links and payment/refund handling before opening the Program to customers. == Frequently Asked Questions == = Do customers need an account to share referral links? = Yes. Customers sign in to their account on your WooCommerce store to get a referral link and view their history. They do not need a RefRef Console account. Guest friends can use eligible offers, but cannot qualify when the Program requires verified first-purchase history. = Where do I manage billing? = Use Open RefRef Billing in WooCommerce > RefRef. Plans and payments are managed in Console. There is no checkout or billing configuration in this plugin. = What happens when RefRef is unavailable? = Checkout remains available. Background notifications retry. Referral offers and account history may be temporarily unavailable. = What happens when I deactivate the plugin? = Deactivation expires RefRef coupons so they cannot outlive the plugin's ownership checks. Order metadata and hosted records remain for accounting. Use normal WordPress deactivation before removing plugin files. = Is the plugin source available? = The ZIP includes the complete editable PHP and JavaScript source; no build step or minified bundle is required. Plugin files are licensed under GPLv2-or-later. This license does not apply to the separately hosted RefRef service. == Screenshots == 1. Customers can request a referral link and view referral and coupon reward history in My Account. Demonstration store with synthetic data. 2. A friend's order shows the native WooCommerce discount and adjusted total. Demonstration store with synthetic data. == Changelog == = 0.1.0 = * Initial release candidate: store connection, referral tracking, native coupon rewards, payment/refund synchronization, and hosted privacy callbacks.