Enforce Gift Validity at Checkout

Overview

The Cart Checkout Validation function provides server-side enforcement of gift eligibility rules at checkout. It prevents customers from completing purchases with free gifts when they haven't met the qualifying thresholds for your rewards program.

This Shopify Function works on all Shopify plans, making gift eligibility enforcement available to every merchant using EliteCart.

When to Use This Function

Enable Cart Checkout Validation when you want to enforce thresholds at checkout. This feature ensures that customers can't bypass your gift-with-purchase rules by checking out with unqualified gifts. EliteCart already does a great job, but there are ways to get around the cart that we cannot prevent. This feature, on the other hand, can because it runs in the checkout.

How It Works

When a customer reaches checkout with gifts in their cart, the function validates that they've qualified for those gifts by:

1. Identifying gift products: Recognizes products tagged with _elite_gift in Shopify
2. Checking cart eligibility: Calculates whether the customer's cart meets your minimum threshold
3. Counting only qualifying items: Only counts items that should count toward your threshold:
   • Excludes gifts themselves
   • Excludes addons (like insurance or protection plans)
   • Excludes gift cards
   • Excludes products you've marked as ineligible
4. Evaluating your threshold rules: Your rules can be based on either:
   • Cart total: Customer's subtotal must reach your configured amount
   • Item count: Number of items must reach your configured count
5. Considering location & currency: Automatically accounts for where the customer is located and their currency
6. Enforcing at checkout: If the threshold isn't met, checkout is blocked with a clear message showing what's needed to qualify

Smart Exclusions

The validation function is smart about what counts toward your threshold, matching the normal gift behavior of your cart.

• Gifts are always excluded from threshold calculations
• Addons don't count toward item count but do count toward cart total
• Gift cards are completely excluded
• Products can be marked as excluded using the tag _elite_exclude_from_reward_calculation so they don't count toward thresholds

Market & Currency Awareness

The function automatically handles:

• Market-specific thresholds: Set different requirements for different countries
• Currency conversion: Automatically converts prices when evaluating cart totals
• Localized error messages: Shows customers messages in their language (9 languages supported)

Setup Instructions

1. Tag your gift products: In Shopify, add the tag _elite_gift to each product you want to offer as a gift reward
2. Go to your Cart Designer settings in EliteCart
3. Locate the "Gift eligibility enforcement" card
4. Click "Enable function"
5. Save your configuration

The function is deployed automatically to your Shopify store. Only products tagged with _elite_gift will be validated at checkout.

Limitations & Important Notes

Plan Requirements

This feature works on any EliteCart Plan

Mutual Exclusivity

You cannot enable both Cart Checkout Validation and Cart Transform simultaneously. Choose one:

• Cart Validation (all Shopify plans): Blocks ineligible checkouts
• Cart Transform (Shopify Plus only): Automatically discounts eligible gifts to $0

Error Handling

If your configuration is missing or invalid, the function fails gracefully and allows checkout. This ensures your store remains operational while you resolve configuration issues.

Discount Limitations

For technical reasons, EliteCart cannot access the discounted product prices at checkout. This means the validation logic is based on non-discounted product prices. In some cases, customers might be able to complete checkout with gifts even if a discount applied at checkout brings their cart total below the gift threshold.

Example: You've set that customers qualify for a gift when their cart total is $100 or greater. The customer's cart is $105 and they add a gift. At checkout, they apply a 20% discount, bringing the total to $84. Since EliteCart only sees the non-discounted total ($105), the gift passes validation. However, if the customer applies the discount in the cart using EliteCart's Discount Box feature, the validation would correctly identify that they no longer qualify for the gift.

Should you be concerned about this? Automatic discounts or discounts applied by apps are usually already active in the cart, so EliteCart's validation would correctly handle them. The main scenario to consider is if customers frequently apply large manual discounts at checkout. If this is a concern, you can enable EliteCart's Discount Box feature so customers apply discounts in the cart, triggering accurate validation based on the discounted total.

Supported Languages

The error messages displayed to customers are available in:

• English
• French
• German
• Italian
• Japanese
• Portuguese
• Spanish
• Swedish
• Dutch

For other languages, it will fall back to English.

Troubleshooting

Customers can still checkout with unqualified gifts?

• Verify the function is enabled in Cart Designer
• Check that your gift products have the _elite_gift tag in Shopify
• Ensure your gifts are properly configured in EliteCart
• Contact support if the issue persists

Wrong currency being used for thresholds?

• Verify your market configuration matches customer location
• Ensure currency settings are correct in your Shopify shop settings

Customers see generic error messages?

• Ensure your shop language is correctly set in Shopify
• The function supports 9 languages; if you use another language, English messages display by default