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.