Getting Started
Welcome to Kete Koha! This guide covers everything from your first login to your final draw certificate.
You have two URLs — keep these handy:
Your slug is a short, URL-safe identifier for your organisation (e.g. riverdale-soccer). It was set when your account was created.
Initial Setup
Step 1 — Log in
Go to https://www.ketekoha.co.nz/a/your-slug and enter your admin password. You'll land on the Dashboard.
Keep your password private. Only share it with people who should be able to manage the raffle. If you need a reset, email hello@ketekoha.co.nz.
Step 2 — Fill in Settings
Go to Settings in the sidebar and complete:
- Raffle Title — e.g. "2026 Winter Fundraiser Raffle"
- Raffle Story — Tell supporters what the raffle is supporting
- Draw Date — When the winner will be drawn
- Ticket Price — e.g. $5.00 per ticket
- Bundle — Optional. e.g. 5 tickets for $20.00 (saves $5)
- Ticket Goal — How many total tickets you're aiming to sell
- Primary Colour — Your club's brand colour (any hex code)
- Bank Account — Your club's bank account — ticket payments go directly to you
- Bank Ref Prefix — Short code used in payment references, e.g.
SOCCER
Double-check your bank account number. All ticket payments go directly to this account. Kete Koha never handles your money.
Step 3 — Fill in Gambling Act Compliance
Go to Raffle Settings → Gambling Act Compliance and fill in:
- Total Prize Value (NZD) — the combined value of all prizes
- Proceeds Purpose — what the funds raised will be used for (e.g. "To fund travel costs for our U19 team's national tournament")
- Results Announcement — how and when results will be made public (e.g. "Results posted on our Facebook page within 24 hours of the draw")
Required for raffles over $500 in total prize value. If your prize value exceeds $500 you cannot set the raffle to Active until both Proceeds Purpose and Results Announcement are filled in. This aligns with Class 2 requirements under the NZ Gambling Act 2003.
Step 4 — Set status to Draft or Testing
Leave Raffle Status set to Draft while you're setting up. Use Testing to do a trial run with test orders before going live. Change it to Active once you're happy with everything and ready to start selling tickets.
Testing mode lets you place test orders and try the full flow without it being live to the public. When you switch from Testing to Active, the platform will ask if you want to delete any test orders first.
Prize Baskets
Each basket is a separate prize with its own ticket pool and winner. You can have as many baskets as you like.
Adding a basket
- Go to Prize Baskets in the sidebar
- Click Add Basket
- Fill in: name, description, and approximate value (NZD)
- Upload one or more images (see below)
- Set the display order (1 = first)
- Click Save Basket
Adding images
You have two options inside the basket editor:
- Upload Image — click the button and choose a photo from your device. It uploads to secure cloud storage automatically. You can upload multiple images — the first one is the main display image, others appear as thumbnails.
- Paste a URL — paste any publicly accessible image address and click Add.
Landscape images (wider than tall) look best. A 4:3 ratio works well. The first image in the list is the main one shown on the raffle page — drag to reorder or click a thumbnail to promote it to main.
Managing Ticket Orders
How the flow works
When a supporter buys tickets through your public page:
- They fill in their details and select a basket and quantity
- They're shown your bank account details and a unique payment reference (e.g.
SOCCER-K2X7R4) - Their order appears in your admin with status Pending
- They transfer the money to your bank using that reference
- You spot the payment in your bank — go to Ticket Orders → find the order → click ✅ Confirm
Only confirmed tickets enter the draw. Never draw before confirming all paid orders.
Adding orders manually
For cash sales at an event or over the phone, click Add Order in Ticket Orders. Set payment method to Cash and status to Confirmed.
Cancelling an order
Click the ✕ button next to any order to cancel it. Cancelled orders are kept for your records but excluded from the draw.
The "Sold By" column
If you use the Sellers feature, each order will show which seller referred the buyer. This column also appears in your CSV export.
Sellers & Referral Tracking
Sellers is an optional feature that needs to be enabled for your account by the Kete Koha team. If you can see the Sellers tab in your sidebar, it's active. If it shows as Coming Soon, get in touch and we'll switch it on.
The Sellers feature is designed for groups where multiple people are actively selling tickets — sports clubs, school fundraisers, gym groups, etc. Each seller gets their own unique link. When a buyer uses that link, the order is automatically tagged to that seller.
Think of it like the paper ticket books at a gymnastics fundraiser — except digital. Instead of handing someone a booklet of stubs, you send them a link or QR code.
How referral links work
Every seller gets a link that looks like:
When a buyer visits that link, they see a small banner: "You were sent by Emily Smith!". When they complete their purchase, the order is tagged to Emily. That's it — no codes to type, no extra steps for the buyer.
Adding a seller
- Go to Sellers in the sidebar
- Click Add Seller
- Enter their name — the ref code auto-fills (e.g. "Emily Smith" →
emily-smith) - Optionally add a note like "Year 5 — Room 12" or "Senior A Team"
- Click Add Seller
Here's what a typical seller list looks like:
Sharing a seller's link
Click the Link button next to any seller. From there you can:
- Copy Link — paste it into an email or group chat
- WhatsApp — opens WhatsApp with a pre-written message including the link
The easiest flow for large groups: open WhatsApp, paste each seller's link into a message to them. They can then share it on their own social media or in family group chats.
Printing the QR sheet
Go to the Sellers tab → click Print QR Sheet (also available in the sidebar). This opens a printable page with one cut-out card per seller, each with:
- Seller name and note (e.g. class/team)
- A QR code that links directly to their referral link
- Ticket price and draw date
Print it on A4, cut out the cards, and hand one to each seller. They show the QR code to potential buyers — the buyer scans it with their phone and goes straight to the raffle page, tagged to that seller.
Leaderboard
The Sellers tab shows a live leaderboard ranked by confirmed tickets sold — perfect for a bit of friendly competition! The dashboard also shows the leaderboard once referral data exists.
Sharing & Promotion
Your raffle link
Share https://www.ketekoha.co.nz/r/your-slug anywhere — email newsletters, Facebook posts, Instagram stories, WhatsApp groups, your club website.
The more places you share it, the more tickets you sell. Try posting in your club's Facebook group, emailing your member list, and pinning it to the top of your social profiles.
Embedding on your website
See the Embedding section below.
Conducting the Draw
Before you draw: Confirm all paid ticket orders. Two witnesses with different names are required — they can be physically present or join remotely using the remote witness link.
Confirm all paid tickets
Go to Ticket Orders and confirm every order where payment has cleared. Only confirmed tickets enter the draw.
Arrange two witnesses
Two people with different names are required. They can be in the same room as you, or you can send each one a remote witness link — they watch the draw live on their own device and sign the certificate remotely.
Open the Draw tab
Click Draw in the sidebar. You'll see a card for each prize basket showing how many confirmed tickets are entered.
Enter witness names
Type both witness names into the fields. They must be different — the system will reject identical names.
Click Conduct Draw
The winner is selected instantly using a cryptographic random number generator. The result cannot be predicted, influenced, or repeated.
Save the certificate
Click Certificate to view the draw certificate. Print it or save it as a PDF. Keep it for your records.
Remote witnesses
You don't need everyone in the same room. From the Draw tab, click Send Witness Link to generate a unique URL. Send it to your witness via email, WhatsApp, or any messaging app. They open it on their own device, watch the draw happen live, and enter their name to sign off — all without being physically present.
Remote witnesses are perfect for online fundraisers where your committee is spread across the country. The witness link is single-use and expires after the draw is completed.
Multiple winners per basket
If your raffle has multiple winners per prize (e.g. 1st, 2nd, and 3rd place from the same ticket pool), enable Multiple Winners in Raffle Settings before conducting the draw. Set the number of winners per basket — the draw will randomly select that many unique ticket holders in one go, each getting their own position on the certificate.
What's in the draw certificate?
The certificate records everything needed to independently verify the draw:
- Organisation name, raffle title, prize basket name and value
- Winner name and winning ticket number
- Draw date and time
- Both witness names
- Cryptographic seed (128-bit) — anyone can use this to verify the draw was fair
Announcing Winners
After drawing, contact your winners via email (their address is in Ticket Orders) to arrange prize collection.
To publish the result on your public raffle page:
- Go to Settings
- Set Raffle Status to Drawn
- Set Show Winner Publicly to Yes (public)
- Click Save Settings
Your public page will now display a winner banner and each basket's winner details.
Admin Panel — All Tabs Explained
| Tab | What it does | Key actions |
|---|---|---|
| Dashboard | Overview of your raffle — orders, revenue, ticket count, seller leaderboard | Monitor at a glance; leaderboard appears automatically when referral orders exist |
| Ticket Orders | All ticket reservations — buyer name, email, basket, amount, reference, seller, status | Confirm payment, cancel, view detail, search/filter, add manual orders, export CSV |
| Draw | Conduct the cryptographic draw for each basket. Send remote witness links. View and print the draw certificate. | Enter two witness names, click Conduct Draw, send remote witness link, view certificate, reset draw if needed |
| Prize Baskets | Manage your prizes — name, value, photos (upload or URL), description, display order | Add Basket, Edit, Delete, upload multiple images |
| Sellers | Manage people selling tickets — referral links, QR codes, leaderboard. Must be enabled for your account. | Add Seller, copy/share link, WhatsApp, Print QR Sheet, view per-seller stats, leaderboard |
| Raffle Settings | Raffle details, ticket pricing, status, Gambling Act compliance fields, bundle and goal settings | Save Settings, set Active/Draft/Testing/Drawn status, fill compliance fields |
| Organisation | Your org details, bank account, brand colour, legal/compliance IDs, page labels, tax invoice, account closure | Save Organisation Details, Save Bank Details, Save Compliance IDs, View Tax Invoice, Request Account Closure |
Exporting Order Data
Go to Ticket Orders → click CSV (or use the sidebar link). The export includes:
- Date, Buyer Name, Email, Phone
- Basket, Tickets, Amount, Payment Reference
- Payment Method, Referred By (seller name if applicable), Status
This is useful for payment reconciliation, your treasurer, or your auditor.
Embedding on Your Website
You can embed your raffle page on any website. Find the code in Settings → Embed on Your Website. It looks like this:
Works on Wix (HTML element), Squarespace (Code Block), WordPress (Custom HTML block), or any HTML website. Adjust height to suit — 900–1100px works well for pages with multiple baskets.
Tax Invoice
You can download a GST tax invoice for your Kete Koha subscription at any time. Go to Settings → GST / Tax Invoice → click View Tax Invoice. You can also access it from the sidebar.
The invoice is printable and can be saved as a PDF from your browser. It includes GST breakdown and subscription period details.
Legal Responsibility
Kete Koha provides the technology to run your raffle. You are responsible for ensuring your raffle complies with all applicable New Zealand laws.
NZ Gambling Act — quick guide
- Class 1 — Total prizes $500 or under. No licence required. Must be run at a single event.
- Class 2 — Total prizes $501–$5,000. No licence required, but must be run by a society for an authorised community purpose. Proceeds purpose and results announcement must be publicly stated.
- Class 3+ — Total prizes over $5,000. A gambling licence from the Department of Internal Affairs is likely required.
The platform enforces the Class 2 documentation requirements — you cannot set a raffle with prize value over $500 to Active until Proceeds Purpose and Results Announcement are filled in.
If you are unsure whether your raffle requires a licence or approval, we recommend:
- Consulting the Department of Internal Affairs website
- Reading the DIA guidance on running a raffle
- Seeking independent legal advice
Your responsibility: Kete Koha provides the technology platform only. You are responsible for legal compliance. If in doubt, seek advice before running your raffle.
See our full Terms & Conditions for details on responsibilities, data handling, and limitations of liability.
Closing Your Account
If you'd like to permanently delete your organisation and all associated data, go to Organisation → Danger Zone and click Request Account Closure.
This sends a deletion request to the Kete Koha team. We'll confirm your identity and process it within 2 business days. All raffle data, order history, and personal information will be permanently removed.
This cannot be undone. Make sure you've downloaded any data you need first — go to the sidebar and click Download All My Data before submitting the request.
Contact Support
If you get stuck, just email us — we're a small team and usually reply within one business day.
Need help?
Email us at hello@ketekoha.co.nz
We're happy to walk you through anything.