Skip to main content
This guide will show you how to create a dropdown of the available redemption options directly within your BigCommerce checkout. The dropdown will enable customers to redeem their points for a reward while checking out, and have the reward automatically applied to their cart.

​
Step 1: Include our sample code in your checkout page

From the BigCommerce theme editor, copy the contents of our smile-points-products-dropdown.html code sample into a new theme file. You will need to make sure that this file gets added to your checkout page.
This code snippet requires jQuery. If you do not already use jQuery on your site and wish to use the snippet as it, you will need to uncomment the jQuery script at the top of the snippet.

​
Step 2: Add your public API key to the script

Once you’ve located your public API key, paste it into the data-channel-key attribute on the script tag at the top of the code snippet (excerpt below).
HTML
<!-- NOTE: You will need to add your public key to the
  data-channel-key attribute below. -->
<script
  class="smile-bigcommerce-init"
  src="https://js.smile.io/v1/smile-bigcommerce.js"
  data-channel-key="PUBLIC_API_KEY_GOES_HERE"
></script>

​
Step 3: Filter out unwanted points products

Sometimes there are rewards in your program that don’t apply to the cart, such as email rewards or free products. You can hide points products from being shown in the dropdown by adding specific points product IDs to the hidePointsProductsIds variable. In order to find the IDs of points products that you want to hide, visit the Smile Admin and navigate to your points program. Go to your rewards and select one that you wish to hide from the points products dropdown. When you select a reward, you will be able to find the corresponding ID of the points product in the address bar. This ID can be added to the hidePointsProductsId variable in order to hide it from the dropdown.

​
Step 4: Add the points dropdown to your checkout page

Add the following div to your checkout page where you would like the dropdown to appear.
HTML
<div class="smile-points-products-dropdown"></div>

​
Step 5: Apply the discount code to the cart

In order for this component to function, you will need to write the code that takes the generated discount code and applies it to the cart. The applyPointsPurchaseToCart function is triggered when the customer clicks the “Redeem” button. Within this method, you’ll have access to the discount code which will need to be applied to the cart. The code is available via pointsPurchase.reward_fulfillment.code. The process of applying the discount code to your customer’s cart can be done via your cart’s API, or by a form field input simulated with JavaScript.

​
Step 6: Test it out

Visit your store’s checkout page to confirm your changes. If everything is working as expected, you’re done! 🎉

​
Tips for the best customer experience

Certain points products apply discounts to the cart in different ways. For example, gift cards can apply discounts to the total value of the cart whereas coupon codes may only apply discounts to the cart subtotal. There are other factors, including your region and cart setup, that prevent us from providing a single code sample that works flawlessly out of the box for every merchant. Our sample code is meant to get you up and running with giving your customers the option to spend their points at checkout. It allows them to purchase any points product they can afford. As a result, your customers may accidentally spend their points on a points product that has a greater value than what can actually be discounted from the cart. You may want to filter out these points products so that your customers are assured to have a great experience at checkout!