Stage of Life Merchant Network | API SET-UP

 Once the web service is configured for a client and an API key is provided, the data can be retrieved any time   using open standards. The web-based REST API uses the   Get method and returns utf-8 encoded XML that can then be readily manipulated using standard tools.

[To be provided]

 The XML feed includes the following fields about each offer and are defined as follows:

• <MerchantID> = GUID for each Merchant (Generic Unique ID)
• <MerchantName> = Merchant Name
• <MerchantLogo> = Link to logo image
• <MerchantImage> = Link to 2nd image (lifestyle image) if available for the offer
• <MerchantDescription> = Short company description
• <Title> = Offer Headline, e.g. “$5 off $25”
• <Redemption> = Promo Code (if one is required by the merchant for redemption)
• <OfferType>  = The type of offer, i.e. a file (coupon  artwork in the form of a PDF doc), image (coupon artwork in the form of a jpeg or gif file) or a link (web link for online redemption)
• <OfferData> = The actual file, image or link that serves as the redemption point
• <TermsConditions> = Specific terms and conditions for the offer, e.g. "Not valid on Monday"
• <StartDate> = Starting Validity Date of the Offer
• <EndDate>  = Ending Validity Date of the Offer
• <ID>  = 32 bit GUID (Generic Unique ID)  associated with each individual offer in the database
• <Category>  = Offer category tags, e.g. “Apparel”

 <EndDate>

Stage of Life automatically turns off any offer in its clients’ API feeds that reaches an “EndDate”. In this manner, Stage of Life keeps its merchant network clean of expired offers or inactive codes, links and coupons.

<ErrorMessage>

An <ErrorMessage> element appears at the end of the XML document. The possible error messages below will be returned as text in the "ErrorMessage" XML node.

1. "feedid parameter is not valid"

Description: A valid feedid parameter was not passed to the API.

2. "API access is disabled for this feed"

Description:The API feed has been disabled.

3. "API System Error, unable to pull feed settings"

Description: A system error has occurred. Please contact Eric Thiegs.

<Category>

The following category tags may appear with the offers. They can be used to categorize the merchants in the Stage of Life Merchant Network database for your program and member UX. These tag (or category) names are passed along appropriately for each merchant offer in the Stage of Life Offer Feed API...

Tags by Life Stage

• High School
• College
• On My Own
• Wedding
• Married
• Home Ownership
• Baby
• Family
• Grandparents
• Retirement

Tags by Offer Level

• Up to 5%
• Up to 10%
• Up to 15%
• Up to 20%
• Up to 25%
• Up to 30%+ 

Tags by Merchant Category

• All Deals
• Apparel
• Auto
• Books
• Babies & Kids
• Beauty
• Best Deals: 20% or better
• Car Rental
• Daily Deal
• Dining
• Education
• Electronics
• Entertainment
• Everyday
• Fitness
• Flowers & Gifts
• Gift Cards
• Grocery
• Health & Wellness
• Home & Garden
• Hotel
• In-Store
• Mobile & Internet
• Music & Movies (old - Music, Books and Movies)
• National Offers
• Night Life
• Outlets
• Pets
• Photo
• Recreation
• Services
• Shopping
• Small Business
• Sports
• Theater & the Arts
• Tickets & Events
• Travel & Cruise

Custom Tags

Available upon request and scope