GiftPass Lab structures gift cards, vouchers, and stored-value products as machine-readable entitlements — so humans, businesses, and AI agents can understand exactly what they have, what rules apply, and what happens when something goes wrong.
Every field is explicit. Every condition is surfaced. No guessing.
A gift card in an AI agent's context is a black box. Is it valid? Can it be redeemed? What stops it? Without structured data, the agent has to guess or fail. GiftPass Lab makes the answer explicit.
Expiry dates, blackout periods, redemption limits, partial-use rules, authority chains — these are not edge cases. They are the reality of every gift card in existence. Most systems hide them. GiftPass Lab surfaces them.
A blocked or denied entitlement should explain what can be done next. Not just "denied" — but "denied because the balance is below the minimum threshold of $5.00. Top-up or use a different tender."
The entitlement model that works for gift cards extends to tickets, bookings, memberships, loyalty points, insurance benefits, and subscriptions. GiftPass Lab is the first step toward a universal entitlement layer.
GiftPass Lab exposes a query interface where any system — a wallet app, a POS, an AI agent — can ask about an entitlement and get a structured, unambiguous answer.
Pass a voucher code, QR, or structured entitlement object to the protocol.
The protocol checks value, expiry, constraints, authority, and state against the rules.
pass, redeem, block, deny, or recover — with a full explanation of why and what to do next.
POST /entitlements/eval
{
"entitlement_id": "ent_7f3a9c2b",
"action": "redeem",
"context": { "timestamp": "2026-05-24T10:00:00Z" }
}
→ {
"decision": "pass",
"can_redeem": true,
"remaining_value": 75.00,
"constraints_clear": true,
"next_audit_entry": "redeemed USD 75.00 by agent_42 at 2026-05-24T10:00:00Z"
}A gift card is not just a record. It is a promise with conditions. When a business issues one, it has committed to something. That commitment should be as legible as the balance.
A QR code, a wallet pass, an email, a printed voucher — these may present an entitlement, but they should not define the underlying truth. The protocol layer does.
When a condition is unknown, missing, or authority-dependent, the system should say so clearly. "Unknown" is a correct answer. "Maybe" is not.
Every significant state change — issued, redeemed, partial use, blocked, revoked — should be traceable. Not for compliance theater, but because trust in commercial promises requires evidence.
GiftPass Lab is a practical protocol experiment. We are testing how gift cards and vouchers can become clearer, safer, and more auditable — starting with one of the most familiar entitlement types in the world.
Every voucher, gift card, credit, ticket, booking, membership, or benefit — structured as an entitlement that any system can read, any agent can evaluate, and any party can trust.