The Voter Experience

Internal Public
📘 User Manual 41 views Updated 1 month ago

The Voter Experience

This page describes what your voters see and receive when they participate in a rewarded proposal or idea challenge - from discovering the reward to redeeming it on your external storefront.

Before Voting

Discovering Rewarded Proposals

Voters can identify rewarded proposals in two places:

  • Proposal list: A gift icon appears on the proposal card, signaling that voting comes with a reward
  • Proposal detail page: The reward title and type are displayed alongside the proposal description

For idea challenges, the challenge landing page shows two distinct prize tiers - what the winning submitter receives, and what every voter who participated receives - so voters know exactly what they stand to earn before they vote.

This visual signal helps voters prioritize which proposals to engage with and creates a positive anticipation loop - "I'll be rewarded for my participation."

After Voting

Once a voter casts their vote, nothing changes immediately. The vote is recorded, blockchain verification is queued, and the voter sees their standard vote confirmation.

The reward magic happens when the proposal closes (for proposal rewards) or when you announce winners (for idea-challenge rewards).

When the Proposal Closes

Within seconds of proposal closure - or when you announce challenge winners - eligible voters receive a reward notification email. This is a transactional service email (not marketing), delivered regardless of marketing consent preferences.

The Reward Email

The reward email is the single unified post-close message voters receive. It combines governance results with reward delivery, so voters get the complete picture in one email.

The email follows Vora's branded template and contains:

Header

  • Vora logo
  • "Hi {first name},"
  • "You earned a reward!"
  • "Thanks for voting on {proposal or challenge title}"

Results summary

  • For proposals: "The community chose: {winning option} ({percentage}% of votes)" - or "The proposal closed without reaching quorum" if quorum wasn't met
  • For idea challenges: a link back to the challenge page where the winning submission(s) are displayed

Reward details

  • Reward title (prominently displayed)
  • Reward type badge (e.g., "Discount Code", "Event Access")

Your voting code (new - shown on every reward email)

A styled monospace block displays the voter's unique code in two forms:

+--------------------------------+
|       Your voting code         |
|                                |
|         A3F7B2C9               |  <- 8-char short form, big, easy to type
|                                |
|  Full code: a3f7b2c9d1e8...32hex |  <- full 32-char form for API calls
+--------------------------------+

A one-line caption tells the voter how to use it: "Use this code on the brand's site to unlock your pre-order or exclusive access."

The same code works for both human-driven and automated redemption - the brand's commerce backend can accept either form.

Instructions (if configured)

The custom email message you set on the reward (e.g., redemption steps, terms, support contact).

Claim button

If you set an external link on the reward (e.g., your storefront URL), the email includes a clear call-to-action button that takes the voter directly there.

In-person fallback (for is_local rewards)

A QR code embedded inline plus an 8-character display code for venue staff to scan or read. The QR resolves to the public verification page so staff can confirm the claim before delivering the prize.

Footer

  • "Sent by {your brand} via vora"
  • GDPR notice (Art. 21 objection) with privacy contact
  • Italian D.P.R. 430/2001 promoter disclaimer (where applicable)

Redeeming on an External Storefront

If you've integrated your storefront with Vora's reward-verification API, the voter's experience on your site looks like this:

  1. Voter starts checkout for the rewarded product / pre-order
  2. Storefront shows a "Got a Vora voting code?" field
  3. Voter pastes either the 8-character short form (A3F7B2C9) or the full 32-character code
  4. Storefront's backend calls Vora's verify endpoint and either unlocks the purchase or flips the claim to redeemed automatically via HMAC server-to-server auth
  5. Voter completes checkout

The voter doesn't need a Vora account to use the code on the brand's site - possession of the code is what authorises redemption. That means a voter can also gift the code to someone else (intentional behaviour).

In-Person Redemption

For local rewards (cafes, pop-ups, retail), the flow is simpler:

  1. Voter arrives, shows the email or just reads out the 8-character code
  2. Staff scans the inline QR with any camera/QR app - it opens the verification page
  3. Staff confirms the reward title and status (pending vs already redeemed)
  4. Staff clicks Mark as Redeemed (requires logged-in admin session)
  5. Status flips to redeemed; staff delivers the prize
  • Verifying & Redeeming Claims - Admin side of the redemption flow plus HMAC server-to-server integration
  • Reward Strategy Guide - Best practices for maximising redemption

On This Page