Skip to main content

Installing Loyalty to a Custom Platform

Blake
  • Updated

Follow this guide to set up Stamped Loyalty on a custom-built or unsupported ecommerce platform. There are two points of integration needed, and this guide walks you through each step.

In this guide

Installing the Loyalty Launcher

The Loyalty Launcher is where customers will interact with your rewards. Installation is simple and requires adding a script to the header of your site.

Add in Header:

<script> 
function myInit(){ 
   StampedFn.init({ apiKey: '##publicAPIKey##', storeUrl: '##storeUrl##' });
   StampedFn.on('stamped:init:starting', function(){
   	StampedFn.initRewards({
		customerId: 123456789, // your own internal numeric ID of the customer
		customerEmail: 'johndoh@example.com',
		customerFirstName: 'John',
        	customerLastName: 'Doh',
        	customerTags: '', // your internal customer tags, separate each tag with comma e.g. Wholesale, VIP
        	totalOrders: 0, // numeric indicating customer's total orders placed with your store
        	totalSpent: 0, // numeric indicating customer's total amount spent across all orders
        	isAcceptMarketing: true, // true or false
        	authToken: '' // CustomerId + CustomerEmail (with API Private key as HMAC key)
   	});
   });
}
</script>
<script async onload="myInit()" type="text/javascript" src="https://cdn1.stamped.io/files/widget.min.js"></script>

Note: Replace all variables with your store's and customer's info. ##storeUrl## should be without 'http' or '/'

If the customer hasn't logged in yet, simply call the function with an empty object StampedFn.initRewards({});

Pushing Orders to Stamped

Once you have installed the Loyalty Launcher using the script above, you'll need to set up a flow to notify Stamped when a new order has been created or fulfilled. This allows Stamped to create the orders, reward customers with their points, and update your data. You will set this up by pushing order data into Stamped using our REST API. Please use this REST API resource to configure.

 

Related articles