Before You Start

This guide is for merchants who have already connected Oshi to Klaviyo. If you haven’t done that yet, follow our integration guide first.

Once connected, Oshi automatically pushes reward activity—purchases, redemptions, referrals, VIP tier changes, and more—directly into Klaviyo. This guide will show you how to turn that data into powerful customer flows.

By the end, you’ll know how to:

Build core emails (purchase rewards, referral bonuses, social rewards)
Add engagement emails (reminders, social engagement, referral links)
Leverage customer properties for personalized content blocks (VIP status, referral stats, tier progress)
Reference all available Liquid fields for rewards emails

Core emails

These are the essential customer communication emails for your Bitcoin rewards and loyalty program. Without them, customers won’t see the rewards they’ve earned, redeem bonuses, refer friends, engage on social for rewards, or take advantage of affiliate incentives. These emails keep customers aware of their rewards activity and motivated to keep earning and redeeming.

Purchase Reward Emails

These event-triggered emails are sent when a customer earns Bitcoin rewards on a purchase. Use a trigger split so the message and CTA fit their enrollment status.

How to set up in Klaviyo →

Example Email Copy

Use these as starting points for your purchase reward emails. Customize the copy, branding, and design to match your voice and style. The liquid template fields will automatically populate with your customer's specific reward data.

First-Time Users (Not Yet Enrolled)

Send this to customers who earned their first Bitcoin rewards but haven't joined the program yet. The goal is to get them enrolled and claiming their rewards.

Flow filter: oshi_enrolled equals false

Email Content

Subject

You've earned {{ event.reward_sats_back|default:'' }} sats - Claim your Bitcoin rewards

Preview text

Claim your {{ event.reward_btc_back|default:'' }} BTC before it expires.

Body

Congratulations! You've earned {{ event.reward_sats_back|default:'' }} sats ({{ event.reward_btc_back|default:'' }} BTC) from your recent purchase.

Claim your first Bitcoin reward and join our rewards program. Unclaimed rewards expire in 30 days.

CTA Button

{{ event.reward_portal_url|default:'' }}

Existing Members (Already Enrolled)

Send this to customers who are already program members. The goal is to show their updated balance and encourage continued engagement.

Flow filter: oshi_enrolled equals true

Email Content

Subject

{{ event.reward_sats_back|default:'' }} sats added to your balance

Preview text

Your balance is updated. See what you can do next.

Body

Nice! You just earned {{ event.reward_sats_back|default:'' }} sats ({{ event.reward_btc_back|default:'' }} BTC) from your purchase.

Current balance: {{ person.oshi_rewards_current_balance_sats|default:'' }} sats

Check your rewards portal to redeem or earn more.

CTA Button

{{ person.oshi_rewards_portal_url|default:'' }}

Referral Bonus Emails

These event-triggered emails are sent when a referred customer makes their first purchase, triggering Bitcoin rewards for both customers.

How to set up in Klaviyo →

Example Email Copy

Use these as starting points for your referral bonus emails. Customize the copy, branding, and design to match your voice and style. The trigger split will automatically route customers to the appropriate template based on their referral type.

Referring Customer Email

This email is sent to the customer who shared their referral link when their referred friend makes a purchase.

Flow filter: referral_type equals referrer

Email Content

Subject

You earned {{ event.referral_reward_sats|default:'' }} sats for your referral!

Preview text

Your friend made a purchase - {{ event.referral_reward_btc|default:'' }} BTC added to your balance.

Body

Great news! A friend made their first purchase using your referral link. As a thank you, we've added {{ event.referral_reward_sats|default:'' }} sats ({{ event.referral_reward_btc|default:'' }} BTC) to your rewards balance.

Keep sharing your link to earn {{ event.program_referrer_commission_pct|default:'' }}% on every friend's first purchase!

Your referral link: {{ person.oshi_referrals_reflink|default:'' }}

CTA Button

{{ person.oshi_rewards_portal_url|default:'' }}

Referred Customer Email

This email is sent to the new customer who used a referral link to make their first purchase.

