USER GUIDE

HOW TO USE ZIKOBOX

Everything you need to discover, purchase, and manage event tickets — without the headaches.

OVERVIEW

ZikoBox is a comprehensive event ticketing platform that allows you to discover, purchase, and manage event tickets through multiple channels. The platform supports web-based ticket purchases, chatbot integrations (Telegram and WhatsApp), mobile payments (M-Pesa and cards), and includes advanced features like agent-based ticket scanning and group ticket management. Think of it as your one-stop shop for event tickets — no more juggling five different apps.

KEY FEATURES

Multi-Channel Access

Web, Telegram, WhatsApp

Flexible Payments

M-Pesa, Cards, Bank Transfers

Group Tickets

Purchase multiple tickets in one transaction

SMS Notifications

Automatic confirmations for all purchases

QR Code Scanning

Agent-based ticket validation at events

Event Management

Complete organizer dashboard

Free Events

Instant ticket delivery for zero-cost events

GETTING STARTED

WEB REGISTRATION

1

Visit the ZikoBox website

2

Click "Sign Up" in the top navigation

3

Fill in your details: Name, Email, Phone (07XX XXX XXX or +254 7XX XXX XXX), Password

4

Click "Create Account"

5

Check your email for confirmation link

6

Click the confirmation link to activate your account

GOOGLE SIGN-IN

1

Click "Sign in with Google" on the login page

2

Select your Google account

3

Grant necessary permissions

4

Your account will be created automatically

ACCOUNT TYPES

Regular User

Browse and purchase tickets

Event Organizer

Create and manage events

Agent

Scan tickets at events (by invitation)

WEB APPLICATION

BROWSING EVENTS

Discover events through multiple ways:

Homepage

View featured and upcoming events

Search

Use the search bar to find specific events

Categories

Filter events by type or category

Date Filter

Find events by specific dates

EVENT DETAILS

Each event page displays:

Event Information: Title, description, date, time, location
Venue Details: Address and capacity information
Ticket Types: Available ticket categories and prices
Event Image: Visual representation of the event
Organizer Information: Event organizer details

PURCHASING TICKETS

1

Select the event you want to attend

2

Choose ticket type (VIP, General Admission, etc.)

3

Select quantity using the +/- buttons

4

Click "Add to Cart"

5

Continue shopping or proceed to checkout

CHECKOUT PROCESS

FOR REGISTERED USERS

Review your cart contents
Verify your contact information
Click "Proceed to Payment"
Choose payment method (M-Pesa, Card, Bank Transfer)
Complete payment through Paystack
Receive confirmation email and SMS

FOR GUEST USERS

Review cart contents
Fill in contact information (Name, Email, Phone)
Click "Proceed to Payment"
Complete payment process
Receive tickets via email and SMS

QUICK CHECKOUT

The quick checkout feature allows for streamlined ticket purchases with minimal steps — perfect for mobile users and high-conversion scenarios. Because let's be honest, nobody likes a long checkout process when you're trying to grab tickets before they sell out.

HOW IT WORKS

1

Event Selection: Choose from available quick checkout events

2

Ticket Selection: Select ticket type and quantity

3

Contact Information: Provide name, email, and phone

4

Instant Payment: Direct to payment gateway

5

Immediate Confirmation: Instant ticket delivery

BENEFITS

Speed

Reduced checkout time

Simplicity

Fewer steps to complete purchase

Mobile Optimized

Perfect for mobile users

Conversion

Higher completion rates

EVENT ORGANIZER

ACCOUNT SETUP

1

Register for a regular account

2

Contact support to upgrade to organizer status

3

Complete KYC verification (for paid events): KRA PIN and CR12 Document

4

Set up payment information for revenue collection

CREATING EVENTS

1

Access Dashboard: Go to "My Events" in your account

2

Create New Event: Click "Create Event" button

3

Basic Information: Event Title, Description, Category, Tags

4

Date & Time: Start Date, Start Time, End Date/Time, Timezone

5

Location Details: Venue Name, Address, City, Capacity

6

Ticket Configuration: Ticket Types, Pricing, Quantity, Sales Period

7

Event Image: Upload promotional image

DASHBOARD FEATURES

Event Statistics

Ticket sales, revenue, attendance

Ticket Management

Sales tracking, attendee lists, reports

Revenue Management

Payment tracking, Paystack integration

TELEGRAM BOT

GETTING STARTED

1

Open Telegram app

2

Search for "ZikoBox Bot" or use the bot username

3

Start a conversation by clicking "Start"

4

The bot will greet you and show available commands

BOT COMMANDS

/start Initialize bot and show welcome message
/help Display all available commands
/events Browse upcoming events
/mytickets View your purchased tickets
/account Manage account settings
/search [keyword] Search for specific events
/today Show events happening today
/weekend Display weekend events

PURCHASING TICKETS

1

Browse Events: Use /events to see available events

2

Select Event: Click on event button or use event ID

3

Choose Tickets: Select ticket type and quantity

4

Provide Information: Name, Phone number, Email

5

Payment: Receive Paystack payment link

6

Confirmation: Get ticket confirmation in chat

WHATSAPP BOT

GETTING STARTED

1

Get the WhatsApp bot number from the website

2

Save the bot number to your contacts

3

Send "Hi" or "Start" to begin

4

Use number options or keywords to navigate

FEATURES

Interactive Menus

Numbered options for easy navigation

Event Browsing

Scroll through available events

Image Sharing

Event images and QR codes

Document Delivery

PDF tickets via WhatsApp

TEXT COMMANDS

"Events" Show upcoming events
"My Tickets" Display purchased tickets
"Help" Get assistance
"Account" Account management options

