Build promotions on Loranj

Loranj runs the back end of a promotion: it checks codes, saves entries, enforces the rules, picks winners provably and keeps the data safe. You decide what the shopper sees.

There are two ways to launch:

• Hosted template. Loranj's branded microsite: one entry form with an inline email check, and a result page for prize draws and instant wins. No code needed; set it up in the dashboard.
• Headless. Your own front end, in any framework, talking to the Loranj public API through the TypeScript SDK. Use it for anything bespoke: receipt flows, games, quizzes, UGC, or a promotion inside an existing website.

These docs cover headless mode.

What you'll need

• A campaign set up in the Loranj dashboard. It gives you a public campaign key (pk_test_… or pk_live_…).
• Your site's domain added to the campaign's allowed domains.
• For server-to-server calls and webhooks, an agency secret key (sk_…) from the dashboard's API keys page.

Where to go next

• Quick start: a working entry form in about ten minutes.
• How Loranj works: campaigns, promo types and the entry pipeline.
• On-pack code entry: the full recipe, including every result state.
• Webhooks: get a copy of every entry into your own database.