Flow filter: referral_type equals referral

Email Content

Subject

Here's your {{ event.referral_reward_sats|default:'' }} sats referral bonus!

Preview text

Welcome! Your {{ event.referral_reward_btc|default:'' }} BTC bonus is ready.

Body

Welcome to our Bitcoin rewards program! Your referral bonus of {{ event.referral_reward_sats|default:'' }} sats ({{ event.referral_reward_btc|default:'' }} BTC) is now in your account.

Share your referral link to earn more: {{ person.oshi_referrals_reflink|default:'' }}

CTA Button

{{ person.oshi_rewards_portal_url|default:'' }}

Affiliate Commission Emails

These event-triggered emails are sent when affiliates earn ongoing commission from their referred customers' purchases. This is separate from the one-time referral bonus - affiliate commissions are earned on every future purchase made by referred customers.

How to set up in Klaviyo →

Example Email Copy

Use this as a starting point for your affiliate commission emails. Customize the copy, branding, and design to match your voice and style.

Affiliate Commission Email

This email is sent when an affiliate earns commission from a referred customer's purchase.

Email Content

Subject

You earned {{ event.affiliate_reward_sats|default:'' }} sats in affiliate commission!

Preview text

Your referral made a purchase - {{ event.affiliate_reward_btc|default:'' }} BTC earned.

Body

Great news! One of your referrals made a purchase and you've earned {{ event.affiliate_reward_sats|default:'' }} sats ({{ event.affiliate_reward_btc|default:'' }} BTC) in affiliate commission.

{% catalog "oshi_rewards_config" %}
You continue to earn {{ catalog_item.metadata.lifetime_commission_rate }}% on all their future purchases through our affiliate program.

Keep sharing your referral link to build your earning network:
{{ event.affiliate_reflink|default:person.oshi_referrals_reflink|default:'' }}
{% endcatalog %}

CTA Button

{{ event.reward_portal_url|default:person.oshi_rewards_portal_url|default:'' }}

Social Rewards Email

Send a single Klaviyo flow for any social engagement reward. No enrollment filter is needed — only enrolled customers can earn social rewards.

Example Email Copy

Use this as a starting point for your social engagement emails. Customize the copy, branding, and design to match your voice and style. The dynamic content will automatically show the correct platform-specific messaging.

Social Rewards Example

Dynamic template that automatically customizes content based on the social platform where the customer engaged.

Email Content

Subject

You earned {{ event.social_reward_sats|default:'' }} sats for following us on {{ event.social_platform|default:'' }}

Preview text

Your rewards balance has been updated.

Body

Thanks for engaging with us on {{ event.social_platform|default:'' }}! You've earned {{ event.social_reward_sats|default:'' }} sats ({{ event.social_reward_btc|default:'' }} BTC).

Open your rewards portal anytime to view your balance and discover more ways to earn.

CTA Button

{{ event.reward_portal_url|default:'' }}

Examples of core Bitcoin rewards emails — purchase rewards, referral bonuses, and social engagement offers.

Engagement Emails (Recommended)

These are engagement + re-engagement touches that keep customers earning and redeeming between purchases. They’re optional, but they reliably drive lift when you keep cadence tight and copy short.

Reminder Emails

These time-delayed emails remind customers to claim their Bitcoin rewards before they expire. They work as part of your Purchase Rewards flow - specifically targeting the No branch (non-enrolled customers) to help increase enrollment rates.

How to set up in Klaviyo →

Example Email Copy

Use these as starting points for your reminder emails. Customize the copy, branding, and urgency level to match your voice and style. These templates help convert non-enrolled customers by creating urgency around reward expiration.

15-Day Reminder

Gentle reminder for customers who earned Bitcoin rewards but haven't claimed them yet. This gives them time to discover and claim their rewards without pressure.

Flow filter: oshi_enrolled equals false

Email Content

Subject

Don't miss out on your {{ event.reward_sats_back|default:'' }} sats reward!

Preview text

Your Bitcoin rewards are waiting - claim them before they expire.

