> For the complete documentation index, see [llms.txt](https://docs.bloop.plus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bloop.plus/referral-program/rewards.md). # Rewards Set what the referrer and the referee each earn, and when the reward is issued. Every Bloop referral has two rewards: * **Referee reward** — what a new customer gets for using a referral link or code. * **Referrer reward** — what an existing customer earns after their referee buys. Configure both from the **Referrer reward** and **Referee reward** sections of the Campaign tab. Each has its own on/off toggle. > **Best practice:** Match the reward type to how often people buy from you — store credit works well if customers return; cash or a discount works better for one-off purchases. Keep the combined reward value below your profit on a referred order. Always give the referee something too — two-sided rewards work better than referrer-only ones. See [designing your offer](/best-practices/designing-your-offer.md). ### Choose a referrer reward type | Reward type | How it works | Payout | | --------------- | ----------------------------------------------------------------------------------------------------------- | ------------------------------- | | Discount coupon | A Shopify discount code — fixed amount or percentage; can be restricted to specific products or collections | Automatic in Shopify | | Store credits | Shopify Store Credit applied directly to the customer's account | Automatic in Shopify | | Free product | A product you pick, given free on the referrer's next order | Automatic in Shopify | | Cash | Tracked in Bloop; you process the payment yourself | Manual payout | | Custom | A reward you describe in your own words (a gift, swag, a service) and fulfil yourself | Manual — held for your approval | Pick a type based on how often customers buy from you: store credit if they're likely to order again, cash or a discount if not. See [best practices: choosing the right referral reward](/best-practices/choosing-rewards.md) for the full breakdown by industry. #### Free product Choose one product and a quantity between 1 and 999. The referrer gets that product free on a later order — no percentage to calculate, and the perceived value is the product's full retail price, not your cost. It works best when the product is small, cheap to ship, and gives a reason to come back: a sample size, a refill, an add-on to something they already own. Pick a product that's reliably in stock; a free-product reward pointing at a sold-out item is a broken promise. #### Cash Cash rewards are tracked in Bloop and paid by you — Shopify never issues them. Two things have to be in place before you can turn one on: 1. **Payment methods on your side.** In **Referral → Settings → Payment method**, pick the methods you're willing to pay out through (PayPal, bank transfer, and so on) and fill in the details each one needs. **Add more payments** creates a method of your own. These apply across every campaign. 2. **A way for referrers to give you theirs.** Add the **Reward Payment Method** app block to the Profile page in your Shopify customer account editor, then add the block under Apps. Without it, referrers have no way to tell you where to send the money. Referrers who haven't entered payment details see a prompt on their [referral hub](/referral-program/referral-hub.md), and the order shows a **Referrer hasn't added payment details yet** warning in [referral orders](/referral-program/management/orders.md). Pay out from the cash payout tab once details are in. #### Custom A **custom reward** has no value, minimum, or expiry — just a short **description** (up to 500 characters) of what the referrer gets. It's never issued automatically: it stays **Pending** until you approve it in [referral orders](/referral-program/management/orders.md), once you've arranged to fulfil it. Use it for rewards outside Shopify; otherwise a discount code, store credit, free product, or cash is simpler since it issues on its own. ### Set the discount value Choose a **fixed amount** (best for a narrow price range) or a **percentage** (best for a wide price range, since it scales with order size). The referee reward uses the same options. > **The margin rule.** Add the referrer and referee rewards together, and keep that combined cost below your profit on a referred order. That keeps every referral profitable. Refine the value with [A/B testing](/referral-program/ab-testing.md) once you have traffic. ### Apply to products A discount reward can cover **all products**, or only **specific products**, **product collections**, or **specific product variants**. Narrowing the scope protects margin on the lines you can't afford to discount, and steers referred customers toward what you actually want them to buy. Narrowing has a catch worth knowing: reward text in emails and widgets renders from a variable that shows the discount value — a referrer sees "30% off" whether it applies to everything or to one collection. Spell out the restriction yourself in [reward display](/referral-program/reward-display.md), or expect support tickets at checkout. ### Discount code prefix The codes Bloop generates carry a prefix you control, on both the referrer and referee side: | Prefix type | Code looks like | Use it when | | --------------------- | --------------- | ---------------------------------------------- | | Custom text | `BLOOP12345` | You want every code to read as one campaign | | Referrer's first name | `SARAH12345` | You want the code to feel personal when shared | A first-name prefix falls back to your custom text when the referrer has no first name on file. The prefix applies to every tier and to the code your referrers share, so changing it changes the whole campaign's codes. ### Purchase type and subscriptions Set whether a reward applies to **one-time purchases**, **subscriptions**, or **both**. Only choose Both if your store genuinely sells both ways — otherwise the discount silently fails to apply. When subscriptions are in scope, a **recurring cycle limit** appears: the number of recurring payments the reward applies to, from 0 to 99. `0` means unlimited — the discount rides every renewal forever, which is rarely what you want on a referral reward. A limit of 1–3 cycles gives the referrer a real benefit without discounting the subscription for its lifetime. ### Minimum requirements You can require a minimum before a referrer reward is issued: a minimum purchase amount, a minimum number of items, or a minimum number of referees (rewards in cycles, e.g. every 5th referral). Default is **None**. Most stores should leave this off at launch and only add one if margin becomes a problem. ### Tiered rewards The settings above pay a flat reward. If you want to pay more as a referrer brings in more friends, use **FlexiTiers** — see [FlexiTiers](/referral-program/tier-rewards.md). ### When the reward lands, expires, or is taken back Expiry, the review period, what counts as a successful referral, and the revoke triggers are all in [how to control when a reward is issued and revoked](/referral-program/reward-timing.md). ### Rewards are locked during an A/B test While an [A/B test](/referral-program/ab-testing.md) is running on a campaign, its reward settings are read-only — changing the reward mid-test would invalidate the result you're paying traffic to collect. End the test to edit rewards again. ### Common mistakes to avoid * **Rewarding only the referrer.** Always give the referee something too — it converts better. * **Setting rewards without checking your margin.** Add both rewards together and compare to your profit per referral. * **Restricting a reward to some products and leaving the text generic.** "30% off" that only works on one collection reads as a bait-and-switch at checkout. Set the [display text](/referral-program/reward-display.md). * **Leaving the recurring cycle limit at 0.** An unlimited subscription discount costs you every renewal, not once. * **Turning on cash before the payment method block is live.** Referrers earn rewards you have no way to pay. * **Never testing your reward.** Use [A/B testing](/referral-program/ab-testing.md) to check if a different value works better. ### Next steps * Spell out how the reward reads to customers in [Reward display](/referral-program/reward-display.md). * Decide how referrers share their reward in [Referral methods](/referral-program/referral-methods.md). * Prove which reward wins with [A/B test your referral rewards](/referral-program/ab-testing.md). * Match the reward to your economics with [best practices: choosing the right referral reward](/best-practices/choosing-rewards.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.bloop.plus/referral-program/rewards.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.