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.

| 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 |
A referral was not tracked at all
Section titled “A referral was not tracked at all”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.

| 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 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 reward disappeared
Section titled “The reward disappeared”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.
A cash reward cannot be paid
Section titled “A cash reward cannot be paid”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.
Storefront messages
Section titled “Storefront messages”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 |
Related
Section titled “Related”- Review and manage referral orders: the screen most of this page refers to.
- Detect referral fraud with the Fraud center: why an order was flagged.
- Troubleshooting discount codes: the reward exists, but the code does not work.
- How to find and use your referral reward: a page written for referrers, to share in support replies.