Body

You earned {{ event.reward_sats_back|default:'' }} sats from your recent purchase but haven't claimed them yet.



Your Bitcoin rewards are waiting! Create your account to claim them before they expire.

CTA Button

{{ person.oshi_rewards_portal_url|default:'' }}

30-Day Final Reminder

Friendly final notice for customers who still haven't claimed their Bitcoin rewards. This is their last opportunity before the rewards expire.

Flow filter: oshi_enrolled equals false

Email Content

Subject

Your {{ event.reward_sats_back|default:'' }} sats are about to expire

Preview text

Your Bitcoin rewards are still waiting to be claimed.

Body

Your {{ event.reward_sats_back|default:'' }} sats are still waiting to be claimed.



Don't forget about your Bitcoin rewards before they expire!

CTA Button

{{ person.oshi_rewards_portal_url|default:'' }}

Social Engagement Email

This email introduces newly enrolled customers to social earning opportunities. Send it within 3-7 days after enrollment to maximize engagement while the Bitcoin rewards program is still top-of-mind.

Best timing: 3-7 days after oshi_enrolled equals true
Target audience: Recently enrolled customers only

Example Email Copy

Use this as a starting point for your social engagement emails. Simple template to encourage customers to follow you on social media.

Social Engagement Example

Simple email to encourage customers to follow you on social media and earn Bitcoin rewards.

Email Content

Subject

Follow us on social media and earn Bitcoin rewards

Preview text

Earn Bitcoin rewards for following us on social media.

Body

Follow us on social media and earn Bitcoin rewards!

{% catalog "oshi_rewards_config" %}
Follow and earn:
Instagram: {{ catalog_item.metadata.social_instagram }} sats
X (Twitter): {{ catalog_item.metadata.social_x }} sats
YouTube: {{ catalog_item.metadata.social_youtube }} sats
Facebook: {{ catalog_item.metadata.social_facebook }} sats
Nostr: {{ catalog_item.metadata.social_nostr }} sats
{% endcatalog %}

Visit your rewards portal to start earning.

CTA Button

{{ person.oshi_rewards_portal_url|default:'' }}

Referral Engagement Email

Encourage enrolled customers to share their referral link and earn Bitcoin rewards for helping your brand grow. Send after customers have had time to experience your product and can authentically recommend it to friends.

Best timing: 7-14 days after oshi_enrolled equals true
Target audience: Recently enrolled customers who have experienced the product

How to set up in Klaviyo →

Example Email Copy

Use this as a starting point for your referral engagement emails. Simple template to encourage customers to share their referral link.

Referral Engagement Example

Simple email to encourage customers to share their referral link and earn Bitcoin rewards.

Email Content

Subject

Get paid in Bitcoin for sharing with friends

Preview text

{% catalog "oshi_rewards_config" %}Earn {{ catalog_item.metadata.referrer_commission_rate }}% back in Bitcoin on every friend's purchase{% endcatalog %}

Body

Help our brand grow and get paid in Bitcoin for every friend you refer!

{% catalog "oshi_rewards_config" %}
Here's how it works:
• Share your unique referral link
• Your friends get {{ catalog_item.metadata.referral_bonus_rate }}% back in Bitcoin on their first purchase
• You earn {{ catalog_item.metadata.referrer_commission_rate }}% back in Bitcoin on every purchase they make
• Plus {{ catalog_item.metadata.lifetime_commission_rate }}% ongoing commission on their future purchases

Your referral link: {{ person.oshi_referrals_reflink|default:'' }}
{% endcatalog %}

Start sharing and start earning!

CTA Button

{{ person.oshi_referrals_reflink|default:'' }}

Examples of additional Bitcoin rewards emails — including social engagement, reward expiration reminders, and referral promotions.

Leveraging Customer Properties

Beyond basic reward emails, use the rich customer data to create engaging, personalized content blocks. These examples show how to leverage VIP status, program rates, and customer history for more compelling emails.

VIP Tier Progress

Show customers their VIP progress to motivate continued engagement and spending.

