igrantio-credential-schema-loyalty-card

Defines Loyalty Card credential claim paths for iGrant.io OpenID4VC issuance in three formats.

1|Updated Jul 14, 2026
One-click install
npx skills add https://github.com/L3-iGrant/skills --skill igrantio-credential-schema-loyalty-card-l3-igrant
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: igrantio-credential-schema-loyalty-card
Source: https://github.com/L3-iGrant/skills/tree/main/credential-schemas/igrantio-credential-schema-loyalty-card
Command: npx skills add https://github.com/L3-iGrant/skills --skill igrantio-credential-schema-loyalty-card-l3-igrant

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Issuing a Loyalty Card verifiable credential requires an exact claim path pointer definition for each credential format, and hand-writing these nested claim arrays for dc+sd-jwt, jwt_vc_json, and mso_mdoc is error-prone. This Skill provides the ready-to-use schema documents from the iGrant.io verifiable data registry so the credential definition matches the registry exactly. ## Core Features & Use Cases - Three format schemas: Provides the full 25-claim path pointer documents for dc+sd-jwt, jwt_vc_json, and mso_mdoc, covering credential, customer, loyalty_card, organization, and portfolio claim groups. - API integration guidance: Shows how to POST the claims array to the iGrant.io credential-definition endpoint with the correct vct, type, doctype, and validationPath per format. - Issuance interview: Walks through environment, format, issuance mode, revocation, signing, and trust-list decisions before any code is written. - Use Case: A retailer wants to issue loyalty cards to customer EUDI wallets showing points and miles balances. The agent uses this schema to create the credential definition, enables revocation and reissuance, and issues cards that holders can selectively disclose at the till. ## Quick Start Ask your agent to create a Loyalty Card credential definition on the iGrant.io OpenID4VC API using the dc+sd-jwt format with revocation enabled.

Frequently Asked Questions about igrantio-credential-schema-loyalty-card

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Loyalty Card credential definition with OpenID4VCI?▼

POST to /v2/config/digital-wallet/openid/sdjwt/credential-definition with one entry per format in credentialDefinitions[]. Copy the claims array from the matching schema document, set version to version_01, and set vct, type, or doctype depending on the format.

What claims does the Loyalty Card credential schema contain?▼

The schema holds 25 mandatory claims in five groups: credential metadata, customer contact data, loyalty card id and status, organization details, and portfolio balances for points, miles, and wallet funds. All claims must be filled at issuance unless removed from the definition.

Which credential format should I use: dc+sd-jwt, jwt_vc_json, or mso_mdoc?▼

The registry publishes all three formats, and dc+sd-jwt is recommended unless the rule book requires mdoc. dc+sd-jwt and mso_mdoc support selective disclosure via limitDisclosure, while jwt_vc_json does not.

Why is the mso_mdoc namespace different from the doctype?▼

The mdoc claim paths start with the namespace eu.europa.ec.eudi while the doctype is eu.europa.ec.eudi.loyaltycard. Send the paths exactly as the schema document gives them because the issuer builds the mdoc from those paths.

How do I keep the loyalty points balance current in an issued credential?▼

A credential holds the balance at issuance time, so reissue the credential when the balance changes. Set supportCredentialReissuance to true in the credential definition, or point verifiers at your own interface for live balances.