# Loyalty Interchange Protocol

> Open, vendor-neutral loyalty protocol and reference platform for restaurant, QSR, coffee, and franchise ordering systems.

## Docs

- [Get balances, metrics, and tier progress](https://loyalty-interchange.mintlify.app/api-reference/accounts/get-balances-metrics-and-tier-progress.md)
- [Post accrual for a paid order](https://loyalty-interchange.mintlify.app/api-reference/accruals/post-accrual-for-a-paid-order.md)
- [Check service health](https://loyalty-interchange.mintlify.app/api-reference/discovery/check-service-health.md)
- [Discover LIP endpoints and authentication](https://loyalty-interchange.mintlify.app/api-reference/discovery/discover-lip-endpoints-and-authentication.md)
- [Get negotiated operations, effects, events, and limits](https://loyalty-interchange.mintlify.app/api-reference/discovery/get-negotiated-operations-effects-events-and-limits.md)
- [Cancel an unclaimed issued reward](https://loyalty-interchange.mintlify.app/api-reference/issued-rewards/cancel-an-unclaimed-issued-reward.md)
- [Issue a member-specific reward or coupon artifact](https://loyalty-interchange.mintlify.app/api-reference/issued-rewards/issue-a-member-specific-reward-or-coupon-artifact.md)
- [List a member's issued reward wallet](https://loyalty-interchange.mintlify.app/api-reference/issued-rewards/list-a-members-issued-reward-wallet.md)
- [Credit or debit points with an operator classification](https://loyalty-interchange.mintlify.app/api-reference/ledger/credit-or-debit-points-with-an-operator-classification.md)
- [List member ledger entries](https://loyalty-interchange.mintlify.app/api-reference/ledger/list-member-ledger-entries.md)
- [Lip lifecycle event encoded as cloudevents 10 structured json](https://loyalty-interchange.mintlify.app/api-reference/lip-lifecycle-event-encoded-as-cloudevents-10-structured-json.md)
- [Enroll or return a member](https://loyalty-interchange.mintlify.app/api-reference/members/enroll-or-return-a-member.md)
- [Resolve a member identity](https://loyalty-interchange.mintlify.app/api-reference/members/resolve-a-member-identity.md)
- [Adjust accrual after refund, void, or correction](https://loyalty-interchange.mintlify.app/api-reference/orders/adjust-accrual-after-refund-void-or-correction.md)
- [Evaluate accrual and available rewards](https://loyalty-interchange.mintlify.app/api-reference/orders/evaluate-accrual-and-available-rewards.md)
- [API Overview](https://loyalty-interchange.mintlify.app/api-reference/overview.md): Base URL, authentication, errors, and retry rules for the LIP HTTP API
- [Get program, tier, and reward definitions](https://loyalty-interchange.mintlify.app/api-reference/programs/get-program-tier-and-reward-definitions.md)
- [Capture a reserved reward](https://loyalty-interchange.mintlify.app/api-reference/redemptions/capture-a-reserved-reward.md)
- [Release or refund a redemption](https://loyalty-interchange.mintlify.app/api-reference/redemptions/release-or-refund-a-redemption.md)
- [Reserve a reward for an order](https://loyalty-interchange.mintlify.app/api-reference/redemptions/reserve-a-reward-for-an-order.md)
- [Changelog](https://loyalty-interchange.mintlify.app/changelog.md): Release notes and product updates for the Loyalty Interchange Protocol
- [Essentials](https://loyalty-interchange.mintlify.app/get-started/essentials.md): The six things every new LIP integrator needs to know
- [Quickstart](https://loyalty-interchange.mintlify.app/get-started/quickstart.md): From a clean clone to a working loyalty request in five minutes
- [AI prompts](https://loyalty-interchange.mintlify.app/guides/ai-prompts.md): Copy-paste prompts for driving LIP integration work with coding agents like Cursor, Claude Code, and Codex.
- [Customer Identity](https://loyalty-interchange.mintlify.app/guides/customer-identity.md): Connect an already-authenticated customer from Clerk, Auth0, or any OIDC provider to a program-scoped LIP member.
- [Migrating a self-hosted LIP program](https://loyalty-interchange.mintlify.app/guides/migration.md): A zero-loss runbook for moving one LIP program between SQLite and Postgres hosts without losing member or financial state.
- [PostgreSQL Storage](https://loyalty-interchange.mintlify.app/guides/postgres.md): Run the LIP reference server on a normalized, multi-instance PostgreSQL engine store.
- [Punchh Migration](https://loyalty-interchange.mintlify.app/guides/punchh-migration.md): Mapping restaurant loyalty capabilities to vendor-neutral LIP contracts
- [Reference Platform](https://loyalty-interchange.mintlify.app/guides/reference-platform.md): Server, Admin dashboard, storage, and implementation boundaries
- [TypeScript SDK](https://loyalty-interchange.mintlify.app/guides/typescript-sdk.md): The idiomatic application interface for LIP
- [Using LIP with AI](https://loyalty-interchange.mintlify.app/guides/using-lip-with-ai.md): The fastest path from zero to a correct loyalty integration when you build with coding agents and MCP.
- [Webhooks](https://loyalty-interchange.mintlify.app/guides/webhooks.md): Signed CloudEvents pushed after every successful mutation, with a durable retry outbox
- [Loyalty Interchange Protocol](https://loyalty-interchange.mintlify.app/index.md): Open, vendor-neutral loyalty infrastructure for restaurant, QSR, coffee, convenience, and franchise ordering systems
- [Protocol Overview](https://loyalty-interchange.mintlify.app/protocol/overview.md): The normative LIP contract and where it lives

## OpenAPI Specs

- [openapi](https://loyalty-interchange.mintlify.app/api-reference/openapi.yaml)