Text-Based VIP Progress

VIP Progress Copy

{% if person.oshi_vip_tier_next %}
You're currently a {{ person.oshi_vip_tier_current|default:'' }} member earning {{ person.oshi_vip_tier_current_rate|default:'' }}% back!
You're {{ person.oshi_vip_tier_progress_pct|default:'' }}% of the way to {{ person.oshi_vip_tier_next|default:'' }} tier.
Spend just ${{ person.oshi_vip_tier_remaining_usd|default:'' }} more to unlock {{ person.oshi_vip_tier_next_rate|default:'' }}% back on all purchases!
{% else %}
Congratulations! You're at our highest {{ person.oshi_vip_tier_current|default:'' }} tier earning {{ person.oshi_vip_tier_current_rate|default:'' }}% back on all purchases!
{% endif %}

HTML Progress Bar

VIP Progress Bar HTML

<div style="background: #e5e7eb; border-radius: 10px; height: 20px; overflow: hidden; margin: 16px 20px; max-width: 400px; width: calc(100% - 40px); margin-left: auto; margin-right: auto;">
  <div style="background: #3b82f6; height: 100%; width: {% if person.oshi_vip_tier_next %}{{ person.oshi_vip_tier_progress_pct|default:'0' }}{% else %}100{% endif %}%;"></div>
</div>

VIP Program Information

Display all VIP tiers dynamically from your Klaviyo Catalog. The OSHI dashboard automatically syncs all program changes, so this information is always current.

VIP Tiers Overview

All VIP Tiers Block

{% catalog "oshi_rewards_config" %}
VIP Tier Rewards:

{% if catalog_item.metadata.vip_tier_1_name %}
{{ catalog_item.metadata.vip_tier_1_name }}: {{ catalog_item.metadata.vip_tier_1_rate }}% back (spend ${{ catalog_item.metadata.vip_tier_1_threshold }}+)
{% endif %}

{% if catalog_item.metadata.vip_tier_2_name %}
{{ catalog_item.metadata.vip_tier_2_name }}: {{ catalog_item.metadata.vip_tier_2_rate }}% back (spend ${{ catalog_item.metadata.vip_tier_2_threshold }}+)
{% endif %}

{% if catalog_item.metadata.vip_tier_3_name %}
{{ catalog_item.metadata.vip_tier_3_name }}: {{ catalog_item.metadata.vip_tier_3_rate }}% back (spend ${{ catalog_item.metadata.vip_tier_3_threshold }}+)
{% endif %}

{% if catalog_item.metadata.vip_tier_4_name %}
{{ catalog_item.metadata.vip_tier_4_name }}: {{ catalog_item.metadata.vip_tier_4_rate }}% back (spend ${{ catalog_item.metadata.vip_tier_4_threshold }}+)
{% endif %}

{% if catalog_item.metadata.vip_tier_5_name %}
{{ catalog_item.metadata.vip_tier_5_name }}: {{ catalog_item.metadata.vip_tier_5_rate }}% back (spend ${{ catalog_item.metadata.vip_tier_5_threshold }}+)
{% endif %}
{% endcatalog %}

Program Overview

Show customers all the ways they can earn rewards to encourage cross-engagement.

More Ways to Earn Block

{% catalog "oshi_rewards_config" %}
More ways to earn Bitcoin rewards:

• You currently earn {{ person.oshi_vip_tier_current_rate|default:catalog_item.metadata.standard_rate }}% back on purchases

• VIP members get up to {{ catalog_item.metadata.vip_max_rate }}% back

• Pay with Bitcoin for an extra {{ catalog_item.metadata.bitcoin_payment_bonus_rate }}% bonus

• Refer friends and earn {{ catalog_item.metadata.referrer_commission_rate }}% on their purchases

• Your friends get {{ catalog_item.metadata.referral_bonus_rate }}% on their first purchase

• Earn up to {{ catalog_item.metadata.social_total }} sats from social engagement
{% endcatalog %}

Referral Stats

Celebrate customer referral success and encourage more sharing.

