Skip to content

Troubleshooting referrals and rewards

Most reward complaints have one of two causes: a review hold that is still running, or a referral that never reached Bloop. Find your symptom below, then follow the steps in that section.

The Orders tab listing referral orders with their referrer and status

If you see Go to
The order is in Shopify but missing from Referral program → Orders A referral was not tracked
The order is there, but the reward is pending or missing The reward has not arrived
A reward was issued and then disappeared The reward disappeared
The referrer earned less than they expected The referrer earned less
A cash reward is stuck and cannot be paid A cash reward cannot be paid
Customers see a message on your storefront instead of joining Storefront messages

The order is in Shopify, but it does not appear under Referral program → Orders. Bloop records an order as a referral only when the buyer came through a referral link or code.

The Activities feed showing what happened to a referral

Likely cause How to confirm What to do
The friend did not use the link or code (a phone order, or a code mentioned but not entered) Nothing referral-related is attached to the order Use Add order, and pick the referrer and campaign
The buyer is already tied to another referrer Add order refuses the order Nothing to fix. A customer belongs to one referrer only, and the first referrer keeps them
The referrer is not in the campaign you picked Add order refuses the order Pick the campaign the referrer belongs to
The buyer is outside the campaign’s target audience Check the campaign’s target audience Widen the audience if the exclusion was not intended
The buyer used a shared code but had ordered from you before The purchaser has earlier orders in Shopify Nothing to fix. A shared code only creates a referral for a first-time customer

Add order takes the Shopify order number (such as #1001) or its ID. It shows the order value and purchaser before you confirm, so check you have the right order.

The Add order dialog with fields for the order, the referrer and the campaign

The referral was tracked, but the reward has not arrived

Section titled “The referral was tracked, but the reward has not arrived”

Open the order under Referral program → Orders and read its reward status. The status tells you whether to wait, act, or do nothing.

Status What is happening What to do
Pending, N hours left of review period The review period is still running Nothing. The reward approves automatically when the time runs out
Pending, Suspicious A fraud check flagged the referral, and the reward is on a 14-day hold Review it in the fraud center, then approve or reject it
Reward declined Someone on your team or Bloop rejected it: a self-referral email match, a banned referrer, or an order cancelled or refunded before the reward was sent A rejection cannot be undone. If it was a mistake, create the reward yourself, for example a discount code in your Shopify admin, and send it to the referrer
Payout pending An approved cash reward is waiting for you to pay Pay the referrer, then mark the payout as paid
Reward sent The reward exists If the referrer cannot use it, check the discount code

Before you act on a held reward, know how holds end:

  • A hold that runs out approves the reward. The review period and the 14-day fraud hold give you time to act. They do not block the reward permanently.
  • Two cases are rejected instead. A held reward is rejected if you ban the referrer, or if the order is cancelled or refunded during the hold.
  • Two cases stay pending. If the campaign was turned off, or the order was deleted in Shopify, the reward stays Pending when the hold ends. Bloop does not decide it for you, so open the order and approve or reject it yourself.

Suspicious referrals are also listed in the Fraud center, with the days left to review:

The Fraud center listing referrers with suspicious activity and days left to review

Bloop takes a reward back when the order behind it is cancelled or refunded, based on your revoke setting. A refund of 90% or more of the item value counts as a full refund, and this is intended. See reward revocation.

If less than 90% was refunded and the reward still disappeared, check whether someone rejected the order by hand.

The referrer earned less than they expected

Section titled “The referrer earned less than they expected”
Cause Where to check
A referee-count minimum is not met yet The campaign’s minimum requirements in rewards
They are on a lower tier than they think FlexiTiers. Tiers only change the referrer reward
Some of their referrals are still pending, or were rejected and no longer count toward their tier Filter Orders by that referrer
They qualify for several campaigns and are sharing from a different one The campaign selector on their referral hub

To see exactly what the referrer sees, open them from Referral program → Contacts and choose Open referral hub.

The payout shows Referrer hasn’t added payment details yet. The referrer adds their details in the Reward payment method block in their customer account. The payment methods they can choose come from Settings → Referral → Payment method.

If that block is not on your storefront, referrers cannot add their details, and the payout queue fills with referrers you cannot pay. Add the block with the customer account extension.

Customers see these messages when they cannot join or claim a reward. They use Bloop’s default wording. If you changed the wording in your branding, look for your own version.

What the customer sees What it means What to do
“The referral program is temporarily unavailable.” Bloop has lost its connection to your store, usually because the app needs to be opened again in your Shopify admin. Customers cannot join or claim a friend reward until it is restored Open Bloop from Apps in your Shopify admin. See if customers can’t join the program
“Too many sign-ups right now. Please try again in a few minutes.” Your store hit a short-term limit on new referrers and friends. The limit stops bots from creating codes in bulk Nothing. The limit resets after 10 minutes
“You can’t refer yourself” The friend entered the referrer’s own email Nothing to fix. The block is intended
“You’re not eligible to receive the gift” or “…the reward” The friend has already ordered from you, or is already a referrer. Friend rewards are for first-time customers only Nothing to fix. See who can be referred
“You’re unable to claim discount” A fraud check matched the referrer’s IP address or browser See blocking abuse before it reaches the queue
“You’re not eligible to join referral program” The customer is outside the campaign’s target audience Check the campaign’s target audience