OfferKit documentation
Learn how to build, integrate, deploy, and operate discounts, gift cards, loyalty programs, referrals, targeting rules, and automatic promotions.
OfferKit is the promotion engine behind the customer experience you design. Your team configures the offer; your application asks OfferKit what applies, commits the result, and decides how it appears in checkout, account pages, email, and support tools.
You do not need to understand OfferKit’s internal object model before you begin. Start with the outcome you want for your customers.
What do you want to build?
| Goal | Start here |
|---|---|
| Let customers enter a shared or unique discount code | Run a promotional code |
| Apply a discount automatically when a cart qualifies | Build an automatic cart discount |
| Issue prepaid value or store credit | Issue and accept gift cards |
| Reward repeat customers with points, tiers, and rewards | Launch a loyalty program |
| Reward an advocate and the friend they invite | Launch a referral program |
| Limit an offer by customer, cart, product, or date | Target customers with rules |
| Accept more than one code on an order | Combine discounts safely |
See Build for a goal for all end-to-end guides.
New to OfferKit?
Follow Get started to run OfferKit, create a WELCOME10
discount, validate it against a cart, redeem it, and inspect the result. The tutorial
introduces each OfferKit term only when it becomes useful.
If you are evaluating the architecture first, read How OfferKit works and the integration blueprint.
Three parts of every implementation
- Configure the business behavior. Use the dashboard or API to define the value, eligibility, dates, limits, and stacking behavior.
- Integrate the customer journey. Your server sends customer and cart context to OfferKit, previews the result, and commits it at the right business moment.
- Operate the live offer. Your team monitors usage and failures, supports customers, and pauses or adjusts the offer when necessary.
The goal guides cover all three parts. The reference is available when you need exact resource fields, error codes, or interface conventions.
How you can use OfferKit
- The dashboard is for configuring and operating offers.
- The TypeScript SDK is the shortest path for a TypeScript server application.
- The REST API works with any backend and exposes an OpenAPI 3.1 document.
- The CLI is useful for scripts and back-office work.
- The MCP server lets an agent work with the same contract and explicit risk labels.
All programmatic surfaces use the same API keys and the same underlying contract. Keep API keys on your server; never ship one in browser or mobile application code.
Self-hosting
OfferKit is MIT licensed and self-hosted. For a local evaluation or production topology, go to Deploy OfferKit.