Referral Achievement Block

{% catalog "oshi_rewards_config" %}
You've successfully referred {{ person.oshi_referrals_total_referred|default:'' }} friends to our Bitcoin rewards program.
Keep sharing your link to earn {{ catalog_item.metadata.referrer_commission_rate }}% on every friend's first purchase!

Your referral link: {{ person.oshi_referrals_reflink|default:'' }}
{% endcatalog %}

Customer Overview

Show customers their complete rewards history and relationship with your business.

Rewards Summary Block

Total earned: {{ person.oshi_rewards_total_earned_sats|default:'' }} sats
Current balance: {{ person.oshi_rewards_current_balance_sats|default:'' }} sats
VIP status: {{ person.oshi_vip_tier_current|default:'' }} member
Friends referred: {{ person.oshi_referrals_total_referred|default:'' }} people

Examples of personalized Bitcoin rewards emails that leverage customer properties such as VIP tiers, program overviews, and individual progress.

Personalization Fields Reference

Complete reference for all personalization fields available in Oshi rewards program emails. Fields are organized by data source for easier understanding and implementation.

💡 Data Source Guide

Profile Fields → Customer's current status (use person.field_name)
Event Fields → Transaction-specific data (use event.field_name)
Catalog Fields → Program configuration (use {% catalog %} block)

Customer Profile Fields

Customer-specific data from their profile. These fields reflect the customer's current status, balances, and personal information.

💰 Rewards Balance

Total Earned (Sats)

{{ person.oshi_rewards_total_earned_sats|default:'' }}→ 35000

Total sats ever earned by customer from your business. Great for celebrating milestones and showing long-term value.

Total Earned (BTC)

{{ person.oshi_rewards_total_earned_btc|default:'' }}→ 0.00035

Total BTC earned (decimal format). Use alongside sats for customers who prefer BTC units.

Current Balance (Sats)

{{ person.oshi_rewards_current_balance_sats|default:'' }}→ 28000

Available sats balance for spending/redemption. Perfect for showing updated balances and encouraging redemption.

Current Balance (BTC)

{{ person.oshi_rewards_current_balance_btc|default:'' }}→ 0.00028

Available BTC balance (decimal format). Use for customers who think in BTC terms.

Rewards Portal URL

{{ person.oshi_rewards_portal_url|default:'' }}→ https://oshiapp.com/rewards/customer123

Customer's personal rewards dashboard URL. Use in CTA buttons to direct to balance and redemption page.

Enrollment Status

{{ person.oshi_enrolled|default:'' }}→ true

Boolean indicating if customer is enrolled in rewards program. Essential for flow filtering and conditional messaging.

👑 VIP Tier Status

Current VIP Tier

{{ person.oshi_vip_tier_current|default:'' }}→ Gold

Customer's current VIP tier name. Use to personalize messaging and show tier-specific benefits.

Current Tier Rate

{{ person.oshi_vip_tier_current_rate|default:'' }}→ 7

Percentage back the customer currently earns at their VIP tier. Show their current earning power.

VIP Tier Progress

{{ person.oshi_vip_tier_progress_pct|default:'' }}→ 60

Percentage progress toward next VIP tier (0-100). Perfect for progress bars and motivational messaging.

Next VIP Tier

{{ person.oshi_vip_tier_next|default:'' }}→ Platinum

Next achievable VIP tier name (null if at max tier). Use with conditional logic for progression messaging.

Next Tier Rate

{{ person.oshi_vip_tier_next_rate|default:'' }}→ 10

Percentage back at next VIP tier (null if at max tier). Show upgrade motivation and benefits.

Amount Needed for Next Tier

{{ person.oshi_vip_tier_remaining_usd|default:'' }}→ 600.00

Dollar amount needed to reach next VIP tier (null if at max tier). Create urgency and clear goals.

🔗 Referral Program

Total Referrals Made

{{ person.oshi_referrals_total_referred|default:'' }}→ 8

Total number of successful referrals this customer has made. Celebrate achievements and encourage more sharing.

