Skip to content

How Referral Rewards Work

This page follows one share on the demo from start to finish: Amara shares a tote bag, her friend Nina buys it, and Amara earns a coupon. Every screen below is from that run.

Amara is signed in. On the Canvas Tote Bag she presses Copy link. The link is the product page with her personal code:

https://demo.devdiggers.com/woocommerce-product-share-for-discounts/product/canvas-tote-bag/?sref=sv16qdbd

The share box after Amara copied her link

Each customer gets one random code the first time they need it. It never shows their name or username. The share is counted on the dashboard, and with Share to Unlock on, Amara gets 5% off the bag herself.

Nina is not signed in. When the page opens, the plugin records a link visit for Amara. It also stores her code in a cookie in Nina’s browser for 30 days, the Referral Window. The product page tells Nina what she gets:

The friend notice on the product page

Opening the same link again does not count a second visit. Opening someone else’s link later switches Nina to that person.

Nina adds the bag. The Friend discount is added by itself: 10% of $28.00 is $2.80. It stays on the order through checkout.

Nina’s cart with the Friend discount

Nina pays by bank transfer and the order is placed. The plugin checks the fraud rules and records a referral as Pending, with a referred value of $25.20: what she paid for the bag after her discount. The cookie is cleared, so Nina’s next order is her own.

The order gets a note, and the referral appears at the top of Referrals. These two screens are from Ivy, a second friend who bought a print through Amara’s link the same way. Nina’s order had moved on by the time they were taken:

The order note about the referral

The pending referral on the Referrals screen

5. The order completes and Amara is rewarded

Section titled “5. The order completes and Amara is rewarded”

The shop marks the order Completed. The referral turns Rewarded, a coupon is created for Amara, and a second note names it:

The order note naming the reward coupon

Amara gets the reward email:

The reward email

The coupon is 10% off, single use, locked to Amara’s email and valid for 30 days.

The coupon is on her Share & Earn page. She uses it on a mug; afterwards it shows as Used.

The reward coupon on Share & Earn, used

  • A rule blocks it: The referral is Rejected with the reason, and no coupon is made. You can still approve it by hand.
  • The order is cancelled, refunded or fails: The referral turns Cancelled. A reward not yet used goes to the Trash and Amara gets the Reward Cancelled email. A used reward stays used.
  • The order never completes: The referral stays Pending.

A referral cancelled with its order

  • One referral per order, for the most recent link the friend opened.
  • What counts toward the referred value: only the shared product, while the friend discount Applies To the shared product. Otherwise, or on a shop link, every eligible product counts. Excluded products never count.
  • A sharer never earns from their own account or email.
  • The reward is created at Completed, or at Processing if you choose that.