GROUP TICKETS

Group tickets allow you to purchase multiple tickets in a single transaction — perfect for family outings, friend groups, corporate events, and bulk purchases. Because coordinating with friends is hard enough without having to buy tickets individually.

WEB APPLICATION PROCESS

1

Select Event: Choose your desired event

2

Multiple Ticket Types: Add different ticket categories

3

Quantity Selection: Use +/- buttons for each type

4

Group Information: Provide details for each attendee (optional)

5

Single Payment: One transaction for all tickets

6

Consolidated Delivery: All tickets in one email

BENEFITS

Single Transaction

One payment for multiple tickets

Unified Confirmation

One email with all tickets

Reduced Fees

Lower transaction costs per ticket

Easier Management

All tickets in one place

SMS NOTIFICATIONS

ZikoBox automatically sends SMS notifications for all successful ticket purchases, ensuring you receive immediate confirmation regardless of your purchase channel. Because email confirmations are great, but SMS confirmations are the real MVPs.

SMS PROVIDERS

PRIMARY

Africa's Talking SMS

FALLBACK

Advanta SMS (automatic retry)

SINGLE TICKET SMS

Your ticket for 'Event Name' has been confirmed.
Total: KES 1,500
Ref: #ABC123DEF
Check your email for tickets.
Event: Aug 15, 2025 at 7:00 PM
Venue: Carnivore Grounds

MULTIPLE TICKETS SMS

Your 3 tickets for 'Music Festival 2025' have been confirmed.
Total: KES 4,500
Ref: #XYZ789ABC
Check your email for all tickets.
Event: Aug 20, 2025 at 6:00 PM
Venue: Uhuru Gardens

PHONE NUMBER SUPPORT

0722000000 (10 digits)
722000000 (9 digits)
+254722000000 (international)
254722000000 (country code)

DELIVERY FEATURES

Immediate

SMS sent within seconds of payment

Consolidated

One SMS per payment reference

Reliable

Multiple attempts with fallback providers

AGENT & QR SCANNING

The agent system allows event organizers to invite trusted individuals to help with ticket validation and attendee check-in at events. Think of it as your VIP security team, but for tickets.

INVITING AGENTS

1

Access Event Dashboard: Go to your event management page

2

Agent Management: Click "Manage Agents" button

3

Invite New Agent: Click "Invite Agent"

4

Agent Information: Email address and role confirmation

5

Send Invitation: Agent receives email with instructions

6

Track Status: Monitor invitation acceptance in dashboard

AGENT PERMISSIONS

Ticket Scanning

QR code validation at events

Admission Control

Check-in attendees

Event Access

Limited to assigned events only

Statistics

View scanning performance

SCANNING PROCESS

1

Login: Sign in to your agent account

2

Agent Dashboard: View assigned events

3

Select Event: Choose event to scan for

4

Open Scanner: Click "Scan Tickets" button

5

Camera Access: Allow camera permissions

6

Scan QR Code: Point camera at ticket QR code

7

Verify Ticket: Review ticket details before admission

8

Check-in: Mark ticket as used/admitted

PAYMENT METHODS

ZikoBox supports multiple payment methods through Paystack integration, providing flexibility for all users across Kenya. Whether you're an M-Pesa loyalist or a card person, we've got you covered.

SUPPORTED METHODS

M-Pesa

Primary method. STK Push with automatic payment prompts and real-time processing.

Credit & Debit Cards

Visa, Mastercard, American Express, and local Kenyan bank-issued cards.

Bank Transfers

Direct bank transfer from any Kenyan bank with real-time verification.

USSD Payments

Works on basic mobile phones with all major Kenyan networks.

PAYMENT PROCESS

1

Secure Checkout: Paystack-hosted payment page

2

Method Selection: Choose preferred payment option

3

Payment Processing: Secure transaction handling

4

Instant Confirmation: Real-time payment verification

5

Automatic Ticketing: Immediate ticket generation

FREE EVENTS

Instant Delivery

Immediate ticket generation for zero-cost events

No Payment Required

Skip payment process entirely

Email & SMS

Confirmation via both channels

TROUBLESHOOTING

ACCOUNT ISSUES

Can't Log In

Check Credentials: Verify email and password
Account Confirmation: Check email for confirmation link
Password Reset: Use "Forgot Password" feature
Account Lockout: Contact support if account is locked

Email Not Received

Check Spam: Look in spam/junk folders
Email Address: Verify correct email was provided
Delivery Delay: Allow up to 30 minutes
Resend Option: Use resend confirmation feature

PAYMENT ISSUES

Payment Failed

Insufficient Funds: Check account balance
Card Issues: Verify card details and expiry
Network Problems: Try again with stable connection
Payment Method: Try alternative payment option

Payment Successful but No Tickets

Email Delivery: Check email (including spam)
Processing Time: Allow up to 15 minutes
SMS Confirmation: Check for SMS notification
Contact Support: Report missing tickets

TICKET ISSUES

QR Code Not Scanning

Image Quality: Ensure clear, high-resolution QR code
Lighting: Scan in good lighting conditions
Camera Focus: Keep camera steady and focused
Manual Entry: Use backup code if QR fails

Ticket Shows as Invalid

Event Match: Verify ticket is for correct event
Date Validity: Check event date and time
Already Used: Ticket may have been previously scanned
Contact Organizer: Report invalid ticket issues

GETTING HELP

Email Support

Contact via [email protected]

Live Chat

Available during business hours

FAQ Section

Check frequently asked questions

Response Times

Critical: 2hrs / General: 24hrs / Bugs: 48hrs