Personal Referral Link

{{ person.oshi_referrals_reflink|default:'' }}→ https://oshiapp.com/referral/customer123

Customer's unique referral link. Essential for referral promotion - make sharing easy and trackable.

Event-Specific Fields

Data specific to the event that triggered the email (purchase, social engagement, referral). These fields contain transaction-specific information.

💳 Purchase Transaction Fields

Sats Earned (This Transaction)

{{ event.reward_sats_back|default:'' }}→ 1538

Sats earned from THIS specific transaction. Use to celebrate the customer's reward and show exact amount earned.

BTC Earned (This Transaction)

{{ event.reward_btc_back|default:'' }}→ 0.00001538

BTC earned from THIS transaction (decimal format). Perfect for showing BTC equivalent alongside sats.

Transaction Reward Portal URL

{{ event.reward_portal_url|default:'' }}→ https://oshiapp.com/rewards/customer123

Link to customer's rewards portal for this specific transaction. Use in CTA buttons for claiming rewards.

📱 Social Engagement Fields

Social Platform

{{ event.social_platform|default:'' }}→ Instagram

Platform where engagement occurred (Instagram, X, Facebook, YouTube, Nostr). Personalize messaging by platform.

Social Reward Sats

{{ event.social_reward_sats|default:'' }}→ 250

Sats earned from social engagement. Show customers exactly how much they earned for following/sharing.

Social Reward BTC

{{ event.social_reward_btc|default:'' }}→ 0.00000250

BTC equivalent of social engagement rewards. Display alongside sats for clarity.

🎁 Referral Event Fields

Referral Type

{{ event.referral_type|default:'' }}→ referrer

Either "referrer" or "referral". Use for flow filtering to send different emails to the person who referred vs the new customer who was referred.

Referral Reward Sats

{{ event.referral_reward_sats|default:'' }}→ 1000

Sats earned from referral activity. Show specific bonus amount in referrer and referred customer emails.

Referral Reward BTC

{{ event.referral_reward_btc|default:'' }}→ 0.00001000

BTC equivalent of referral rewards. Display alongside sats for multiple value perspectives.

Event Referral Link

{{ event.referral_reflink|default:'' }}→ https://oshi.link/customer123

Referral link associated with this specific transaction. Show which link was used in confirmation emails.

🏦 Affiliate Commission Event Fields

Affiliate Reward Sats

{{ event.affiliate_reward_sats|default:'' }}→ 3200

Sats earned from affiliate commission. Show the commission amount earned when a referred customer makes a purchase.

Affiliate Reward BTC

{{ event.affiliate_reward_btc|default:'' }}→ 0.000032

BTC equivalent of affiliate commission. Display alongside sats for clarity.

Affiliate Referral Link

{{ event.affiliate_reflink|default:'' }}→ https://oshi.link/affiliate123

The affiliate's unique referral link. Encourage continued sharing to grow their earning network.

Reward Portal URL

{{ event.reward_portal_url|default:'' }}→ https://oshiapp.com/rewards/affiliate123

Link to the affiliate's rewards portal. Use in CTA buttons to view commission balance.

🏆 VIP Context (Event Snapshot)

VIP Tier at Transaction

{{ event.vip_tier_current|default:'' }}→ Gold

Customer's VIP tier at time of this transaction. Shows historical context for the reward earned.

VIP Rate at Transaction

{{ event.vip_tier_current_rate|default:'' }}→ 7

VIP rate that applied to this transaction. Explain why they earned this specific amount.

VIP Progress at Transaction

{{ event.vip_progress_pct|default:'' }}→ 65

VIP tier progress at time of transaction. Show how this purchase moved them closer to next tier.

Amount Still Needed (at Transaction)

{{ event.vip_remaining_usd|default:'' }}→ 350.00

Amount needed for next tier at transaction time. Create urgency for additional purchases.

Program Configuration (Catalog)

Program configuration data from your Klaviyo catalog. Always use within {% catalog "oshi_rewards_config" %} blocks. These update automatically when you change program settings.

