Push Notifications

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.

{
  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"
}

​

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'