Use Cases
These are the common use cases customers build with Firmly. The list isn’t exhaustive — Firmly’s APIs support many more shapes. Use these as starting points; adapt or combine them to fit your build, and contact Firmly if your scenario doesn’t match any of these.
Every destination category (AI surfaces, publisher sites, ads, and others) can use any of these patterns.
If you’re not sure where to start, begin with AI Shopping Copilot — it’s the baseline flow every other use case builds on.
Common use cases
AI Shopping Copilot
General-purpose discovery → cart → checkout. The baseline.
Deal & Coupon Hunting
Find deal-eligible items and apply promo codes at checkout.
Smart Payment Selection
Card, BNPL, express wallets, saved cards — pick the best path per transaction.
Vertical Specialist
Variant-rich discovery + multi-product cart for fashion, beauty, supplements.
Smart Gifting & Occasion
Find a gift, add gift wrap, optionally bundle a gift card, express checkout.
Scheduled / Triggered Buying
Replenishment, restock, price-drop auto-buy. The destination schedules; Firmly executes.
Autonomous Agent Purchasing
Mandate-based payment when the cardholder isn’t present at checkout — Agentic Pay’s Network Token Router with network-enforced spending limits.
How use cases relate to destinations
Use cases are common patterns; destinations are who builds them. The same use case appears in many destination-type pages because every destination can apply it:
| Use case | Most relevant destination types |
|---|---|
| AI Shopping Copilot | Every destination — this is the baseline |
| Deal & Coupon Hunting | AI chat product, AI answer engine, publisher, bank (with card-linked offer overlay) |
| Smart Payment Selection | Wallet, bank, AI chat product |
| Vertical Specialist | Brand-loyalty, publisher, AI chat product |
| Smart Gifting & Occasion | AI chat product, wallet, publisher |
| Scheduled / Triggered Buying | Wallet, bank, connected device |
| Autonomous Agent Purchasing | Wallet, bank, connected device, brand-loyalty (when the user isn’t at the screen at checkout) |
Don’t see your destination? See Destinations.
How to use these pages
Most use case pages follow the same shape:
- What the use case is — one-paragraph user story
- Recommended setup — integration pattern, protocol, auth, flow shape
- API sequence — the exact call order, each row linking to the canonical reference
- Agent considerations — destination-side logic you need to own (some pages fold this into the API sequence when there’s little to add)
- Related — adjacent use cases, deeper guides, error handling
Each use case — what to read next
| Use case | Closest flow | Closest integration pattern | Closest recipe |
|---|---|---|---|
| Shopping Copilot | Single-product | Any | Chat to Checkout |
| Deal & Coupon Hunting | Single-product or Multi-product | Deep Link | Chat to Checkout |
| Smart Payment Selection | Single-product | Embedded for wallet UI | — |
| Vertical Specialist | Multi-product | Embedded | — |
| Smart Gifting | Single-product or Multi-product | Embedded | Wallet pass purchase |
| Scheduled / Triggered Buying | Single-product | Deep Link | — |
| Autonomous Agent Purchasing | Single-product | Deep Link | — |