PodiumPodium
Book a workshop
Identity + incentives + commerce, programmable in one place

Understand Podium in 10 minutes

This page is designed for marketing, product, and growth leaders who want to evaluate Podium quickly: what it does, how it fits into your stack, and the simplest paths to launch loyalty and rewards.

Walk through single-site loyalty Jump to endpoint explorer
The simplest mental model

Podium is the incentive layer your stack doesn't have

You keep your existing checkout (Stripe, Shopify). Podium adds a unified points ledger, programmable rewards, and event-driven workflows that marketing teams can actually iterate on.

Earn
Your systems trigger point grants (visits, purchases, referrals). Podium writes every change to a ledger so teams can audit and iterate.
Reward
Go beyond points: create digital collectibles, tiered memberships, discount perks, and more, all modelled as programmable rewards.
Redeem
At checkout, you read balances from Podium and apply value inside your normal Stripe or Shopify flow. Your payments stay your payments.
What teams actually do

The workflows you'll ship first

Podium is built around a few repeatable loops. Start with loyalty on one site, then expand to richer reward types and automation.

Step 1
Define earn actions

Example: signup +150, purchase +1 pt per $1, referral +500.

Step 2
Write points to ledger

Your backend calls Podium when the action happens.

Step 3
Redeem at checkout

Read balance from Podium, apply discount in Stripe/Shopify.

Stripe checkoutShopify checkoutOn-site UI widgetServer-side ledger
Use case

Single-site loyalty on Stripe or Shopify

Add points earning and redemption to a single site that already has checkout. Podium is the ledger and the rules engine; you keep your existing payment flow.

The flow
  1. 1
    User does an action
    Signup, visit, purchase, referral, quiz completion.
  2. 2
    Your system calls Podium
    Write points to the ledger with metadata for reporting.
  3. 3
    User sees points
    Read balance on account page or at checkout.
  4. 4
    Redeem
    Apply discount in Stripe/Shopify based on points balance.
  5. 5
    Post-purchase loop
    Send an email/SMS, issue bonus, unlock tier, or mint a reward.
No checkout replacementLedger modelAuditableWorks with existing CDP/ESP
Minimal implementation
Award points
Call this from your server when an action happens.
Earning
POST https://api.podiumcommerce.xyz/api/v1/user/{id}/points
Authorization: Bearer <api-key>

{
  "amount": 150,
  "details": {
    "reason": "signup_bonus"
  }
}
Read points for checkout
Use this to decide the discount in your Stripe/Shopify flow.
Redemption
GET https://api.podiumcommerce.xyz/api/v1/user/{id}/points
Authorization: Bearer <api-key>
Redemption pattern

Podium returns the user's balance. Your checkout computes the value to apply (example: 100 points = $1.00) and applies it using your existing payment provider.

Beyond points

Rewards that feel like brand experiences

Podium supports rewards as programmable assets, enabling memberships, access control, and benefits that can extend across apps and brands.

Memberships
Tiered perks and access rules that map to real behaviors.
Collectibles
Digital benefits that can unlock products, discounts, or experiences.
Earned rewards
Track what someone earned, why they earned it, and how it was redeemed.
Settlement

Payments stay in your stack

Use Stripe or Shopify like you do today. Podium adds incentives and can also support payment-gated endpoints via x402 for stablecoin flows when needed.

Stripe or Shopify (most common)
Read points from Podium at checkout, compute a discount or credit, and apply it using native mechanisms in Stripe/Shopify. Podium remains the source of truth for balances and history.
x402 payment-gated routes (optional)

Some endpoints can be protected by x402: call without X-PAYMENT to receive a 402 with payment requirements, then retry with proof.

GET/x402-testx402
Orchestration

Turn commerce into an engagement loop

Podium is event-driven: purchases, redemptions, and reward events can fan out to your tooling (ESP, CDP, CRM) without blocking the user experience.

Real-time actions
The API returns quickly. Anything heavy is queued.
Queues + handlers
Events publish to queues, then webhook-style handlers process in background.
Integrations
Push outcomes to your marketing stack (email, SMS, analytics).
API Explorer

Find the endpoints that matter

This is a curated slice of the API that maps to common buyer questions: earning, redemption, rewards, and commerce settlement.

Next: make this "real docs"

If you want, we can expand this explorer to ingest the full OpenAPI JSON at build time and auto-render every tag group (Points, Rewards, Orders, Shopify, Stripe, and more) using the same Podium marketing style.

Trust

Tenant isolation + standard API ergonomics

Podium enforces tenant separation and uses standard HTTP semantics so enterprise teams can evaluate quickly.

Isolation (multi-tenant)
Tenant scoping is enforced at the database layer via row-level security. Org context is resolved from the API key and applied consistently across request handling.
Error handling
Standard HTTP codes: 400 validation, 401 auth, 403 forbidden, 429 rate limited, 500 server error. x402-protected endpoints return 402 with payment requirements.
Common buyer questions

FAQ

Short answers for marketing and product leaders evaluating the platform.