Skip to main content

Setting Up the Smile.io Integration

Smile.io is a loyalty and rewards platform that lets your customers earn points, unlock VIP tiers, and access referral rewards.

Written by Cecilia Wilbur

By connecting Smile.io with Stay AI, you can display your customers' loyalty information — including their points balance, available rewards, and ways to earn — directly inside the Stay AI customer portal, alongside their subscription details.

Follow the steps below to get started.


Before You Begin

  • You must have an active Smile.io account

  • You must have an active Stay AI account

  • Smile.io must be installed on your Shopify store

📌 Note: This integration is configured manually using custom HTML, CSS, and JavaScript. Sample code is provided to get you started, but neither Smile nor Stay AI provide technical support for managing or updating custom code over time. If you have questions about the Stay AI customer portal, contact Stay AI support. For questions about the Smile JavaScript SDK, contact Smile support.


1. Enable the Smile JavaScript SDK

The Smile JavaScript SDK powers the loyalty section that will appear in your Stay AI customer portal. You need to enable it in your Smile account before adding anything to Stay AI.

To enable the JavaScript SDK:

  1. Log in to your Smile Admin account

  2. Navigate to Settings > Developer Tools

  3. Locate the JavaScript SDK card and click Enable

If the JavaScript SDK is already enabled, proceed to Step 2.


2. Add the Loyalty Section to the Stay AI Customer Portal

Once the Smile JavaScript SDK is enabled, you'll add the loyalty section to your Stay AI customer portal by pasting custom CSS, HTML, and JavaScript into the portal's design settings.

The loyalty section will inherit your portal's existing color scheme, fonts, and button styles, and will automatically show or hide components based on how your Smile loyalty program is configured.

To add the loyalty section:

  1. In your Stay AI Merchant Portal, navigate to Legacy Portal > Design

  2. Scroll to the bottom of the page and expand the CSS section. Paste in the CSS code from the Smile.io setup guide.

  3. Expand the HTML section and paste in the HTML code from the setup guide

  4. Expand the JavaScript section and paste in the JavaScript code from the setup guide

  5. Click Submit at the top of the page to save your changes

📌 Note: Changes will not appear in the customer portal preview inside the Stay AI admin. To see the loyalty section live, log in to your Shopify store and visit your Stay AI customer portal directly at:

(Replace your-store-url.com with your actual store URL.)


3. Verify the Loyalty Section

After saving, confirm the loyalty section is displaying correctly for your customers.

To verify:

  1. Log in to your Shopify store as a customer (or use a test customer account)

  2. Navigate to your Stay AI customer portal at https://your-store-url.com/apps/retextion/

  3. Confirm the loyalty section is visible and displaying the correct information, including points balance, VIP tier, available rewards, redemption options, ways to earn, and referral details

Best Practice: Test with a customer account that already has a Smile.io points balance so you can confirm all sections render correctly — especially available rewards and redemption options.


What Your Customers Will See

Once set up, the loyalty section in the Stay AI customer portal displays:

  • Points balance and VIP tier status

  • Unused rewards available to apply to future purchases

  • All available redemption options, with the ability to redeem directly

  • Ways to earn more points in your loyalty program

  • Referral URL and referral program details

The section will automatically show or hide components based on how your Smile loyalty program is configured.


Known Limitations

  • The loyalty section is only available to customers who are logged in directly to your Shopify store. Customers who access the portal via a Stay AI magic link will not see the loyalty section.

Did this answer your question?