NOTE: Smile.io is an experimental integration built by Reactiv. Experimental integrations are not officially supported by a partner and must be used with caution.
Introduction
Enhance your Reactiv mobile app by integrating Smile.io, a powerful loyalty and rewards platform. This guide will walk you through the setup process to offer your customers loyalty points, rewards, and more within your app. Please note that the Smile.io integration is experimental and not officially supported by Smile.io. Use this integration with caution.
Prerequisites
1. Reactiv Account: Ensure you have an active Reactiv account.
2. Smile.io Account: Set up a Smile.io account and configure your loyalty program.
Step-by-Step Setup
Access the Integration Settings
Log in to your Reactiv dashboard.
Navigate to the Integrations page.
Enable Smile.io Integration
In the Integrations page, find Smile.io under Loyalty section.
Click on the Connect button to start the setup.
Enter Smile.io API Credentials
After enabling the integration, you will be prompted to enter your Smile.io API credentials.
API Key: Obtain this from your Smile.io dashboard under the API settings.
API Secret: Also found in your Smile.io API settings.
Enter these credentials in the provided fields and click Save.
How to find your Public & Private Keys in Smile.io
Step 1: Log in to Smile.io Admin
Go to the Smile.io Admin Dashboard and sign in with your store credentials (via Shopify, BigCommerce, or another platform integrated with Smile.io).
Step 2: Navigate to Settings
Once logged in, go to the Settings section in the left-hand navigation menu.
Step 3: Go to API Settings
In the Settings section, find and click on API (or Developer settings depending on the interface).
Step 4: Access Your API Keys
In the API section, you should see your Public Key and Private Key (sometimes referred to as the API Token or API Secret).
If no keys are listed, you may need to click Generate API Key or a similar option to create new keys.
Step 5: Copy the Public and Private Keys
Copy both the Public Key and Private Key securely. The Public Key is used for client-side integrations, while the Private Key is for secure server-side operations.
Step 6: Store Keys Securely
Ensure that both keys are stored safely, especially the Private Key, as it provides access to your Smile.io data and functionality.
Step 7: Contact Smile.io Support (if needed)
If you are unable to locate or generate the API keys, contact Smile.io support for assistance.
Enable Loyalty Points and Tier
Once your API credentials are validated, you'll be able to configure how loyalty details will be displayed in your app. Enable the loyalty points within your Reactiv app under the Account screen settings.
Open the Reactiv dashboard.
Navigate to Studio > Account > Settings
Enable the Loyalty points and Tier section in the account overview section.
Save and Preview your changes
Click on the Preview button in the header of the dashboard.
Follow the steps to preview your app in a real mobile app.
Test Your Integration
- Before publishing your app update, thoroughly test the Smile.io integration in the preview app.
- Ensure that points are being accrued and displayed correctly, rewards are redeemable.
Troubleshooting
If you encounter issues during the setup or operation of the Smile.io integration, here are a few steps you can take:
Recheck API Credentials: Ensure that your API Key and Secret are correct.
Contact Support: While the integration is experimental, you can reach out to Reactiv support for assistance. Provide detailed information about the issue for a faster resolution.
For any additional questions or support, feel free to contact our support team via chat or email.