Usage Pattern:

{% catalog "oshi_rewards_config" %}
Standard rate: {{ catalog_item.metadata.standard_rate }}%
VIP max rate: {{ catalog_item.metadata.vip_max_rate }}%
{% endcatalog %}

💎 Core Program Rates

Standard Purchase Rate

{{ catalog_item.metadata.standard_rate }}→ 3

Default percentage back on purchases for regular customers. Use to promote purchase rewards across all email types.

Bitcoin Payment Bonus Rate

{{ catalog_item.metadata.bitcoin_payment_bonus_rate }}→ 1

Extra percentage earned when customers pay with Bitcoin. Promote Bitcoin payments and show additional earning opportunity.

Referral Bonus Rate

{{ catalog_item.metadata.referral_bonus_rate }}→ 10

Percentage new customers get on their first purchase. Encourage referral sharing by showing friend benefits.

Referrer Commission Rate

{{ catalog_item.metadata.referrer_commission_rate }}→ 8

Percentage referrers earn when friends make purchases. Motivate referral sharing with earning potential.

Lifetime Commission Rate

{{ catalog_item.metadata.lifetime_commission_rate }}→ 7

Ongoing commission percentage for lifetime referrals. Show long-term earning potential for quality referrals.

👑 VIP Program Configuration

VIP Maximum Rate

{{ catalog_item.metadata.vip_max_rate }}→ 10

Highest percentage available through VIP tiers. Use to show ultimate earning potential.

VIP Tier 1 (Bronze)

{{ catalog_item.metadata.vip_tier_1_name }}→ Bronze
{{ catalog_item.metadata.vip_tier_1_rate }}→ 3
{{ catalog_item.metadata.vip_tier_1_threshold }}→ 0

Tier 1 name, rate, and minimum spend threshold. Use to show VIP tier structure and entry requirements.

VIP Tier 2 (Silver)

{{ catalog_item.metadata.vip_tier_2_name }}→ Silver
{{ catalog_item.metadata.vip_tier_2_rate }}→ 5
{{ catalog_item.metadata.vip_tier_2_threshold }}→ 100

Tier 2 configuration. Perfect for showing progression path and next tier benefits.

VIP Tier 3 (Gold)

{{ catalog_item.metadata.vip_tier_3_name }}→ Gold
{{ catalog_item.metadata.vip_tier_3_rate }}→ 7
{{ catalog_item.metadata.vip_tier_3_threshold }}→ 300

Tier 3 configuration. Use for mid-tier messaging and progression motivation.

VIP Tier 4 (Platinum)

{{ catalog_item.metadata.vip_tier_4_name }}→ Platinum
{{ catalog_item.metadata.vip_tier_4_rate }}→ 10
{{ catalog_item.metadata.vip_tier_4_threshold }}→ 1000

Tier 4 configuration. Show premium benefits and high-value customer rewards.

VIP Tier 5 (Diamond)

{{ catalog_item.metadata.vip_tier_5_name }}→ Diamond
{{ catalog_item.metadata.vip_tier_5_rate }}→ 10
{{ catalog_item.metadata.vip_tier_5_threshold }}→ 2500

Highest tier configuration. Celebrate top-tier customers and show exclusive benefits.

📱 Social Rewards Configuration

Instagram Rewards

{{ catalog_item.metadata.social_instagram }}→ 250

Sats reward for Instagram engagement. Use to promote Instagram following and engagement.

X (Twitter) Rewards

{{ catalog_item.metadata.social_x }}→ 200

Sats reward for X engagement. Encourage Twitter/X following and sharing.

Facebook Rewards

{{ catalog_item.metadata.social_facebook }}→ 150

Sats reward for Facebook engagement. Promote Facebook page engagement.

YouTube Rewards

{{ catalog_item.metadata.social_youtube }}→ 300

Sats reward for YouTube engagement. Encourage channel subscriptions and video engagement.

Nostr Rewards

{{ catalog_item.metadata.social_nostr }}→ 500

