Back to blog
Product•June 15, 2026•4 min read

The five states of a paying user

"Is this user paid?" is a boolean that quietly grows into a mess - trials, refunds, lapsed cards, promo access. SentiKits names the states up front instead: free, trial, redeemer, paid, expired.

Name the states, then gate once

A subscriber and someone who redeemed a physical-kit code get the same content but arrived differently, and that difference matters for billing and renewal. With five explicit states, every screen gates through one useEntitlementGate hook reading one model - no scattered isPro checks drifting out of sync. A daily scheduled function re-checks and expires, so the model heals itself instead of trusting a stale flag.

A boolean hides the cases that bite you. An explicit state machine forces you to decide what each one means before a user lands in it.

Let the model unlock new business

Because "redeemer" is a first-class state, the product can do things a paywall can't:

  • Ship a physical kit with a code that grants digital access - bridging retail and app.
  • Run trials that downgrade cleanly to free, not to a broken half-paid limbo.
  • Verify Apple receipts server-side into an audit trail, so entitlement is provable, not claimed.