canonical: https://jentic.com/apis/digitalwallet.cards/digitalwallet

# Digitalwallet Cards TRYB Loyalty API

Jentic publishes the only available OpenAPI specification for TRYB Loyalty API, keeping it validated and agent-ready. The TRYB Loyalty API runs a digital loyalty program: it creates and manages loyalty cards for customers and adjusts points, stamps, visits, purchases, and rewards on each card. It manages customer records and promotions, sets membership tiers and expiration dates, redeems coupons, sends push notifications and SMS, and reports revenue statistics.

## For AI agents

Run a digital loyalty program: create loyalty cards, add or subtract points, stamps, and rewards, manage customers and promotions, set membership tiers, and send push or SMS.

## Scope

Does not handle payment processing, inventory, or point-of-sale hardware. Use for managing loyalty cards, customers, and rewards only.

## Capabilities

- Create and manage loyalty cards for customers
- Add or subtract points, stamps, visits, purchases, and rewards on a card
- Redeem coupons and record reward receipts on a card
- Set a card's membership tier, expiration date, and reward tiers
- Manage customer records and create promotions
- Send push notifications and SMS messages to customers
- Retrieve revenue statistics and operation history

## Use cases

### Agent-Run Loyalty Point Updates

An AI agent handling point-of-sale events can create a customer's loyalty card, add points or stamps after a purchase, and redeem coupons through the TRYB Loyalty API. Because each action maps to a card operation, the agent keeps balances current without a staff member touching the loyalty dashboard.

Example prompt: Create a loyalty card for a customer, then add points to that card after a purchase

### Promotions and Customer Messaging

Marketing workflows can create promotions and reach cardholders with push notifications and SMS using the TRYB Loyalty API. The promotion and messaging operations let a campaign target customers who hold a loyalty card.

Example prompt: Create a promotion, then send a push notification announcing it to customers

### Membership Tiers and Revenue Reporting

Program managers can set membership tiers and expiration dates on cards and pull revenue statistics from the TRYB Loyalty API. This supports tiered loyalty programs where benefits and reporting depend on a customer's current tier.

Example prompt: Set a card's membership tier, then retrieve the program's revenue statistics

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/api/v2/cards` | Create card for customer |
| GET | `/api/v2/cards/{id}` | Get card |
| POST | `/api/v2/cards/{id}/add-point` | Add point to card |
| POST | `/api/v2/cards/{id}/add-stamp` | Add stamp to card |
| POST | `/api/v2/cards/{id}/redeem-coupon` | Redeem coupon |
| POST | `/api/v2/customers` | Create customer |
| POST | `/api/v2/promotions` | Create promotion |
| POST | `/api/v2/pushes` | Send push |

## Key resources

- **Cards** — Create, read, edit, and delete loyalty cards and adjust points, stamps, visits, and rewards
- **Customers** — Create, read, edit, and delete customer records
- **Promotions** — Create, read, edit, and delete promotions
- **Messaging** — Send push notifications and SMS messages to customers
- **Statistics** — Retrieve revenue statistics and the operation history

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 40 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 58 / 100
  - Developer Experience & Jentic Compatibility: 57 / 100
  - AI-Readiness & Agent Experience: 18 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 100 / 100
- **View full report:** https://jentic.com/apis/digitalwallet.cards/digitalwallet/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the TRYB Loyalty API by hand means managing its X-API-Key header and keeping track of dozens of card operations for points, stamps, visits, rewards, and tiers. Through Jentic you install once, import the TRYB Loyalty API from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** The TRYB Loyalty API puts the card, customer, and promotion ids in the URL path, such as `/api/v2/cards/{id}`, so a rule can pin your agent to the operations and resources it needs. You choose which operations it may call, so it can add points and redeem coupons without being able to delete cards or customers unless you add those operations.
- **Credential handling:** Your TRYB API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'add points to a loyalty card' or 'create a promotion', and Jentic returns the matching TRYB operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related APIs

- **LoyaltyLion** — LoyaltyLion is a loyalty and rewards platform comparable to the TRYB Loyalty API's card and points program.
- **Talon.One** — Talon.One is a promotions and loyalty engine, an alternative to the TRYB Loyalty API for rules-based rewards.
- **Klaviyo** — Klaviyo handles email and SMS marketing to the same customers the TRYB Loyalty API tracks.

## FAQ

### Why is there no official OpenAPI spec for TRYB Loyalty API?

TRYB does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call the TRYB Loyalty API via structured tooling. It is validated against the live API and kept up to date. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### What authentication does the TRYB Loyalty API use?

The TRYB Loyalty API authenticates with an API key sent in the `X-API-Key` header, per its OpenAPI spec. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time, so it never enters the agent's prompt or logs.

### Can I add points to a loyalty card with the TRYB Loyalty API?

Yes. The TRYB Loyalty API has operations to add and subtract points, stamps, visits, purchases, and rewards on a card by its id, plus redeem coupons and set membership tiers. You can create the card first if the customer does not have one yet.

### What are the rate limits for the TRYB Loyalty API?

The OpenAPI spec does not specify rate limits for the TRYB Loyalty API. Check the provider's documentation at https://digitalwallet.cards for the current limits that apply to your API key.

### Can I limit what my agent is allowed to do with the TRYB Loyalty API?

Yes. Card, customer, and promotion ids travel in the URL path, so a rule can scope your agent to the operations and resources it needs. Write a rule that allows only point and stamp updates and coupon redemption, so the agent can run everyday loyalty actions without being able to delete cards or customers, and every call it makes is logged.

### How do I update a loyalty card with the TRYB Loyalty API through Jentic?

Search Jentic for 'add points to a loyalty card' and it returns the matching TRYB operation with its input schema. Import the TRYB Loyalty API from the Jentic API Directory, store your API key once, and your agent can create cards, adjust points and stamps, and redeem coupons without hand-wiring the key on each request.

### Is there a TRYB Loyalty API MCP server?

You don't need an MCP server to give your agent the TRYB Loyalty API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls the card, customer, and promotion operations. Nothing extra loads into the agent's context until an operation is actually used.