Skip to main content
Issue loyalty tier and milestone credentials from your loyalty engine, and let partner apps verify them without an API integration with you.
This guide issues and verifies loyalty credentials. A totalPoints claim records an issuer’s statement about accumulated points; it does not create a spendable points balance. For rewards with funding and redemption, see Issuing loyalty points and Spending loyalty points.

What you can build

  • Tier credentials — Issue a “Gold Member” or “VIP” badge that upgrades or revokes automatically as status changes
  • Milestone badges — Issue a credential when a user reaches 1,000 points, 10 purchases, or any event-driven threshold
  • Cross-platform loyalty — Allow partner apps to accept your loyalty credentials as proof of status, no API integration required
  • Zero-friction issuance — Trigger credential issuance from your loyalty engine backend; the user doesn’t need to open a wallet or take any action

Architecture

Create this schema in the AIR Kit Dashboard under Issuer → Schema Builder.

Implementation

Step 1 — Issue a loyalty credential on milestone

Use On-demand issuance to issue silently when a backend event fires. The user’s session is not required.

Step 2 — Verify loyalty tier at point of benefit

On your frontend, verify the user holds the required tier before granting access or rewards.

Key patterns

Issuance result

Issuance completes in ~1–4 seconds and returns a storagePath once the encrypted credential is stored in DStorage. Use that result to confirm success to the user — no status polling required. The credential is immediately available for the member to present at any verifier.

Examples

VIP Status Portability — live demo

Present airline Gold status at a partner café. The café never sees the membership number.

VIP Status Portability — Issuer

Airline loyalty app: issues tier credential; user carries status to partner brands.

VIP Status Portability — Verifier

Hotel chain app: verifies tier and grants equivalent perks (e.g. room upgrade, lounge).

Next steps

On-demand Issuance — Concepts

Understand when and why to use On-demand issuance.

On-demand Issuance — API

Full endpoint reference with error codes.

Schema Use Cases

More schema examples including membership and event pass.

Verifying Credentials

SDK verification flow reference.