Sats reward for Nostr engagement. Promote Nostr following for Bitcoin-native audience.

Total Social Rewards

{{ catalog_item.metadata.social_total }}→ 1400

Total sats available across all social platforms. Show complete earning potential from social engagement.

🎛️ Feature Flags

VIP Program Enabled

{{ catalog_item.metadata.vip_enabled }}→ true

Boolean controlling VIP tier messaging in emails. Use for conditional VIP content display.

Bitcoin Bonus Enabled

{{ catalog_item.metadata.bitcoin_bonus_enabled }}→ true

Boolean controlling Bitcoin payment bonus messaging. Use for conditional Bitcoin promotion.

Referral Program Enabled

{{ catalog_item.metadata.referral_enabled }}→ true

Boolean controlling referral program messaging. Use for conditional referral content.

Social Rewards Enabled

{{ catalog_item.metadata.social_enabled }}→ true

Boolean controlling social rewards messaging. Use for conditional social engagement promotion.

Advanced Usage Patterns

🎯 Flow Filtering Strategies

Enrollment Status Filtering

{{ person.oshi_enrolled }} equals true

Split flows between enrolled and non-enrolled customers for different messaging.

Referral Type Filtering

{{ event.referral_type }} equals "referrer"

Separate referrer rewards from referral bonuses with different email content.

VIP Tier Filtering

{{ person.oshi_vip_tier_current }} equals "Platinum"

Create tier-specific flows for personalized VIP messaging.

Social Platform Filtering

{{ event.social_platform }} equals "Instagram"

Customize social reward emails by platform for relevant messaging.

🔄 Cross-Promotion Strategies

Purchase Email → Referral Promotion

{% catalog "oshi_rewards_config" %}
Share your link and earn {{ catalog_item.metadata.referrer_commission_rate }}% on friends' purchases!
{% endcatalog %}

Use purchase emails to promote referral earning opportunities.

Social Email → VIP Tier Promotion

{% catalog "oshi_rewards_config" %}
VIP members earn up to {{ catalog_item.metadata.vip_max_rate }}% on purchases!
{% endcatalog %}

Use social reward emails to promote VIP tier benefits.

Dynamic Rate Display

You currently earn {{ person.oshi_vip_tier_current_rate|default:catalog_item.metadata.standard_rate }}% back

Show personalized rates falling back to standard rate for non-VIP customers.

🛡️ Best Practices

Always use defaults: |default:'' prevents empty fields from breaking emails
Combine sats + BTC: "{{ event.reward_sats_back }} sats ({{ event.reward_btc_back }} BTC)" for clarity
Conditional VIP messaging: Use {% if person.oshi_vip_tier_next %} for progression vs max tier celebration
Always current rates: The OSHI dashboard automatically syncs all program changes to the catalog, so email content is always accurate
Use feature flags: Control content visibility with {% if catalog_item.metadata.vip_enabled %}
Test edge cases: Max VIP tier (null values), non-enrolled users, first-time customers

Wrapping Up

You now have the playbook for building Bitcoin-powered loyalty flows in Klaviyo — from core reward emails to engagement nudges and personalized VIP content. With Oshi sending real-time reward events into Klaviyo, you can design flows that not only inform your customers but also motivate them to keep earning, redeeming, and coming back.

Follow our integration guide to connect Oshi to Klaviyo if you haven't already.

What’s Next?

Now that Oshi is connected to Klaviyo, it’s time to make sure your customers only receive emails from the source you control.

In your Oshi Dashboard, you can:

Disable default Oshi emails that you’ll now manage through Klaviyo.
Keep any emails you still want Oshi to send directly.
Decide exactly which messages should run through Klaviyo for full branding and customization.

This step prevents duplicate emails and ensures your rewards program feels seamless to customers.

Head back to your Oshi Dashboard, update your email settings, and put Klaviyo in charge of your rewards flows.

The Latest from Oshi

For Consumers & Bitcoin Earners

A Simple Way to Earn Bitcoin Through Everyday Spending

Ready to build customer loyalty with Bitcoin?