> ## Documentation Index > Fetch the complete documentation index at: https://docs.thanx.com/llms.txt > Use this file to discover all available pages before exploring further. # Push Notifications > Thanx sends users push notifications in a variety of situations, such as when they make a purchase or earn a reward. We can send push notifications to your app as well. When you are ready to register your app with Thanx for push notifications, you should send your CSM at Thanx your APNS certificate, FCM server key, and sender ID via a secure mechanism, such as Dropbox Transfer The rest of this page provides information regarding the types of push notifications that Thanx currently sends. A push notification payload will contain an event key and a merchant key. Each notification type may have other information provided. The sample notification text provided is not set in stone and will sometimes vary depending on the kinds of campaigns a merchant is running. ```bash Notification object example for iOS theme={null} { aps: { "alert": "You just made your first purchase at Pizza Merchant! You're now 56% towards your next reward here!", "badge": 1, "sound": "default", "content-available": 1 } "merchant_id": "oiu234oiurw", "event": "purchase_discount_applied", "purchase_id": "wotu310589" } ``` ```bash Notification object example for Android theme={null} { "content_available": true, "data": { "message": "You just made your first purchase at Pizza Merchant! You're now 56% towards your next reward here!", "merchant_id": "oiu234oiurw", "event": "purchase_discount_applied", "purchase_id": "wotu310589" }, "notification": { "title": "You just made your first purchase at Pizza Merchant! You're now 56% towards your next reward here!" } } ``` ## Purchase notifications When a user makes a purchase, one of the following notifications is sent: ### Discount Applied A user activated a statement credit reward, and this reward was applied to the purchase. *Thanx! You just saved \$10 at Pizza Merchant! It'll show up on your credit card statement in about two days.* ``` event: :purchase_discount_applied ``` Additional payload keys: ``` purchase_id: 'to35yu2o4i6y34io2j24' ``` ### Granted A user's receipt was accepted and they were granted progress toward their loyalty reward. *Heads up: Pizza Merchant granted you credit for \$15.63 toward your next reward.* ``` event: :progress_granted ``` Additional payload keys: ``` purchase_id: 'to35yu2o4i6y34io2j24' ``` ### Under Minimum A user had activated a statement credit reward, but didn't spend enough money on their subsequent purchase. *We couldn't apply your statement credit reward at Pizza Merchant - it was less than the \$25 minimum! We'll try to apply it to your next purchase.* ``` event: :reward_under_minimum ``` Additional payload keys: ``` reward_id: 'ri3of2o5i46o32iu4u4k' ``` ``` purchase_id: 'to35yu2o4i6y34io2j24' ``` ### Reward Earned This purchase resulted in a user earning their loyalty reward. *Cha-ching! You just earned \$10 off your purchase at Pizza Merchant! Open up Pizza Merchant and activate it when you're ready to use it.* ``` event: :purchase_reward_earned ``` Additional payload keys: ``` reward_id: 'ri3of2o5i46o32iu4u4k' ``` ``` purchase_id: 'to35yu2o4i6y34io2j24' ``` ### Initial Purchase The user made their first purchase. *You just made your first purchase at Pizza Merchant! You're now 56% towards your next reward here!* ``` event: :first_purchase ``` Additional payload keys: ``` purchase_id: 'to35yu2o4i6y34io2j24' ``` ### Reward Unused A user made a purchase and had a reward they could have used. *Heads up: you had a reward waiting for you at Pizza Merchant that you could have used! Activate it before your next visit!* ``` event: :purchase_reward_unused ``` Additional payload keys: ``` reward_id: 'ri3of2o5i46o32iu4u4k' ``` ``` purchase_id: 'to35yu2o4i6y34io2j24' ``` ### Invalid Purchase Amount A user made a purchase that was too small to count for loyalty progress. *Your purchase came in from Pizza Merchant but it was under the minimum purchase. Make a purchase over \$5 to earn loyalty progress.* ``` event: :purchase_under_minimum ``` Additional payload keys: ``` purchase_id: 'to35yu2o4i6y34io2j24' ``` ### Settlement Required A merchant's settings require a settlement to come in before the user can be granted loyalty progress. *Your Pizza Merchant purchase came through but reward progress won't apply until your credit card purchase settles. Stay tuned!* ``` event: :purchase_settlement_required ``` Additional payload keys: ``` purchase_id: 'to35yu2o4i6y34io2j24' ``` ### Tier Purchase Progress A user made a purchase that counted toward tier progress. If a merchant has both a loyalty campaign and tiers, the loyalty progress message will be sent instead. *You're on your way! Spend \$670.56 before the end of the year to earn Silver.* ``` event: :purchase_tier_progress ``` ### Loyalty Progress A user made a purchase that counted toward loyalty progress. *You're almost there! You're now 45% toward your next reward at Pizza Merchant.* ``` event: :purchase_loyalty_progress ``` Additional payload keys: ``` purchase_id: 'to35yu2o4i6y34io2j24' ``` ## Tiers notifications ### On track to reach the silver tier *You're on track to reach Silver for Pizza Merchant - spend \$35.24 more by Dec 31st!* ``` event: :tier_silver_on_track ``` ### Reached the silver tier *Silver rewards at Pizza Merchant are yours! Congrats on achieving Silver status!* ``` event: :tier_silver_reached ``` ### On track to reach the gold tier *You're on track to reach Gold for Pizza Merchant - spend \$23.45 more by Dec 31st!* ``` event: :tier_gold_on_track ``` ### Reached the gold tier *Congrats on achieving Gold status at Pizza Merchant! Open up the app to see your new perks!* ``` event: :tier_gold_reached ``` ### Tier status expiring soon *Your Gold status runs out in four weeks. Spend \$450.24 to keep it for another year!* ``` event: :tier_status_expiring ``` ## Vip notifications As users earn toward VIP status, they receive the following messages. ### VIP active *You're a Pizza Merchant VIP! Open up the app to check out your VIP Reward!* ``` event: :vip_active ``` ### VIP at risk *You're almost out of time! You still need to spend \$35 before Dec 1st to remain a Pizza Merchant VIP.* ``` event: :vip_at_risk ``` ### VIP eligible *You're eligible for VIP this month at Pizza Merchant! Spend \$50 before the end of the month to earn VIP status through Jan 1st!* ``` event: :vip_eligible ``` ### VIP on track *Your spending makes you eligible to earn VIP at Pizza Merchant! Spend \$50 next month to earn a free pizza all month!* ``` event: :vip_on_track ``` ### VIP nearly there *You're almost a Pizza Merchant VIP! Spend \$45 before Dec 1st to earn a free cactus all month!* ``` event: :vip_visible ``` ## Reward notifications ### A reward is issued This text is customizable by the merchant when they run a campaign. If customized text isn't provided, the following text is used. *You have a new reward from Pizza Merchant!* ``` event: :reward_issued ``` Additional payload keys: ``` reward_id: 'ri3of2o5i46o32iu4u4k' ``` ### A reward is expiring *Heads up! Your \$5 off at Pizza Merchant expires on 12/15! Don’t miss out!* ``` event: :reward_expiring ``` Additional payload keys: ``` reward_id: 'ri3of2o5i46o32iu4u4k' ``` ### A reward was granted The merchant issued a user a reward as a result of NPS feedback. *Pizza Merchant granted you a new reward: a free pizza!* ``` event: :reward_granted ``` Additional payload keys: ``` reward_id: 'ri3of2o5i46o32iu4u4k' ``` ### Reminder about an unused reward *Don't forget! You have a reward (\$15 off) waiting for you at Pizza Merchant!* ``` event: :reward_reminder ``` Additional payload keys: ``` reward_id: 'ri3of2o5i46o32iu4u4k' ``` ## Other notifications ### NPS prompt *How was your visit to Pizza Merchant?* ``` event: :purchase_nps_prompt ``` Additional payload keys: ``` purchase_id: 'to35yu2o4i6y34io2j24' ``` ``` feedback_id: 'ghjh2k34j5l23kj44566' ```