What is Rebuy?

Rebuy is an AI-powered personalization platform that helps ecommerce brands increase revenue, average order value (AOV), and customer retention through personalized shopping experiences.

Rebuy's Gift With Purchase (GWP) functionality allows merchants to incentivize purchases by offering complimentary products when shoppers meet specific cart requirements.

Rebuy + Tapcart

The Rebuy Selectable Gift With Purchase integration brings your Rebuy gifting campaigns directly into your Tapcart mobile app.

Merchants can reward shoppers with free products based on cart value, product eligibility, or other configured rules, creating an engaging shopping experience that encourages customers to increase their cart size.

Capabilities available through the integration:

Selectable Gifts: Allow shoppers to choose their preferred free gift from multiple eligible products.
Automatic Gift Addition: Automatically add a qualifying gift to the cart when a shopper reaches a reward threshold.
Tiered Rewards: Incentivize higher spending with multiple gift thresholds and a visual progress bar.
Real-Time Eligibility: Automatically unlock or remove gifts as shoppers add or remove products from their cart.
Variant Selection: Allow shoppers to select available gift variants, such as size or color.
Rebuy Campaign Syncing: Pull gift products, eligibility rules, and campaign messaging directly from supported Rebuy configurations.
Attribution & Reporting: Track gift-related orders through Rebuy's Sales Attribution reporting.

The integration supports existing Rebuy GWP widgets, Smart Cart Tiered Progress Bars, and manually configured gifting campaigns.

How to Connect Rebuy + Tapcart?

Before getting started, ensure you have:

An active Rebuy account connected to the same Shopify store as your Tapcart app.
An existing Rebuy Gift With Purchase widget, Smart Cart Tiered Progress Bar with gift tiers, or eligible Shopify gift products.
Access to App Studio in your Tapcart dashboard.
Gift products published to your app's Shopify sales channel and available in inventory.

Step 1 — Configure your Gift With Purchase campaign in Rebuy

In your Rebuy dashboard, configure the gifting campaign you want to display in your mobile app.

For a standard Rebuy Gift With Purchase widget:

Open your Gift With Purchase widget in Rebuy.
Navigate to the Discount tab.
Set the gift discount to 100%.
Enable Discounted By Functions.
Confirm the widget is connected to the appropriate Rebuy data source.

Important: Rebuy applies the discount at checkout, not the Tapcart block itself. Discounted By Functions must be enabled for widget-based gifts to be reduced to $0 at checkout.

For Smart Cart campaigns, confirm your Smart Cart is published and enabled, with a configured Tiered Progress Bar containing product reward tiers.

Step 2 — Enable Rebuy in Tapcart

Open your Tapcart Dashboard.
Navigate to Integrations.
Connect or enable Rebuy.
Open App Studio.
Navigate to your Cart screen.
Add the Rebuy Selectable GWP block.

The block automatically detects your Rebuy API key from the connected integration or your store's public Rebuy configuration. A separate API key is generally not required. If you don't see the Rebuy Selectable GWP block your dedicated CSM or Tapcart Support can assist.

Step 3 — Select your campaign type

Within the block settings, select the Campaign Type that corresponds to your Rebuy promotion.

There are three supported configuration options:

Option A: Rebuy GWP Widget(s) — Recommended

Best for merchants already running Rebuy Gift With Purchase widgets on their website.

Set Campaign Type to Rebuy GWP widget(s).
Locate your Gift With Purchase widget ID in Rebuy.
Enter the numeric ID in the Rebuy Widget ID(s) field.
For multiple campaigns, enter additional widget IDs separated by commas.
Verify the setup status displays OK.
Save and publish your changes.

The block automatically retrieves the widget's gift products, eligibility rules, title, button messaging, and gift limits.

Note: Widget eligibility may depend on cart contents, customer segments, or other Rebuy data source rules rather than a fixed spending threshold. Widget-only campaigns therefore do not display a spend-based progress bar.

Option B: Smart Cart Tiered Progress Bar

Best for merchants who want to replicate an existing Rebuy Smart Cart gifting experience inside their mobile app.

