PointBay – Loyalty Points & Referral Rewards for WooCommerce

By WPAnchorBay

20+ active installationsVersion 1.1.1

Reward WooCommerce customers with loyalty points they earn on purchases and referrals, and redeem for discounts at checkout.

Description

PointBay is a loyalty, rewards and referral system for WooCommerce. Let your customers earn points when they shop, invite their friends for a bonus, and spend those points for instant savings at checkout. Everything is configured from a single settings screen, and customers can track their balance right inside their WooCommerce account.

Documentation & Support:

Earning points

  • Award points based on how much a customer spends (points per currency unit).
  • Give bonus points when a customer creates an account.
  • Reward customers with points for leaving a product review.
  • Choose which order status triggers points (for example, Completed or Processing), so points are only granted once an order is confirmed.

Referrals

  • Every logged-in customer gets their own referral link, shown in the My Rewards area of their account with a one-click copy button.
  • When someone follows that link and registers, they are attributed to the customer who referred them.
  • The referrer is awarded bonus points once the person they referred completes their first order — not merely on signup, so the reward tracks a real sale.
  • If that qualifying order is later cancelled, fails, or is refunded in full, the bonus is automatically clawed back.
  • Referrals are off by default; switch them on and set the bonus from the settings screen.

Redeeming points

  • Customers apply their points at checkout for a discount on their order.
  • Redeem points as an order fee (discount) or as a coupon, whichever fits your store.
  • Set the monetary value of a point and a minimum number of points required before redemption is allowed.
  • Works with both the classic checkout and the WooCommerce Cart & Checkout blocks.

For your customers

  • A dedicated My Rewards tab in the WooCommerce My Account area shows the current points balance, the customer’s referral link, and recent points history.
  • An optional notice lets guests know they could be earning points by signing in.

For store owners

  • A guided setup wizard on first activation walks you through earning, redemption and referral settings, and can be re-run any time from Settings.
  • A Points History ledger in the admin lists every points transaction for auditing.
  • A clean, modern settings screen integrated into WooCommerce settings.
  • A custom manage_pointbay capability so you control which roles can manage the program.

Privacy

PointBay does not track your visitors, and it does not send anything anywhere while it is running. Points, referrals and ledger history are stored only in your own database.

There is exactly one case where data leaves your site, and only if you choose it. When you deactivate PointBay from the Plugins screen, a short optional survey appears. If you select a reason and press Submit & Deactivate, the following is sent to WPAnchorBay at https://dfs.wpanchorbay.com:

  • the reason you selected and any note you typed,
  • your site address,
  • the email address of the WordPress account you are signed in with,
  • your WordPress version.

The modal states this before you submit. Choosing Skip & Deactivate, closing the modal, or deactivating any other way sends nothing at all. The survey is never shown outside the Plugins screen, and nothing is transmitted during normal use of the plugin.

The plugin sets one cookie, pointbay_ref, and only when the referral feature is switched on and a visitor arrives via a referral link. It holds the referral code and nothing else, and expires after 30 days.

Development

PointBay is fully open source. The compiled files in build/ are minified from the React/TypeScript admin interface and Sass stylesheets in the src/ directory. The complete, human-readable source, together with the build configuration (package.json, webpack.config.js, tsconfig.json, tailwind.config.js, postcss.config.js), is published publicly at:

https://github.com/wpanchorbay/pointbay-free

The admin interface is built with @wordpress/scripts (webpack + Babel); the stylesheets are compiled from Sass with Tailwind CSS via PostCSS by the same build. To regenerate the compiled assets from source, clone the repository above, then from its root:

  1. Run npm install to install the build tooling.
  2. Run npm run build to produce the production bundles in build/.

PHP dependencies are managed with Composer (composer install); third-party libraries live under vendor/. React and ReactDOM are provided by WordPress core and are not bundled. For a byte-for-byte reproducible build, the repository also includes the pinned package-lock.json.

Uncompressed source of the minified files

Every minified file in build/ is compiled from our own source, which is available uncompressed at:

https://github.com/wpanchorbay/pointbay-free/tree/1.0.0/src

  • build/admin.js and build/settings.js are compiled from the React/TypeScript entry points src/admin.tsx and src/settings.tsx (which mount src/AdminApp.tsx and src/SettingsApp.tsx); build/block-cart.js and build/block-checkout.js are compiled from src/cart/index.tsx and src/checkout/index.tsx.
  • build/admin.css, build/settings.css and their -rtl variants are compiled from src/styles/index.scss (Sass + Tailwind CSS via PostCSS).

Each compiled file also carries a header comment pointing back to this source. The uncompressed src/ directory ships inside the plugin zip as well, so the build is reproducible from the download alone with npm install && npm run build. The front-end scripts and styles in assets/ are not compiled — they ship as the original, human-readable source.

Installation

  1. Make sure WooCommerce is installed and active.
  2. In your WordPress admin, go to Plugins > Add New > Upload Plugin and choose the plugin zip file, or upload the pointbay-loyalty-points-referral-rewards-woo folder to /wp-content/plugins/.
  3. Activate the plugin through the Plugins menu in WordPress.
  4. Go to WooCommerce > Settings > Loyalty Points to configure earning and redemption rules.

