Skip to content

Key concepts & statuses

The business: a sports facility with a name, address, contact email, photos, amenities, rules and a cancellation policy. A venue must be approved by the Kachiball team before it appears in the Player App.

StatusMeaning
PendingSubmitted, waiting for review by the Kachiball team
ActiveApproved — visible to players in the app
RejectedDid not pass review (the reason is recorded)
SuspendedTemporarily removed from the marketplace

A physical court inside a venue — for example “Court 1” or “Turf A”. A venue can have many fields, and each one is described by three attributes:

The format is the size of the game the field is built for, expressed as players per side. The naming comes from soccer, where field dimensions map to team sizes:

FormatPlayers per sideTypical use
F55 vs 5Small indoor/futsal-size court
F66 vs 6Small-sided court
F77 vs 7Medium court (very common in rental soccer)
F88 vs 8Three-quarter size court
F1111 vs 11Full-size regulation field

For sports other than soccer (basketball, tennis, padel, volleyball), pick the format closest to the field’s intended capacity — for example a tennis or padel court is normally F5 (the smallest), while a full basketball court fits F5 or F6. The format helps players judge how many people fit comfortably.

SurfaceMeaning
GrassNatural grass
TurfArtificial / synthetic grass
IndoorCovered court (wood, sport tile or similar)
ConcreteCement or asphalt, outdoor

Phase 1 supports Soccer, Basketball, Padel, Tennis and Volleyball. Players filter the app’s feed by sport, so set it accurately.

A bookable time window on a specific field: start time, duration in minutes, and price in USD. Slots can be paused (temporarily hidden from players without deleting them). Once a player books a slot it shows as Booked and cannot be taken by anyone else.

A player’s reservation of one slot. Statuses:

StatusMeaning
ConfirmedPaid and locked in — the default state after checkout
CancelledCancelled by the player before the start time; the slot is released
CompletedThe end time passed — set automatically by the system
No-showThe player never arrived (operational marker)

Every booking has exactly one payment, charged at checkout.

StatusMeaning
PendingCreated, not yet captured
SucceededCharged successfully — shown as Paid in the apps
FailedThe charge did not go through
RefundedFully returned to the player after an approved refund
Partially refundedA partial amount was returned

When a player cancels a paid booking, a refund request is created automatically and the Kachiball team resolves it manually in the Admin Portal.

StatusMeaning
RequestedWaiting for the Kachiball team
ApprovedAccepted, about to be processed
ProcessedMoney returned; the payment becomes Refunded
RejectedDenied (the reason is recorded in the audit log)

After a booking is Completed, the player has a 72-hour window to leave one review (1–5 stars and an optional comment). Reviews recalculate the venue’s public rating (average + count) shown in the app’s feed and venue detail.