{"schema":"https://ver.cy/schemas/card/1.0.0","id":"EM-RTL-06","code":"em-rtl-06","url":"https://ver.cy/models/em-rtl-06/","name":"Loyalty membership and points","alternateNames":[],"kind":"enterprise-contour","status":"published","version":"research-checkpoint","language":"en","classifiers":{"family":"Enterprise profiles","category":"Enterprise subject","entryKind":"subject","plane":"","domain":["Enterprise","RTL"],"industry":["Retail and e-commerce"],"navPath":"","tags":["EM-RTL-06","W-IND","subject","LoyaltyProgram","Membership","Tier","PointsLedgerEntry","Redemption"],"facets":{}},"whatItIs":"A loyalty program, its member accounts, tiers, points earned and redeemed as a ledger, and member benefits. The customer relationship and marketing consent belong to neighboring contours.","purpose":"Keep member points and benefits explainable from a ledger, so that members, auditors and finance can trust every balance.","scope":{"in":[],"out":[],"boundaries":[]},"distinguishingFeatures":["The balance is derived from a ledger of entries.","Returns affect earned points according to the applicable program rules, including rules for partial returns and points already redeemed.","Manual adjustments carry a reason and an author.","Marketing consent is held in the customer and personal data contours.","Versioned program rules and tier definitions govern membership status and benefit entitlements.","Benefit usage is recorded against an entitlement even when no points are redeemed."],"structure":{"bundles":[{"id":"program-definition","name":"Program definition","description":"This bundle defines the effective rules, tiers and benefits of a loyalty program.","layers":[{"id":"rules-and-tiers","name":"Rules and tiers","description":"This layer records versioned program rules and tier definitions.","findings":[{"id":"program-rules","name":"Program rules","description":"This finding defines the rules governing membership and points.","questions":[{"text":"Which program, effective interval, eligibility conditions and earning, redemption and expiry rules does this program rule version define?","id":"program-rule-version"},{"text":"How does this program rule version treat full returns, partial returns and returns after earned points have been redeemed?","id":"return-rules"}]},{"id":"tier-definitions","name":"Tier definitions","description":"This finding defines qualification, retention and benefits for a program tier.","questions":[{"text":"What qualification, retention, downgrade and benefit rules apply under this tier definition version?","id":"tier-definition"}]}]}]},{"id":"membership","name":"Membership","description":"This bundle records membership status, tier history and member benefits.","layers":[{"id":"member-and-tier","name":"Member and tier","description":"This layer links one membership to accepted terms and effective tier decisions.","findings":[{"id":"membership-record","name":"Membership record","description":"This finding identifies the membership and its accepted terms.","questions":[{"text":"Which program, membership number and current tier does this membership record identify, and from what effective dates?","id":"membership-status"},{"text":"Which version of the program terms did this member accept?","id":"accepted-terms"}]},{"id":"tier-history","name":"Tier history","description":"This finding preserves the rule basis of a membership's tier changes.","questions":[{"text":"What previous tier, new tier, effective date and triggering rule version does this tier change record identify?","id":"tier-change"}]},{"id":"benefit-entitlements","name":"Benefit entitlements","description":"This finding records a member's entitlement to a defined benefit.","questions":[{"text":"Which membership, benefit definition, eligibility basis, validity interval and usage limit does this entitlement record identify?","id":"benefit-entitlement"}]},{"id":"benefit-usage","name":"Benefit usage","description":"This finding records the use or reversal of an entitled benefit.","questions":[{"text":"Which entitlement, usage date, quantity and fulfillment or reversal status does this benefit usage record identify?","id":"benefit-use"}]}]}]},{"id":"points-ledger","name":"Points ledger","description":"This bundle explains points balances through traceable ledger entries.","layers":[{"id":"earn-redeem-reverse-and-expire","name":"Earn, redeem, reverse and expire","description":"This layer records points movements and their governing rules.","findings":[{"id":"ledger-entries","name":"Ledger entries","description":"This finding links each points movement to its cause and reconciles a membership balance.","questions":[{"text":"Which ledger entries make up this membership's balance at the stated cutoff, and does their sum match the displayed balance?","id":"balance-reconciliation"},{"text":"Which transaction or rule version caused this ledger entry?","id":"entry-cause"}]},{"id":"adjustments","name":"Adjustments","description":"This finding explains manual adjustments, expirations and redemptions.","questions":[{"text":"What amount, author, reason and approval does this manual adjustment record identify?","id":"manual-adjustment"},{"text":"Which points expired through this expiry entry, and under which rule version?","id":"points-expiry"},{"text":"Which points and reward does this redemption record identify?","id":"reward-redemption"}]}]}]}]},"agentConduct":{"may":["Explain a member's balance from the ledger.","Flag balances that do not match their ledger.","Propose goodwill adjustments for staff approval."],"mustNot":["Adjust balances or change tiers.","Change program terms.","Use loyalty data for purposes the member has not been told about."],"requiresHuman":["Manual adjustments above a set limit require supervisor approval.","Changes of program rules require management and legal review."]},"ethics":{"considerations":["Loyalty data reveals detailed buying behavior.","Rule changes can take away value that members expected."],"affectedParties":["Program members","Customer service staff","Finance staff"]},"owners":{"steward":"A loyalty program steward is accountable for program definitions, membership, tiers, benefits and points records.","roles":[],"masterSystems":["A loyalty management system owns program rules, tier definitions, membership records, tier history, benefit entitlements, benefit usage and the points ledger.","A customer relationship management system owns referenced customer identity and relationship records.","A point of sale system owns referenced purchase and return transactions."]},"relations":[{"target":"EM-COM-01","type":"neighbor"},{"target":"EM-COM-02","type":"neighbor"},{"target":"EM-RTL-04","type":"neighbor"},{"target":"EM-RTL-05","type":"neighbor"},{"target":"EM-LEG-06","type":"neighbor"},{"target":"EM-FIN-02","type":"neighbor"},{"target":"WM-ECO-029","type":"references","note":"conceptual-candidate"},{"target":"WM-ORG-014","type":"references","note":"conceptual-candidate"}],"interaction":{"identity":{"applicability":"required","items":["A membership has a number unique within the program.","A ledger entry has an identifier and references its cause."]},"properties":{"applicability":"not-applicable","items":[]},"recognition":{"applicability":"required","items":["Records show members, tiers, ledger entries, redemptions and balances.","A loyalty account must be distinguished from a gift card, a customer account and a payment account."]},"capabilities":{"applicability":"required","items":["The contour supports earn and burn processing, tier management and liability reporting."]},"hazards":{"applicability":"required","items":["Unexplained balances create disputes and financial misstatement.","Leaks of loyalty data expose shopping habits."]},"interfaces":{"applicability":"optional","items":["Schema.org defines the MemberProgram and MemberProgramTier types for publishing loyalty program information."]},"context":{"applicability":"required","items":["The contour is used by retailers with card, app or account based programs.","Loyalty liabilities are reported under the applicable accounting standards."]}},"sources":[{"title":"schema.org: MemberProgram and MemberProgramTier"},{"title":"Accounting for customer loyalty programs as deferred revenue"},{"title":"Consumer protection rules for loyalty program terms"},{"title":"Schema.org MemberProgram type","url":"https://schema.org/MemberProgram","note":"Checked live (HTTP 200) on 2026-10-21."},{"title":"Schema.org MemberProgramTier type","url":"https://schema.org/MemberProgramTier","note":"Checked live (HTTP 200) on 2026-10-21."}],"openQuestions":["Is the points balance a stored figure or derived from the ledger?","How are points reversed when a purchase is returned?","How are changes of program rules applied to points already earned?","Settle the boundary and the reuse, extend or new decision against the current specifications.","Confirm the semantic crosswalk, rights and source mastership.","Choose immutable references and run fixture checks before claiming publication readiness."],"resources":{"source":"https://ver.cy/enterprise/models/em-rtl-06/"},"provenance":{"origin":"enterprise research programme","builtFrom":["enterprise/models/em-rtl-06/brief.json","ver-cy/world-models/card-supplements/em-rtl-06.json"],"providers":[],"researchStatus":"published-partial","generatedAt":"","builder":"tools/build_cards.py@1.0.0"},"completeness":{"sections":{"classifiers":"filled","whatItIs":"filled","purpose":"filled","distinguishingFeatures":"filled","structure":"filled","agentConduct":"filled","ethics":"filled","owners":"filled","relations":"filled","interaction.identity":"filled","interaction.properties":"not-applicable","interaction.recognition":"filled","interaction.capabilities":"filled","interaction.hazards":"filled","interaction.interfaces":"filled","interaction.context":"filled","sources":"filled"},"notes":{"interaction.properties":"Enterprise record contour: physical properties belong to referenced world models.","_supplement":"Sections authored in card supplement 1.1.0 by Claude (Opus 5.5) (2026-10-21, unreviewed). Written from the industry contour brief and established practice in the field; source pages were checked live on 2026-10-21. Unreviewed. Revised against an independent Codex review on 2026-10-21.","_gate":"Published through the contour publication gate 1.0 on 2026-10-21T19:02:23+00:00: completeness 1.00; subject: research brief; 2 live sources; review by codex: pass"},"score":1.0}}