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

Register this credential type in the AIR Kit Dashboard under Issuer → Schemas. You can optionally publish the claims below as Type Metadata; your issuer backend issues them.

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 as soon as DStorage accepts the encrypted credential (201). Use that result to confirm success to the user. Sealing on Moca Chain continues in the background; to confirm it, poll GET /dstorage/vcs/status?path=<storagePath> until status is STORED. 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.

Register credential types

Register the credential type your backend issues.

Verifying Credentials

SDK verification flow reference.