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
Recommended Schema
Create this schema in the AIR Kit Dashboard under Issuer → Schema Builder.Implementation
Step 1 — Issue a loyalty credential on milestone
Use Issue on Behalf 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
| Pattern | onDuplicate value | When to Use |
|---|---|---|
| Tier upgrade | "revoke" | Always revoke old credential and issue new one |
| One-time milestone badge | "ignore" | Don’t re-issue if credential already held |
| Time-boxed VIP | Set expirationDate in subject | Seasonal or campaign-based access |
| Retroactive bulk issuance | Loop issueLoyaltyCredential | Migrating existing loyalty members |
Status Polling (optional)
Issuance is asynchronous. Poll untilONCHAIN before showing a confirmation to the user.
Examples
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).