totalPoints can describe lifetime points earned, but it is a signed snapshot, not a live spendable balance. Use Loyalty points for funded rewards, redemption, and settlement.
From loyalty event to benefit
1
Your loyalty engine confirms a change
A purchase, visit, or milestone changes the customer’s status. Your backend decides what the customer has earned using your existing rules. Define the facts partners need in a credential schema, such as tier and issuing brand.
2
Your issuer backend creates the credential
Your backend signs the credential with your issuer keys, encrypts it to the holder, and stores the encrypted envelope in DStorage. Direct issuance can run from your event pipeline without an active user session. Resolve the correct recipient and deduplicate repeated events; see Issuing on a tier change.
3
The customer presents their status
At a partner’s checkout, check-in, or access screen, the customer signs in with AIR and approves the requested disclosure. The partner configures which issuers and loyalty claims its Verification Program accepts.
4
The partner verifies and applies its benefit rules
The partner checks the presented credential and its validity, then evaluates the tier or milestone against its own offer. Verify the returned presentation on the partner’s backend before granting the benefit. Partners can check the credential without a direct integration to your loyalty database.
Keep status current
A credential is a signed snapshot, not a live view of your loyalty database. When a tier changes, revoke the previous credential and issue a replacement. For seasonal status, set an expiry. Make sure partner verification includes the status and freshness checks the benefit requires. A partner does not need a full points ledger for a tier benefit. Request only the necessary claims and configure selective disclosure accordingly. Credential metadata may still identify or link the interaction; selective disclosure is not anonymity.The documented direct issuance flow does not bind credentials to a holder key, so their presentations are bearer presentations. Use SDK issuance when holder binding is required. See Issuing credentials and Verify with SD-JWT.
Choose your next step
- Use cases — explore points campaigns alongside tier and milestone benefits.
- Issuing and verifying credentials — follow the existing schema and integration walkthrough.
- Managing your credentials — plan revocation and replacement.