In Rebuy, confirm your Smart Cart Tiered Progress Bar is configured and enabled.
In App Studio, set Campaign Type to Smart Cart Tiered Progress Bar.
The block automatically retrieves your Smart Cart configuration using your store domain.
Confirm the setup status displays OK and the expected number of tiers.
Save and publish.

The block automatically imports supported reward thresholds, gift products, and progress messaging.

Supported tier types include:

Gift With Purchase: Unlocks free products when the shopper reaches a specified cart subtotal.
Free Shipping: Displays a shipping reward milestone.
Order Discount: Displays a discount milestone.
Decorative: Displays an informational milestone without a corresponding reward.

Free shipping, discount, and decorative tiers appear as progress bar milestones without gift selection rows.

Option C: Manual Tiers

Best for merchants creating app-exclusive gifting promotions or campaigns without a corresponding Rebuy GWP widget.

Set Campaign Type to Manual tiers.
Open the Manual Tiers settings.
Enable Tier 1.
Enter the required spending threshold or item quantity.
Add the eligible Shopify gift product IDs or a Rebuy data source ID.
Choose whether gifts should be selectable or automatically added.
Configure additional tiers as needed, up to four per block.
Under Advanced, enter the ID of a Rebuy GWP widget with Discounted By Functions enabled.
Save and publish.

Manual tiers allow merchants to configure gift eligibility and reward products directly within App Studio.

Important: Manual tiers still require a valid Rebuy GWP widget ID for the discount and attribution to function correctly.

How to Configure the Rebuy Selectable GWP Block

Once your campaign is connected, you can customize the shopper experience directly within App Studio.

Step 1 — Configure Gift Behavior

The block supports two gifting experiences:

Selectable Gifts

Shoppers can choose their preferred gift from a list of eligible products.

Once a reward tier is unlocked, shoppers can:

View eligible gifts and their original prices.
Select available product variants.
Add a gift to their cart.
Remove or swap their selected gift when permitted.

Auto-Add Gifts

The first eligible gift is automatically added when a shopper meets the campaign requirements.

This experience mirrors Rebuy's automatic gifting behavior on supported web campaigns.

Additional settings allow you to control the maximum number of gifts, gift swapping, and whether locked rewards are displayed.

Step 2 — Customize the Progress Bar

For Smart Cart and threshold-based manual campaigns, the progress bar communicates how close shoppers are to unlocking their next reward.

Available customization options include:

Progress bar height, fill color, and background color.
Tier markers and reward milestones.
Remaining-spend messaging.
Completed-reward messaging.
Corner radius and visual styling.

For manual campaigns, dynamic text variables can personalize progress messaging:

{{remaining_amount}} — Displays the remaining amount needed to unlock the next tier.
{{product_title}} — Displays the upcoming gift's product name.

Smart Cart campaigns use the tier-specific messaging configured in Rebuy.

Step 3 — Customize Gift Display and Styling

Within the Design settings, merchants can customize the appearance of the gifting experience to match their app.

Available settings include:

Header: Text, font, size, alignment, and color.
Gift Rows: Product image size, product title, pricing, background, borders, and spacing.
Buttons: Add, Remove, and Locked button styling.
Variant Selection: Styling for selectable product variants.
After Selection: Keep the selected gift visible or hide the offer after selection.
Background & Padding: Customize the block container and spacing.

By default, colors inherit your Tapcart brand kit.

Step 4 — Configure Advanced Settings

The Advanced settings allow merchants to control how gifting campaigns behave.

Key settings include:

Setting	Function
Gift Behavior	Choose selectable or automatic gifting
Max Gifts	Control the number of gifts allowed
Unlock Condition	Use cart subtotal or item quantity for manual tiers
Auto-Remove Gifts	Remove gifts when the cart no longer qualifies
Allow Gift Swapping	Let shoppers exchange selected gifts
Show Locked Gifts	Display upcoming rewards before they unlock
Block Visibility	Always display the block or show it only when a tier is unlocked
Rebuy Widget View Events	Send widget view events to Rebuy for reporting