FAQ

Does this plugin require WooCommerce?

Yes. PointBay is a WooCommerce extension and requires WooCommerce to be installed and active.

How do customers earn points?

Customers earn points automatically based on the rules you configure: an amount per currency unit spent, plus optional bonuses for registering an account or reviewing a product. Points for an order are granted when the order reaches the order status you select in the settings.

How do customers redeem their points?

At checkout, customers can apply their available points for a discount. You decide the value of each point, the minimum points needed to redeem, and whether the discount is applied as an order fee or as a coupon.

Does it work with the WooCommerce checkout blocks?

Yes. PointBay supports both the classic checkout and the block-based Cart and Checkout.

How do referrals work?

Each logged-in customer has a personal referral link, shown under My Account > My Rewards. When a visitor follows that link, the referral code is remembered so that if they register an account they are attributed to the customer who referred them. Once that new customer completes their first order, the referrer is awarded the bonus points you configured. If the qualifying order is later cancelled, fails, or is refunded in full, the bonus is taken back automatically.

Does the plugin set any cookies?

One, and only when referrals are enabled. If a visitor arrives on a referral link, the plugin stores that referral code in a cookie named pointbay_ref for 30 days, so the referral can still be credited if the visitor registers on a later visit. The cookie holds only the referral code — no personal data. It is never set while the referral feature is switched off, and nothing else in the plugin uses cookies.

Can a customer refer themselves?

No. If a customer follows their own referral link and registers a second account, the referral is ignored and no bonus is awarded.

Where can customers see their points balance?

Every customer gets a My Rewards section under My Account showing their current balance, their referral link, and recent points history.

Screenshots

Changelog

1.1.1

  • Added a dismissible Black Friday deals notice from WPAnchorBay for administrators, on the Plugins screen and PointBay’s own admin and settings pages, through 20 December 2026. Closing it hides it for a few days, and it comes back on a few key sale dates, such as just before Black Friday and Cyber Monday.

1.1.0

  • Added order-value bands, so points can be awarded per spending tier instead of a flat per-dollar rate.
  • Added a flat bonus on every order and a one-time bonus on a customer’s first order, each with its own control over whether VIP tier multipliers apply.
  • Added a setting for whether points are calculated on the order total or the subtotal, so shipping and tax can be excluded.
  • Added a setting to take back the points earned on a completed order when it is cancelled (on by default; Cash on Delivery orders always do), with the points restored if the order is reopened.
  • Added a “you will earn X points” notice to product pages, which updates as a variation is chosen.
  • Added shortcodes ([pointbay_rewards], [pointbay_balance], [pointbay_history], [pointbay_referral_link], [pointbay_earn_notice]) and classic widgets for placing the rewards UI anywhere.
  • Added an option to show the customer’s points balance in the site navigation and toolbar.
  • Added an option to turn off partial redemption, and an option to hide the coupon form while a points discount is applied.
  • Points are now calculated in one place for both the storefront preview and the award, so the figure a customer is shown is the figure they receive. Previously the cart and checkout notices quietly used a smaller basis than the award did.
  • Refunds now claw back a fair share of the points actually awarded, rather than recalculating from current settings. Partial refunds accumulate correctly, and one-time bonuses are only reclaimed on a full refund.
  • Points a customer redeemed on an order are now returned when the order is fully refunded or cancelled (and in proportion on partial refunds), instead of being lost while the earned points were clawed back.
  • Fixed a refunded Cash on Delivery order having its points clawed back twice.
  • Fixed the redemption limit not being re-checked against the same rules when points were taken at checkout.
  • Added a minimum cart spend to earn points, with a message on product, cart, checkout (classic and block) and shortcode views when the cart is below it.
  • Added points for approved blog comments, with an approval setting, a daily limit, and automatic take-back when a comment is marked as spam, trashed or deleted. Post authors earn nothing on their own posts.
  • Added a tool to award points for past orders: preview, confirm, then credit in batches, once only per order, with ledger rows dated to the original order.
  • Added a note on each order showing the points awarded and how many were paid with points.
  • Added the pointbay_user_can_earn filter so other code can stop a customer earning on any path.
  • Fixed a deleted and re-recorded refund being able to take earned points back twice.
  • Fixed the ledger note for a reversed order saying “COD order” for every payment method.

1.0.1

  • Added a first-run setup wizard that walks through earning, redemption and referral settings, with a “Run Setup Wizard” link in Settings to launch it again any time.
  • Added a dedicated PointBay entry to the WordPress admin menu, with a setting to hide it again.
  • Fixed Order Status Trigger and Redemption Mode dropdowns not saving, and hardened both against invalid values.
  • Fixed a bug where ordinary product-page comments could earn review points.
  • Hardened the points ledger against invalid users, double-submitted adjustments, and a first-transaction race condition, and added the ability to reverse a ledger entry from the admin screen.
  • Fixed points redemption not being re-checked against the order’s final total at checkout.
  • Added an “Upgrade to Pro” action link and Docs / Support / Rate links to the WordPress Plugins screen.
  • Fixed the documentation link to point to docs.wpanchorbay.com, and linked the plugin page and Buy Pro pricing page from the readme.

1.0.0

  • Initial release.