Monetary's Engage platform objective is to simplify implementation of marketing functionality for POS developers, and streamline/simplify marketing for Merchants.
In the walkthrough below, we will cover how to authorize an API call to the Engage platform, register a customer for loyalty, and submit that customer's first receipt data that could spawn offers!
Every request requires two headers:
is easy, just insert your secret key in the Authorization header:
Authorization: secretKEYGOESHERE
The Engage only utilizes Content-Type: application/json
To register a customer for loyalty, utilize a POST to the v1/Customers endpoint.
{
"CustomerID": 123,
"ExternalID": "GGBilbo",
"Phone": "5551231234",
"Email": "[email protected]",
"FirstName": "Bob",
"LastName": "Baggens",
"Address": "123 Fake Street",
"City": "Durango",
"State": "CO",
"Zipcode": "81303",
"Birthday": "2017-04-20",
"AcceptsSMS": true,
"AcceptsEmail": true
}
To make complex marketing decisions based upon customer buying patterns, we just need the basic receipt data. PSOT this receipt data to the v1/Receipts endpoint.
{
"CustomerID": 123,
"Skus": [
{
"SKU": "SOCKS",
"Description": "AWESOME 80s Socks!",
"Amount": 10.50,
"Quantity": 2
}
],
"Discounts": [],
"SubTotal": 21.00,
"Taxes": 1.58,
"Total": 22.58
}
{
"ReceiptID": "0383b1c2438e4f82b516543de3522a4b",
"CustomerID": 123,
"Skus": [
{
"SKU": "SOCKS",
"Description": "AWESOME 80s Socks!",
"Amount": 10.50,
"Quantity": 2
}
],
"Discounts": [],
"SubTotal": 21,
"Taxes": 0.075,
"Tip": 0,
"Shipping": 0,
"Total": 22.58
}
If you have integrated these points, you have provided enough information Monetary to provide highly detailed, adaptive marketing functionality. For more information skip ahead to the appendix to see more actions our API can take, such as finding existing Customers, reviewing generated offers, etcetera!
If your Point of Sale already has marketing and loyalty type functionality, but your customer base would like to send your offers (coupons, discounts, free item codes, etc) via the Monetary Notification Platform, you can configure a Monetary Campaign. Monetary campaigns will submit an offer via SMS, Email, and/or App directly to the registered customer!
Below are additional resources for other endpoints (look up a customer for future purchases, etc.)
- Search Registered Customers
- Register Customer
- Retrieve Single Customer
- Update a Registered Customer
- Retrieve Customer Offers
- Retrieve Customer Receipt Data that has been submitted
If your point of sale has its own marketing strategy, but you would like to utilize the same notification and offers Monetary's automated campaigns generate, you can also utilize the monetary Campaign endpoint. These endpoints create manual campaigns. Manual campaigns are ways to deliver offers (coupons, discounts, etc.) to registered customers via POST to the Campaigns/Offers. Follow these easy steps to create and send offers to registered customers:
Submit a payload describing the offer you would like to send to registered customers. There are two endpoints that take and respond with the same payload:
Post here if you want an offer to only be used at a single location in a franchise/marketing group. It also Limits offers to only registered customers who have made a purchase at the location specified by the API key.
Post here if you want an offer to be available/redeemable at any location in the franchise/marketing group. Any registered customer can receive and redeem an offer generated with this campaign. Only the holding business is authorized to create group level campaigns.
{
"AmountOff": 10.05,
"MinimumPurchase": 0.5,
"DaysTillExpiration": 31
}
{
"CampaignID": 1,
"TemplateName": "manual",
"AmountOff": 10.05,
"MinimumPurchase": 0.5,
"DaysTillExpiration": 31,
"IsLocationSpecific": true
}
once you have the CampaignID, you can utilize the Campaigns/{CampaignID}/Offers endpoint to submit a list of CustomerID identifiers for the registered customers who should receive the offer:
[101,345,332]
204 Request accepted (no content)
Once we receive the list of customers, we determine if the list of customers can receive an offer for the given CampaignID (i.e. if the campaign is location specific, and if the customers in the list have made a purchase at the given location).