Recommended: Keep Auto-Remove Gifts and Exclude Gifts From Threshold Math enabled. These settings prevent gifts from qualifying themselves for additional rewards and help ensure ineligible gifts are removed before checkout.

How Rebuy Discounts and Attribution Work

The Tapcart block displays and adds qualifying gifts to the cart, while Rebuy's Shopify Functions apply the discount at checkout.

Gift line items include the necessary Rebuy properties to support discount eligibility and attribution.

This allows merchants to:

Track gift-related purchases through Rebuy Sales Attribution.
Compare mobile app and web gifting performance.
Attribute orders to individual Rebuy GWP widgets.
Measure campaign conversion and revenue performance.

For widget-based and manual campaigns, the default attribution label is Tapcart - GWP Cart.

Smart Cart campaigns use Rebuy Tiered Progress Bar attribution.

Important: Do not override the attribution label for Smart Cart campaigns, as doing so can prevent the associated discount from applying.

Testing Your Gift With Purchase Campaign

Before launching your campaign, we recommend completing the following tests on a physical device.

Verify the configuration: Confirm the setup card in App Studio displays an OK status.
Test locked rewards: Open the cart below the qualifying threshold and confirm rewards remain locked or hidden.
Unlock a gift: Add products until the cart meets the campaign requirements.
Add a gift: Select an eligible gift or confirm the automatic gift is added.
Test gift swapping: Select a different gift within the same tier, if swapping is enabled.
Test gift removal: Reduce the cart below the threshold and confirm the gift is automatically removed.
Verify checkout: Requalify for the gift and confirm its price is reduced to $0 at checkout.
Place a test order: Confirm the gift discount applies successfully.
Review attribution: Verify the order appears in Rebuy Sales Attribution under the expected widget and attribution type.

A successful App Studio preview confirms the block's configuration, but a completed test order is necessary to validate the discount.

Troubleshooting

Gift is added at full price

Cause: The Rebuy discount is not correctly configured.

Resolution:

For widget campaigns, confirm Discounted By Functions is enabled and the discount is set to 100%.
For Smart Cart campaigns, verify the Tiered Progress Bar discount is active.
For manual campaigns, confirm a valid Rebuy GWP Widget ID is configured.

Remove and re-add the gift after correcting the configuration.

Gift products are not displaying

Cause: Products may be unpublished, unavailable, or out of stock.

Resolution: Confirm all eligible products are available through the Shopify sales channel used by your Tapcart app.

Gift disappears after being added

Cause: The cart no longer satisfies the gifting campaign's eligibility rules.

Resolution: Verify the qualifying cart subtotal, item quantity, or Rebuy data source requirements.

Smart Cart campaign is not loading

Cause: The Smart Cart may be unpublished, disabled, or missing a configured Tiered Progress Bar.

Resolution: Confirm the Smart Cart is enabled in Rebuy and verify the store domain configuration.

Rebuy widget is not recognized

Cause: The widget ID may be incorrect or associated with another store.

Resolution: Confirm you entered the correct Gift With Purchase widget ID rather than a data source ID.

Block does not appear in the app

Cause: The block may be configured to appear only when a tier is unlocked, or it may be placed on a screen without cart data.

Resolution: Change Block Visibility to Always show and confirm the block is placed on the Cart screen.

Considerations

Discount configuration: Rebuy's Shopify Functions must be properly configured for gifts to be discounted at checkout.
Gift eligibility: Threshold calculations use cart subtotal before shipping, taxes, and discount codes.
Manual tier limits: Each block supports up to four manual gifting tiers.
Cart availability: The block requires cart data and should generally be placed on the Cart screen.
Gift quantities: The native cart quantity selector cannot be hidden for gift products. Additional quantities beyond the configured discount limit may be charged at full price.
Discount stacking: Gift discounts can combine with other Shopify discounts according to your store's discount combination settings.
App-exclusive campaigns: Merchants can configure manual gifting campaigns without displaying the corresponding Rebuy widget on their website.
Reporting consistency: Attribution labels should be finalized before launching a campaign to avoid splitting reporting across multiple attribution groups.

Rebuy Gift With Purchase Integration