Random.org Integration

Fair and transparent winner selection using Random.org's true random number generation.

Route

/admin/random-org

Overview

The platform integrates with Random.org to provide verifiable, cryptographically secure random winner selection for competitions.

Dashboard Status

API Configuration

• API Key Status - Configured/Not Configured
• Connection Status - Online/Offline
• Last Check - When status was last verified

Quota Information

• Bits Remaining - Random bits available
• Requests Remaining - API calls left
• Daily Quota - Your daily limit
• Quota Refresh - When quota resets

Quote usage is displayed to help you monitor your Random.org account limits.

Drawing Process

Standard Draw

1. Navigate to /admin/random-org
2. Click "Generate Draw"
3. Configure draw settings:
   • Minimum Number - Lowest ticket number
   • Maximum Number - Highest ticket number
   • Number of Winners - How many to select
   • Allow Duplicates - Usually "No" for fairness
4. Click "Generate Random Numbers"
5. Random.org processes the request
6. Results displayed with verification URL

Livestream Mode

For transparent public draws:

1. Enable "Livestream Mode"
2. Share your screen with participants
3. Select competition to draw
4. Competition details auto-fill
5. Execute draw live
6. Winners assigned automatically to competition
7. Participants see draw happen in real-time

Benefits of livestream mode:

• Builds user trust
• Demonstrates fairness
• Creates excitement
• Provides transparency
• Can be recorded for proof

Link Competition to Draw

Streamline draws by linking directly to a competition:

1. Click "Link Competition"
2. Select competition from dropdown
3. Draw settings auto-filled:
   • Min/max from competition tickets
   • Number of winners from competition settings
   • Competition end date shown
4. Verify settings
5. Execute draw
6. Winners automatically assigned to competition

This feature eliminates manual entry and reduces errors.

Draw Results

After each draw, you receive:

Winning Numbers

• All selected winning ticket numbers
• Order of selection
• Timestamp of each number

Verification Details

• Verification URL - Random.org proof link
• Draw Timestamp - Exact time of draw
• Request ID - Unique identifier
• Signature - Cryptographic signature
• Serial Number - Random.org serial number

Audit Trail

Every draw is logged with:

• Who performed the draw
• When it was performed
• Which competition (if linked)
• All configuration settings
• Full results
• Verification URL

Verification & Transparency

Verification URL

Each draw generates a Random.org verification URL that:

• Proves draw authenticity
• Shows exact parameters used
• Displays timestamp
• Provides cryptographic proof
• Can be shared with participants

Example verification URL:

https://api.random.org/verify?format=html&serialNumber=...

Transparency Features

Low Ticket Sales Transparency

When a competition has low ticket sales, a transparency note is displayed:

• Shows total tickets sold
• Explains fair selection process
• Links to verification
• Builds trust with participants

This helps users understand that even low-entry competitions use fair, random selection.

Sharing Verification

Share verification with winners:

• Include in winner notification email
• Display on competition results page
• Post to social media
• Add to terms and conditions

Draw Configuration

API Key Setup

Configure your Random.org API key in Settings:

1. Sign up for Random.org account
2. Generate API key
3. Navigate to Settings
4. Enter API key in Random.org section
5. Save settings
6. Return to Random.org page to verify

Draw Preferences

Set default preferences:

• Default number of winners
• Duplicate handling
• Verification email recipients
• Automatic draw timing
• Livestream settings

Draw History

View all past draws:

• Draw date and time
• Competition name (if linked)
• Numbers drawn
• Draw performer
• Verification URL
• Export capability

Exporting Draw History

1. Navigate to draw history
2. Apply date filters if desired
3. Click "Export"
4. Download CSV with all draw data
5. Use for compliance or auditing

Winner Assignment

Automatic Assignment

When using "Link Competition" mode:

1. Draw is performed
2. Winning ticket numbers identified
3. System looks up ticket owners
4. Winners automatically assigned to competition
5. Winner notifications sent
6. Fulfillment process begins

Manual Assignment

For standalone draws:

1. Perform draw
2. Note winning numbers
3. Navigate to competition
4. Manually assign winners
5. Enter ticket numbers
6. Save and notify

Troubleshooting

API Key Issues

If Random.org integration isn't working:

1. Verify API key is configured
2. Check API key is valid
3. Ensure quota isn't exhausted
4. Test connection status
5. Check Random.org service status

Draw Failures

If a draw fails:

1. Check error message
2. Verify parameters are valid
3. Ensure sufficient quota
4. Try again with same settings
5. Contact support if persists

Quota Management

Monitor your quota:

• Check bits remaining regularly
• Quota resets daily
• Plan draws accordingly
• Upgrade account if needed
• Use test mode for practice

Best Practices

Before Drawing

• Verify all tickets are accounted for
• Check competition has ended
• Ensure minimum entries met
• Test connection to Random.org
• Prepare to record (if livestreaming)

During Drawing

• Use livestream for transparency
• Double-check settings before generating
• Save verification URL immediately
• Record the draw if public
• Screenshot results for records

After Drawing

• Verify winners own the ticket numbers
• Save verification URL permanently
• Notify winners promptly
• Post results publicly
• Update competition status
• Begin fulfillment process

Compliance & Auditing

Record Keeping

Maintain records of:

• All draw results
• Verification URLs
• Draw timestamps
• Configuration used
• Who performed draw
• Winner assignments

Audit Trail

The system automatically logs:

• Draw requests
• Results
• Verifications
• Winner assignments
• Notifications sent

Export audit logs for:

• Compliance requirements
• Legal purposes
• Transparency reports
• Customer inquiries

Number of Winners

Display on Competition Details

The number of winners is prominently displayed in the competition details section, so users know how many winners will be selected before entering.

This information is shown:

• On competition listing pages
• On individual competition pages
• In competition details section
• During the draw process

Tips

• Always save verification URLs
• Use livestream for high-value prizes
• Test draws with low quotas first
• Keep your API key secure
• Monitor quota usage
• Link competitions for efficiency
• Share verification for transparency
• Record draws for proof
• Follow a consistent process
• Document everything