Rewardly Docs
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

  1. Intro — your name (or senderName), the reward value, and your personal message.
  2. Pick cards (choice rewards) — a searchable catalog filtered to your allowedBrandKeys, with country and price filters. On mobile it's a swipeable card deck.
  3. 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 see
  • logoUrl — shown in the email header
  • brandColor — 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=true with a write-scoped key).
  • Opening the link marks the reward OPENED and fires a webhook, so you can detect engagement.

On this page