Create a Reward
Creating a reward is a structured process that defines what a customer can redeem, who can redeem it, how much it costs, and how many times it can be redeemed. The following steps guide you through the complete configuration.
Before you begin
Some fields in this flow, such as categories, groups, custom fields, and languages, are only available if they have been configured first. To set them up, go to Rewards+ and select the Settings icon in the top-right corner of the Rewards Catalog page. See Rewards Catalog settings for instructions. If you skip this step, those fields will be empty when you reach them.
Step 1: Basic details
Set the reward's core identity, such as its name, duration, type, and whether it publishes automatically on the start date.
-
Go to Rewards+ > Rewards Catalog.
-
Select New Reward.
-
In the Name box, enter a name for the reward. The limit is 255 characters.
This name appears in the catalog list and in admin search results. Admins scanning the list for a reward search against this field.
-
(Optional)Description box, enter a description. You can add up to 4,000 characters.
The description appears on the reward detail page that customers open when they select a reward. Use it to provide customers with context on what they're receiving and any redemption conditions.
- In the Duration field, set a start date and time and, optionally, an end date and time. The Rewards Catalog uses your organization's timezone.
When the start date arrives, the reward status changes from Upcoming to Live and becomes redeemable by eligible customers. When the end date passes, the status changes to Ended, and redemptions stop automatically with no admin action required.
If you change the duration later, it may reset configured inventory limits. See Edit a reward for details.
-
From the Reward type dropdown, select a type.
The reward type determines two things: (1) which pre-configured incentives appear for you to link in Step 3. (2) what the customer actually receives when they redeem the reward. For a full description of each type, see Reward types.
Once the reward goes Live, these fields cannot be edited. Changing it once the reward goes live would invalidate any codes already issued to customers. You can change it while the reward is Upcoming, which will reset any incentive you've already linked.
Note
If you change the reward type after you have already linked an incentive, the system will show a "Your changes will modify dependent steps" warning. Confirming will remove the previously linked incentive, because the new reward type requires a different incentive format. You will need to link a new incentive in Step 3.
-
For the Coupon type only: The Reward issued by field appears. Select who issues the reward:
- [Your organization name], your organization issues the reward directly.
- Other merchant, a third-party merchant issues the reward.
This determines which incentive records appear in Step 3 and is recorded against every issual for reconciliation. Changing it later resets the linked incentive.
- The Activate reward toggle is on by default. Here's what each state does:
| Toggle state | What it does |
|---|---|
| On | The reward becomes visible and redeemable to eligible customers exactly on the start date, with no further admin action needed. |
| Off | The reward exists in the system but is completely invisible to customers, regardless of the start date. It stays hidden until an admin manually turns it on. Use this when you want to stage a reward without publishing it yet. |
- Select Continue.
You've now established the reward's core identity and schedule. You can define the target audience next.
Step 2: Who can view the reward?
Define which customers can see and redeem the reward. The system runs this check before showing the reward to any customer.
All customers
Select All Customers to make the reward available to your entire customer base. No filtering runs for every customer who reaches the reward via the catalog, a promotion, or a direct issue where the customer needs to claim the reward and redeem it.
Specific customers
Select Specific Customers to restrict the reward to a targeted group. The Filter customers based on list appears.
| Filter option | What it does |
|---|---|
| Loyalty program, Tier and Supplementary program | Shows the reward only to customers in a specific loyalty program, tier, or supplementary program, for example, Gold tier members only. |
| Segment and Partition | Shows the reward only to customers in a predefined segment or partition. Use this for behavioral or demographic targeting. |
| Customer label | Shows the reward only to customers carrying a specific label on their profile, such as "VIP" or "At-risk." |
| Card Series | Shows the reward only to customers who hold a specific card type, such as a co-branded credit card. |
Customers who don't match the filters can't see the reward at all, it doesn't appear in their catalog view.
-
Within a filter category, OR logic
Selecting multiple values in the same category means the customer must match at least one. Selecting "Program A" and "Program B" qualifies a customer enrolled in either program. -
Across filter categories, AND logic
Combining different categories means the customer must satisfy all of them. Selecting Program A or B, plus Gold or Silver tier, requires the customer to be in one of the programs and one of the tiers.
You've now defined who can see and redeem the reward. You can configure the incentive and cost next.
Step 3: Incentive and cost details
Determine the specific incentive a customer receives and configure how they pay for it.
Link an incentive
An incentive is a pre-configured benefit object built in another area of Rewards+. It defines the actual deliverable a customer receives, such as the specific coupon series with its discount value, the game with its prize pool configuration, the gift card with its denomination and issuing partner, and so on.
The reward wraps the incentive and adds the catalog rules on top: who can see it, what it costs, and how many times it can be redeemed. Without a linked incentive, the reward has no benefit to deliver.
What incentive type links to each reward type?
Each reward type is compatible with exactly one incentive type. The reward type you selected in Step 1 determines which incentives appear here; all other types are filtered out. Before linking, confirm that an active incentive of the correct type exists in your organization.
| Reward type | Links to this incentive type | Verify the incentive has these configured | Example |
|---|---|---|---|
| Auction | Auction | Minimum bid amount, auction start and end dates, and number of winners | Bid a minimum of 5,000 points for a limited-edition watch; the top 3 bidders each win one. |
| Card-linked offer | Card-linked offer | Participating card network or issuer, qualifying merchant scope, and benefit rate (cashback percentage or discount amount) | Link your Visa card and earn 5% cashback on all restaurant purchases. |
| Cart promotion | Cart promotion | Cart qualifying conditions (minimum order value, eligible SKUs or categories) and the discount to apply at checkout | Add two shirts to your cart and get 20% off automatically at checkout. |
| Cashback | Cashback | Cashback percentage or fixed return amount and the qualifying transaction criteria | Shop for ā¹1,000 and get ā¹100 credited back to your loyalty wallet. |
| Charity | Charity | Charity partner name and the points-to-donation conversion rate | Donate 500 points to provide meals for underprivileged children through a partnered NGO. |
| Coupon | Coupon | Coupon series ID, discount value, applicable products or categories, and code generation method, Capillary issues these codes | Receive a unique code for 20% off electronics, applied at checkout. |
| Games | Games | Game format (spin-the-wheel, scratch card, and so on), prize tier configuration, and win probability per prize | Spend 100 points to spin the wheel daily for a chance to win 50ā500 bonus points. |
| Gift card | Gift card | Card denomination, issuing partner (such as Amazon or Flipkart), and delivery channel (email or SMS) | Redeem 2,000 points for a ā¹1,000 Amazon gift card delivered to your registered email. |
| Gift voucher | Gift voucher | The product, service, or experience covered; the list of participating outlets; and the voucher's own validity period | Redeem 800 points for a free pizza voucher at participating outlets, valid for 30 days. |
| Miles | Miles | Conversion rate (how many loyalty points equal how many miles) and the partner airline or travel program | Convert 10,000 loyalty points into 5,000 airline miles with a partner carrier. |
| Physical reward | Physical reward | Product name, SKU, available inventory count, and fulfilment routing details | Redeem 3,000 points for branded wireless headphones delivered within 5ā7 working days. |
| Sweepstakes | Sweepstake | Prize description, total number of entries available, draw date, and winner selection method (random draw or top entries) | Every 100 points spent earns one entry into the monthly draw to win a new smartphone. |
| Vendor only reward | Vendor only reward | Vendor's external reward definition and the API endpoint that receives the redemption request | Redeem 1,500 points for movie tickets via a BookMyShow integration; tickets arrive by SMS. |
| Wallet offer | Cash wallet | Wallet credit amount and the qualifying stores or transaction types where the credit applies | Redeem 1,000 points for ā¹500 in wallet credits, usable on any in-store or in-app purchase. |
Steps to link different incentives in the reward catalog
The link experience differs by reward type.
Coupon (issued by your organization), Cart promotion, and Gift voucher
- Under Incentive and cost details step, select the Link Incentives section and select the link entry.
-
A slide panel opens, showing existing incentives of the compatible type. Each row shows the incentive name, offer ID, and validity dates.
-
Select the row of the incentive you want to link and click on Link to reward. The linked incentive's name, offer ID, and validity dates appear in the Link Incentives section.
Note
- If no incentives appear, no active incentives of the compatible type exist in your organization yet. Create the incentive first in the relevant Rewards+ module, then return to this step.
- For Coupon type only:** After selecting a coupon, an Edit option appears that lets you edit the coupon's configuration directly within this panel without leaving the reward creation flow. The coupon edit form is the same as the one in Coupon Management. Refer to that page for a full description of each field.
All other reward types
For all other types, the link panel shows a list of existing merchant rewards which are pre-configured vendor integrations for that reward type. Only active merchant rewards appear and can be linked.
To use an existing merchant reward:
- Select Link Incentives section and select the link entry.
- Find the merchant reward using the search bar or Merchant filter.
-
Select the row, then select Link to reward.
To create a new merchant reward:
-
In the Merchant dropdown, select + Add merchant at the bottom of the list. The New merchant flow panel opens.
Fill in the following fields to :
| Field | Description | Business impact |
|---|---|---|
| Merchant name | Required. The display name for the vendor. Maximum 255 characters. | Visible to reward administrators when selecting a merchant. A clear name prevents mismatched reward and vendor assignments. |
| Description | Optional. A short description of the merchant. Maximum 1,034 characters. | Helps administrators identify the right vendor at a glance, especially when multiple merchants of the same type exist. |
| Merchant identifier | Optional. A unique identifier for the merchant. Maximum 50 characters. Must be unique across all merchants. | Used to reference this merchant in integrations or external systems; avoids duplicate entries. |
Adding additional details of the merchant
Turning on the Additional details toggle exposes the following:
| Sub-field | Description | Business impact |
|---|---|---|
| Rank | A positive integer that sets the merchant's display order in lists. | Lower numbers appear first; use this to surface preferred or high-priority vendors above others. |
| Key-value metadata | Custom attribute pairs attached to the merchant. Multiple pairs can be added. | Stores vendor-specific data (such as contract tier, region, or partner code) that Capillary does not capture in standard fields, making it available for downstream use. |
| Media | Images (up to 5) and videos (up to 2) associated with the merchant. Each file must be 25 MB or less. | Provides visual assets that can be displayed in reward-facing interfaces, for example, vendor logos or promotional content shown to customers at redemption. |
Select Next : New merchant reward to create New merchant reward panel.
- Fill in the following fields:
| Field | What it does |
|---|---|
| Merchant name | Required. Up to 255 characters. This name identifies the entry in the list. |
| Reward type | Pre-filled and locked to the reward type from Step 1. |
| Merchant | Select the vendor who fulfils this reward from the dropdown. |
- The Add API for merchant reward toggle is off by default. Turn it on if an API call is required. When on, the API is triggered, Capillary calls at the moment of redemption:
| Field | What it does |
|---|---|
| API Name | Label for this API call. Defaults to "API 1". |
| Execution order | Numeric order this API runs in when multiple APIs are configured. Lower numbers run first. Must be between 1 and 99. |
| Import cURL | Paste a cURL command to auto-fill the API type, URL, headers, and body. |
| API type | HTTP method: POST, GET, PUT, or DELETE. |
| API URL | The vendor endpoint that receives the redemption request. |
| Headers | Request headers as key-value pairs, for example, an authorization token. Select + Key-value to add. |
| Request body | JSON payload sent with the request. Must be valid JSON. |
| Context keys | Maps fields from the API response to named keys that Capillary stores for subsequent actions. A Voucher key is pre-added for types that return codes. Select + Key-value to add more mappings. |
Select + API to add another API call. You can add up to 20 API calls per merchant reward. Multiple APIs run in execution order.
-
Select Test API to verify the configuration.
-
Select Save merchant reward. The entry appears in the list, select it, then select Link to reward.
You've now linked the incentive. Configure the cost below.
Cost of reward
Under Cost of reward, configure how customers pay for the reward. Add up to five payment modes to give customers flexible redemption options.
You can select one of the following cost types:
Free
The reward costs nothing, no points deducted, no cash charged. The only gates are the audience filter and any inventory limits you've set.
Select Free. The system sets the cost to zero.
Fixed cost
A set price that stays constant for every redemption. Each payment mode you configure appears as a separate redemption option on the reward detail page, adding more modes gives customers alternative ways to pay, not a higher price.
-
Select Fixed cost.
-
Under Payment mode 1, select a sub-type:
| Sub-type | What the customer pays | Validation |
|---|---|---|
| Fixed cash | A set cash amount. Enter it in the Cash Amount Required box. | Must be a positive integer greater than 0. |
| Fixed points | A set number of points. Enter it in the Points Required box. | Must be a positive number greater than 0. |
| Cash + Points | Both a cash amount and a points amount. Enter both values. | Both the cash amount and the points amount are required and must each be greater than 0. Neither can be left empty. |
- (Optional) Select Add payment mode to add more options. You can add up to five payment modes per reward.
Combination rules:
- Fixed cash and Fixed points can each be added only once. If either is already configured, that option is disabled in the Add payment mode menu.
- Cash + Points can be added multiple times. Each entry is independent, with its own cash and points amounts.
- All three subtypes can be combined in a single reward. For example, you can configure Fixed cash + Fixed points + two Cash + Points entries (four payment modes total), giving customers four different ways to pay.
Variable cost
Use variable cost when the reward's value isn't fixed, for example, a wallet credit where the customer chooses the amount. The customer enters the amount they want, and the system calculates the points required using the rate you set. The reward's linked incentive determines the minimum and maximum amounts available.
Note
Variable cost is available only for the following reward types: Auction, Charity, Gift card, Miles, Sweepstakes, and Wallet offer. For all other reward types, this option does not appear.
- Select Variable cost.
- In the Value of 1 point = box, enter the conversion rate. The value must be greater than 0. For example,
0.5means 1 point = ā¹0.50, so a ā¹500 reward costs 1,000 points. - The system shows a real-time confirmation: "To purchase 1 value of reward, [X] points will be redeemed."
You've now configured the incentive and cost. You can set inventory limits next to control how often the reward can be redeemed.
Step 4: Inventory limits
Set limits on how many times the reward can be redeemed. On every redemption attempt, the system checks both customer-level and reward-level limits. If either is exhausted, the redemption is blocked until the restriction period resets or the limit is cleared.
Inventory limits are optional. Without them, the reward is redeemable unlimited times by any eligible customer.
Quantity vs. value: choosing your KPI
Before setting a limit, choose what to count:
| KPI | What it counts | When to use |
|---|---|---|
| Quantity of reward | The number of reward units purchased. | Use when each redemption consumes one unit, regardless of its points cost. |
| Value of reward | The total monetary worth of all redemptions combined. | Use for variable-cost rewards where each redemption has a different monetary amount, where counting the quantity of rewards alone doesn't reflect actual budget consumption. |
Note
The value of reward is only available for variable-cost reward types (Auction, Charity, Miles, Cash Wallet, Sweepstakes, Gift Card) when a variable cost payment mode is configured.
Customer level inventory
Customer-level limits protect against one customer over-redeeming. The system checks these limits before allowing any individual redemption.
For the entire reward duration
Set a single cap with no reset across the reward's full validity period.
| Field | What it does |
|---|---|
| Max. quantity a customer can purchase in the entire reward duration | Caps the total number of redemptions per customer for the lifetime of the reward. Example: A customer can redeem this coffee voucher a maximum of five times during the campaign. |
| Max. value a customer can purchase in the entire reward duration | Caps the total redemption value per customer. Example: A customer can redeem rewards worth up to ā¹8,000 total during the campaign. |
For a specific duration
Set a recurring cap that resets periodically. Select Add reset period and choose one of the following:
| Reset period | How it works |
|---|---|
| Specific no. of day(s) (Fixed window) | All customers share the same redemption period. The limit resets for everyone at the same time, regardless of when individual customers last redeemed. If the period is 30 days and the cycle starts on June 1, every customer's limit resets on July 1. Reference date sets the anchor date from which cycles are calculated. The reference date must fall within the reward's start and end dates, and can be the same as the reward's start date. |
| Specific no. of day(s) (Rolling window) | The redemption limits using a rolling lookback window evaluate each customerās history in real time. Rather than following a fixed calendar, the window shifts based on the current date; for example, a 7-day period means a redemption on June 3 remains active until June 10, while a June 5 transaction counts until June 12. |
| Weekly | The limit resets each week. Select the day of the week on which the limit resets, for example, every Monday. |
| Calendar month | The limit resets at the start of each calendar month. |
Enter the Max. quantity a customer can purchase within specific duration or Max. value a customer can purchase within specific duration for the window.
Stacking limits: Select Add Limit to add another customer-level limit of a different period, for example, a daily limit of 1 and a monthly limit of 5 on the same reward. Both limits must have headroom for a redemption to go through. A customer who hit their daily limit is blocked even if they haven't hit the monthly limit yet. You can add up to 10 customer-level limits per reward.
Reward level inventory
Reward-level limits protect the total redemption budget across all customers combined. The configuration options are the same as customer-level limits.
| Field | What it does |
|---|---|
| Max. quantity that can be purchased in the entire reward duration | Caps total redemptions across all customers. When this number is reached, no more redemptions go through, even for customers who haven't used their personal allowance. |
| Max. value that can be purchased in the entire reward duration | Caps total redemption value across all customers. |
Select Add Limit to add another reward-level limit. You can add up to 10 reward-level limits per reward.
When you stack customer-level and reward-level limits, both run on every redemption attempt. For example: customer limit = 1, reward limit = 1,000. The 1,000th redemption makes the reward unavailable to everyone, even customers who haven't used their personal allowance.
You've now configured inventory limits. You can add localized content for a global audience next.
Step 5: Content in multi-language
Localize the reward's name, description, terms, and media so the system serves each customer the version that matches their language preference. If a customer's app or website is set to Arabic, they see the Arabic name, description, terms, and images you configure here. If you haven't configured Arabic, they see the default language (English).
Configure content for each language set up in your organization's language settings.
-
In the Content in multi-language section, select Edit next to the language you want to configure.
-
Configure the following fields:
| Field | What it does |
|---|---|
| Activate language | Turning this off for a specific language doesn't remove the reward from those customers. It reverts them to the default language. The reward stays visible; only the language version switches. The default language can't be turned off. |
| Reward name | The localized reward name shown to customers browsing in this language. Maximum 255 characters. |
| Description | (Optional) The localized description shown on the reward detail page. Maximum 4,000 characters. |
| Terms and Conditions | (Optional) Appears as expandable fine print on the reward detail page. Supports rich text so you can format it with bullet points, bold text, and links. Maximum 50,000 characters. |
| Upload media | Localized images and videos. Drag and drop files, select Upload to browse, or select Paste URL to link media from a web address. Up to 10 images (10 MB each) and 2 videos (25 MB each). |
| Reward image | The main image displayed on the reward detail page for this language. |
| Thumbnail image | A smaller image used in list and preview views for this language. |
| Custom fields | (Optional) These are "Reward creation" scoped custom fields from your organization settings. They appear here so their values can vary per language, for example, a localized tagline or market-specific product code. Select Add custom field to choose from available fields. |
-
Select Save to confirm the content for this language.
-
To add content for another language, select + Language and repeat the steps above. To add languages, go to Settings > Languages > New language.
You've now localized the reward content. You can add internal metadata to organize the reward in the catalog next.
Step 6: Additional details
Add metadata to control how the reward appears in the catalog and how it's organized internally. All fields in this step are optional. Create groups and categories in catalog settings before assigning them here.
| Field | What it does | Character limit |
|---|---|---|
| Reward rank | Controls the order rewards appear in the catalog list view. Rank 1 appears at the top. Rewards with no rank assigned appear below all ranked rewards, in creation order. Lower number = higher position. Must be a positive integer. | Not applicable |
| Group and rank | Assigns the reward to a browsable group in the catalog. The rank within the group controls the order rewards appear within that group's view. Nesting groups creates a hierarchy (for example, "Summer Sale > Clothing > Women's") that customers navigate. The group rank must be a positive integer. | Not applicable |
| Category | Customers can filter the catalog by category. Assigning "Electronics" makes this reward appear when a customer applies the Electronics filter. A reward can belong to only one category. | Not applicable |
| Priority | Internal only. Customers never see this. Use it for workflow prioritization when reviewing or approving rewards. It has no effect on catalog display order. | Not applicable |
| Tier | A text label for reporting and internal organization. This does NOT control who can see or redeem the reward, which is configured in Step 2. Use it to tag rewards as "Gold" or "Platinum" so you can filter by tier in analytics. | 255 characters |
| Group | Different from the Group and rank field above. This is a free-text internal tag used for grouping in reports. Customers don't see it. | 255 characters |
| Label | Appears as a visible badge directly on the reward card in the catalog while customers browse. Use it for urgency cues like "Selling fast, only 23 left!" or "Ends tonight at 11:59 PM." | 255 characters |
You've now added the reward's metadata. Review the full configuration before saving.
Step 7: Preview and save
Before creating the reward, review the complete configuration.
-
Select Preview at the bottom of the page.
-
The preview screen shows a read-only summary across all sections:
-
Basic details
-
Who can view the reward
-
Incentive and cost details
-
Inventory limits
-
Content in multi-language
-
Additional details
-
-
Expand any section to review the details. Select Back to return and make changes.
-
Select Save to create the reward and add it to the catalog.
If you exit before saving, a confirmation dialog appears: "Discard unsaved reward details?" with the message "This reward's configuration will be lost and cannot be recovered." Confirming this dialog permanently discards all entered configuration.
You've now fully configured a new reward. It goes live on its scheduled start date if the Activate reward toggle is on, or stays invisible to customers until you activate it manually.
Updated about 6 hours ago
