Concepts
The redemption experience
What your recipient sees after you hit send.
Every reward generates a unique, unguessable redemption link, delivered in a
branded email (and returned to you as redemptionUrl if you'd rather deliver
it yourself).
What recipients see
- Intro — your name (or
senderName), the reward value, and your personalmessage. - Pick cards (choice rewards) — a searchable catalog filtered to your
allowedBrandKeys, with country and price filters. On mobile it's a swipeable card deck. - Their cards — each issued card with its redemption code, PIN if any, and usage instructions. The link keeps working, so they can come back for the rest of a partially-used reward or to re-view codes.
Fixed rewards skip step 2 — the link goes straight to their card.
Your branding
The email and redemption page use your merchant branding:
senderName— the display name recipients seelogoUrl— shown in the email headerbrandColor— buttons and accents on the redemption page
Update it in the dashboard under Settings, or via
PATCH /v1/account/branding.
See the branding guide.
Security notes
- Redemption tokens are high-entropy, stored encrypted, and never appear in logs.
- Card credentials are encrypted at rest and only decrypted for the
recipient's session (or for you via
GET /v1/rewards/:id?include_credentials=truewith awrite-scoped key). - Opening the link marks the reward
OPENEDand fires a webhook, so you can detect engagement.