Guide & Documentation

How Balotly Works

Learn how to set up anonymous elections, select the right registration flow, and audit votes cryptographically.

1. Election Creation Flow

Setting up an election on Balotly is completed in three main phases:

  • Setup Wizard: Input name, choose your pricing tier, and configure credentials.
  • Checkout Payment: Active plans are funded securely using the currency selected.
  • Sandbox Drafting: Configure positions, candidate bios, slogans, and upload voter lists directly in the dashboard before launching.

2. Voter Registration Modes

Choose the voter enrollment model that fits your organization:

  • Mode 1 (Pre-Authorized Roster): Upload voter contact lists. Single-use tokens are dispatched via Email or WhatsApp when voting begins.
  • Mode 2 (Voter Account Profiles): Voters register themselves online, set a password, and wait for manager approval. Approved voters log in and vote directly.

3. Decoupled Secrecy

Our core database architecture separates identity from ballot records:

  • Voter token records or profile login rows are stored in a dedicated registration domain.
  • Casting a ballot updates the voter entry to mark `has_voted = true`, but inserts the choices into an isolated ballots table with zero foreign keys linking back to the voter.

4. Cryptographic Ledger Receipts

Every submitted vote generates a unique receipt code shown once to the voter:

  • Voters copy and store their receipt code.
  • Once results are published, the public election overview page allows pasting receipt codes to confirm the vote was successfully tallied in the final results ledger.