1. Driver role and dashboard

The dashboard keeps the primary work controls visible and groups secondary destinations in a collapsed workspace. Expand that workspace only when needed. During a refresh, short labels remain visible instead of technical availability messages; use the relevant refresh action if current data is required.

A KiloDrive driver is an independent service provider who may operate as an individual, sole trader, or registered business. The Driver dashboard brings the workday into one place.

Primary navigation

Use Home, Verification, Offers, Active jobs, Leaderboard, Wallet, Billing, My vehicle, Reports, Tools, Privacy & Safety, Profile, Settings and Support. Wide layouts use a navigation rail; phones use a bounded, scrollable drawer.

2. Account setup and access

1. Install only the official KiloDrive app and complete the welcome wizard.
2. Choose Service Provider → Driver, then country and language. Connectivity and API status must pass.
3. Sign in by phone OTP (SMS preferred; WhatsApp second), email/password, or an available verified social provider.
4. If the phone/social/email is new, finish the account-completion wizard with correctly capitalized first and last names and confirmation email.
5. Enter driver details. If operating as a business, select the business account type and provide legal/trading name, registration, tax and contact information.
6. New drivers who begin without a password must set one within the configured onboarding window. Use the show/hide password control and a unique password.

Protect access

Enable 2FA, save recovery codes offline, review social connections and device sessions, and enable biometric app lock. Never let another person use your driver session; vehicle assignment does not transfer account access.

Phone verification by automated call

Contact details may offer Call me with a code. The API uses AWS End User Messaging Voice to call the E.164/international-format number and speak the six-digit challenge twice. Requests have a 30-second resend interval, expire after one ten minutes, and locks after repeated failures. If calling is unavailable, use the offered SMS or WhatsApp path.

3. Driver verification

A new driver completes a resumable 12-page journey. It cannot be skipped. Back, Next, Save for later, basic Settings, and Logout keep the driver inside the controlled journey. Progress is server-backed, and a completed driver is never sent backward because a local cache was cleared or a vehicle lookup was temporarily unavailable.

3.1 Private document handling

Document handling

Files are private, randomized, magic-byte checked and limited to PDF/JPEG/PNG up to 10 MB. Production storage uses a private S3 bucket. Upload the minimum necessary information and never submit an altered document.

Tap an upload row and choose Take photo, Choose from gallery, or Choose PDF or image. Photo tools correct rotation, allow cropping, remove unnecessary metadata, and compress the image before transfer. The app uploads each file first, then links its private storage reference to the verification case only after the server confirms ownership, signature, malware-scan status, and size. A successful submission is shown as pending; pressing Submit repeatedly is not required.

4. Vehicles and driver assignments

1. Open My vehicle and choose Add vehicle.
2. Select manufacturer, model and year from the centrally managed catalog; choose category, color and exact plate/tag number.
3. Save and upload vehicle images, registration and insurance. Images are compressed and displayed in the vehicle gallery.
4. Submit the vehicle for review. Editing verified details resets verification and alerts administrators.
5. Activate only a verified, insured vehicle allowed by your plan.

Ownership and assignments

A vehicle can have historical relationships with multiple drivers, but only one active driver assignment at a time. Assignment history preserves start/end time and reason. The plate/tag belongs to the vehicle. Customers may use that plate/tag to create a privacy-preserving block, but will not see hidden driver details.

Archiving

Removing a vehicle archives it rather than erasing trip history. Pending assignments or completed financial records remain auditable.

5. Availability, offers, and bidding

1. Complete every verification gate, choose the active vehicle, and set yourself Online.
2. Open Offers. Only requests within the dispatch window, country/category and eligibility rules appear.
3. Open a request to review origin/destination area, estimated distance/ETA, passenger count, payment method and proposed fare. Where available, use Route preview before responding; estimates do not guarantee live traffic.
4. Adjust your bid using the slider or valid amount control. Bid values cannot be negative or exceed 1,000,000 in local currency.
5. Submit once. Network retries use a stable idempotency key; stale/closed requests are discarded with a typed message.
6. Monitor acceptance. One driver wins atomically; losing bids do not create a trip.
7. Accept and work only one active assignment where the rules require it.

Professional dispatch tools

Scheduled availability and preferred service areas help matching. Scheduled rides show whether assignment is pending, reconfirming, replacing a driver, guaranteed, or not guaranteed. A guarantee is shown only after the required driver confirmation and eligibility checks; never treat an early reservation request as assigned work.

Offline queue

Retryable failures (408/425/429/5xx) may enter the bid outbox with expiry-aware backoff and Retry-After. Semantic 4xx errors are terminal. Use failed-queue recovery rather than creating duplicate bids.

6. Execute a passenger trip

The enforced sequence is Requested → Bid accepted → Driver arrived → Trip started → Trip completed, or an authorized cancellation.

Ride types and stops

A request can be immediate or scheduled and can contain explicit intermediate stops, a return/turnaround, waiting time, or an hourly service window. Review every stop, wait allowance, booked minutes, and quoted charge before bidding. Do not treat a stop as free-form destination text; each stop has its own order and lifecycle.

1. After acceptance, navigate to pickup and communicate only as needed through the assigned trip chat/call.
2. At the pickup geofence, mark Driver arrived. Do not skip this state unless an audited admin override applies.
3. Confirm rider and destination; use the rider PIN/geofence confirmation where enabled.
4. Start the trip only when the rider is safely aboard.
5. Follow navigation, obey road laws and respond to material ETA drift or route-anomaly check-ins.
6. At destination, stop safely and complete the trip. GPS may propose/trigger completion only after the driver remains within the configured destination radius for the required dwell period.
7. Review payment and earning status. Chat locks and the active call terminates when completed/cancelled.

6.1 Communication, timeline, and telemetry

Chat and calls

Only the assigned driver and passenger can read/send active trip chat. Emoji is supported; sent time includes seconds. SignalR delivers live events, while push wakes supported incoming-call UI. Calls include timeout/cancel cleanup to prevent orphaned rooms.

Timeline and telemetry

Milestones are stored with UTC timestamps. Authorized trip replay uses ordered GPS samples for safety investigation, with access controls, audit and retention requirements.

Active-trip background location

From approach/arrival through an active trip, Android and iOS can keep collecting location after the app is backgrounded or the screen is locked. The operating system displays a visible trip/location status. Samples use unique IDs, are queued within a bounded account-bound store when offline, and are uploaded after reconnection. The rider sees Live, last-updated, or temporarily-unavailable freshness rather than a silently frozen marker. Collection stops when the assignment ends.

7. Parcel delivery jobs

1. Review sender, recipient, stop sequence, parcel facts, payment method, route and proposed amount.
2. Refuse prohibited, unsafe, improperly packaged or materially misdescribed items.
3. Review declared contents/value, protection option, handling and delivery window.
4. At pickup, capture the required photo and confirm the sender's OTP or QR before taking custody.
5. Complete every stop in order. The final completion is blocked while stops remain pending.
6. For wallet jobs, escrow was held from the sender at acceptance and releases at completion. For cash jobs, collect the shown amount; KiloDrive does not deduct trip commission.
7. At delivery, collect recipient OTP plus required signature/photo proof before completion.

A failed delivery records the attempt and evidence. Follow the next authorized action - redelivery, safe return-to-sender, or support - and preserve the chain-of-custody timeline. Cancelling an assigned-not-started job follows policy and can refund escrow. Complete-vs-cancel transitions are atomic to prevent double settlement.

8. Wallet, earnings, and payouts

Driver ledger

Each completed job provides gross fare, platform fee, tax deduction when applicable, net driver earnings, payout status and timestamp. Use Today, Week and Month filters.

The Driver Toolkit adds destination mode, service areas, scheduled availability, airport/venue queues, earnings goals, hourly/day/week profitability, mileage and fuel/expense tracking, membership usage, demand forecasts, trip-quality analytics, payout projections, and downloadable statements. Forecasts are estimates, not guaranteed earnings or payout dates.

1. Open Wallet to review available/held balance and transaction details.
2. Open Earnings/Reports for trip-level gross, fees, net payout and settlement status.
3. Add a payout method by selecting your country bank first, then a branch belonging to that bank, account type, ISO currency and account number. Confirm the accuracy checkbox before saving. Only masked bank/PayPal descriptors are subsequently displayed.
4. Request a cashout within the plan/default minimum, maximum, rolling daily/weekly limits and fraud cooldown.
5. Pending cashout funds are held. Admin approval settles; rejection returns the hold.

Cash trips

Cash collected from riders is recorded for reconciliation. KiloDrive does not deduct trip commission; taxes, refunds, chargebacks, cashout costs, and separately disclosed charges remain distinct.

Choose the access level that fits your work

9. Driver membership prices, benefits, and limits

Driver access uses Free, Silver, and Gold membership tiers instead of deducting a percentage commission from an ordinary trip fare. You keep the agreed fare before your own fuel, tax, refund, chargeback, payout, or other separately disclosed costs. A membership provides platform access; it does not guarantee requests, income, or Preferred status.

Apple or Google displays and charges the final storefront price for the selected term. Storefront currency, country availability, price, term, benefits, renewal and cancellation terms are authoritative only when shown in Membership immediately before purchase. Do not rely on an old document, screenshot or currency conversion as a purchase quote.

10. Billing, purchase, renewal, and expiry

Purchase or change a plan

1. Open Membership and review the Current plan, Billing, and Other plans tabs.
2. Select a compatible driver tier and a 7-, 30-, or 90-day term.
3. Review the store-localized price, limits, start/end dates, automatic-renewal disclosure, Privacy Policy, and Terms of Service.
4. In App Store and Google Play builds, buy digital membership only through StoreKit or Google Play Billing. External wallet, voucher, card, PayPal, and bank-transfer membership checkout is hidden.
5. Wait for server verification. A Google purchase may briefly show acknowledgement pending; do not buy it again.
6. Use Restore Purchases after reinstalling, then manage renewal in the platform subscription settings.

Renewal, grace, and plan changes

Billing distinguishes active, acknowledgement-pending, grace/retry, expired, refunded, revoked, and resubscribe states. An upgrade uses the paid service period for proration. A downgrade takes effect under the store's rules. Refunds, revocations, and chargebacks can end the related entitlement. Never assume an app notification alone proves a purchase; the server-verified entitlement is authoritative.

Cancel or restore safely

Cancellation normally stops automatic renewal and keeps paid access through the server-verified access-through date. Review the provider, renewal price, benefits that remain, policy link and exact effective date before confirming. Native Apple or Google subscriptions may require the platform subscription-management screen. After a verified cancellation, Current plan shows the retained-access period and a receipt appears in Notifications and email. Use Keep membership only when Current plan offers it; otherwise use the provider-management or support action shown by the server.

11. Safety, duty, security, and privacy

Professional safety

• Confirm rider/parcel and destination before movement; never expose protected rider data.
• Observe country-specific online/driving duty windows. Warnings precede thresholds; new assignments can be blocked while emergency completion remains available.
• Respond to unexpected-stop, route-deviation and dual-party check-ins.
• Use emergency escalation and call 119 in Jamaica when immediate police help is needed.

Mutual blocking

Eligible drivers can block riders they have legitimately interacted with, subject to plan and privacy rules. Blocking removes future matching/contact; it is not a substitute for reporting a safety incident.

Data protection

Use Privacy & Safety for block list, export and deletion requests. Location, identity, vehicle, chat and financial records have distinct retention/legal purposes. Do not screenshot or redistribute customer data except for a legitimate report to KiloDrive or authorities.

Account security

Use 2FA, biometrics, recovery codes, verified contact details and session details. Keep OTPs, payout data and keys secret. Report an unknown device/session immediately.

Password-recovery requests always use the same confirmation wording whether or not an account exists. The recovery screen shows code validity and resend timing. Security emails identify the action, request/expiry time, timezone, device, OS, app version and a masked network hint. A completed reset revokes other sessions under account policy; review Session details after recovery.

12. Verification Center and Preferred Driver Program

Verification Center

Upload current ID, proof of address, police record, vehicle registration and vehicle insurance through the private document workflow. Each item is magic-byte validated, stored privately, reviewed, and monitored for expiry where applicable. Rejection notes explain what to replace; never email identity files.

Preferred Driver Program

Only an active Gold-plan driver may apply. Eligibility requires at least 1,000 ratings, 100 completed trips and full verification: ID, proof of address, police record, valid registration and valid insurance. Approval is reviewed, not automatic. Approved drivers receive a Preferred badge, an entitlement to two KiloDrive branded shirts, and access to rider requests restricted to Preferred Drivers. Suspension or expired evidence removes exclusive access until resolved.

Reputation is more than one star average

KiloDrive records structured feedback for cleanliness, punctuality, communication, and safe driving, plus verified trip count, long-term reliability, and document status. Drivers can also provide structured rider feedback. Reviews are released and moderated under anti-retaliation, duplicate, conflict, and manipulation controls. Optional third-party review screenshots are evidence for an administrator-set starting count/score - they are never auto-approved.

RideCheck and emergency response

RideCheck compares live telemetry with the planned route and detects sustained material deviation or unexpected stops. A route-change alert asks the rider whether they are safe and is escalated if it goes unanswered; other safety events may request a separate driver check-in. Never handle the rider's phone or pressure a response. For immediate danger, stop only when safe, use the active-trip Emergency button and call the local authority (119 in Jamaica). Live Trip Sharing may expose the assigned vehicle, route and safety stops to a rider-authorized trusted contact; accesses expire and are audited.

Data duties

Driver identity, police, location, chat and financial data are separated by purpose and access role, encrypted in transit and stored under retention controls. Do not retain rider data off-platform. KiloDrive redacts secrets/payment data from logs and audits verification, safety and administrative actions.

13. Calculator tools

1. Open Calculator Tools in mobile or portal.
2. Enter valid non-negative inputs and review units/currency.
3. Save the result where available; saved calculations are audit logged.
4. Export a Letter-size professional PDF with logo, calculator title and generation date.

Outputs are estimates; verify lender, toll operator, tax and vehicle costs independently.

14. Use the Driver portal

1. Open https://my.kilodrive.com and verify HTTPS.
2. Sign in and complete 2FA. The menu is role-aware.
3. Use Driver dashboard, trips, earnings, vehicle, reports, Billing, settings and support.
4. Open a trip for timeline/route details. Authorized replay access depends on role and investigation policy.
5. Use Billing to review membership selection, plan expiry, payment methods and history.
6. Use Notifications for durable trip, bid, chat, wallet, membership, support and security history. Push permission or sound affects the delivery channel, not the in-app record.
7. Download earnings, trip or wallet reports as PDF/Excel.
8. Sign out on shared devices.

15. Support and incident response

1. For immediate danger, stop safely, use active-job safety tools, and call the local emergency service.
2. For an app problem, record time, trip/delivery ID, screen and exact error without collecting private passenger data.
3. Check connection/API status, permissions, active country and verification status.
4. Select the affected trip, payment, document, delivery, rental, or account item.
5. Choose the structured issue type, explain it briefly, and attach only relevant evidence.
6. For payment uncertainty, quote the payment/correlation ID and wait for reconciliation—do not repeat the payout or settlement.
7. For vehicle/document corrections, use the dedicated verification workflow rather than a general profile edit.

Reply inside the case so the secure message and attachment history remains together. Closing a case does not erase evidence that KiloDrive must retain for safety, finance, fraud, dispute, or legal purposes.

Available support options

Severity and response

Choose the category that reflects actual impact. Duplicate tickets slow investigation. Money, safety, privacy, identity, and account-compromise cases receive specialized handling; response time depends on urgency, evidence, provider dependencies, and jurisdiction.

Appendix A. Negotiated bidding and ranking

Standard rides are never automatically awarded by the matching worker. The rider proposes a fare; ranked drivers accept or counter; the rider selects the winner. The API commits the ride and durable job together and returns immediately.

1. Valkey GEO search starts at 3 km.
2. You are rejected before routing if offline/inactive, stale, busy on an assigned/arrived/in-progress trip, missing a compatible active vehicle, mutually blocked, missing child-seat capacity, not pet eligible, not WAV eligible, or not airport eligible.
3. Nearest-K Haversine truncation limits OSRM/traffic routing.
4. The lower-is-better score weights traffic ETA 50%, distance 20%, acceptance penalty 15% and rating penalty 15%. The best 5–10 receive a short exclusive wave; a Valkey atomic lock prevents competing offers.
5. Submit Accept or counter-price; a push is not an assignment. Only rider acceptance creates the trip.

Hungarian/Jonker–Volgenant: these optimize a multi-ride/multi-driver bipartite matrix globally. Hungarian is typically O(n³); Jonker–Volgenant is an optimized augmenting-path family. Standard bidding does not use them to override marketplace choice. Future Speed Match requires separate consent, price, cancellation, timeout, audit and fallback rules.

Appendix B. Money, disputes, and account status

Hosted PSP pages protect raw card data. Wallet holds are not cashout-able. Cashouts pass plan, velocity, cooldown and fraud checks and retry only after a known result. Gross fare, platform fee, applicable tax deduction, tips and net earnings are separate ledger concepts; drivers remain responsible for applicable tax advice and filings.

Refunds/rejections are linked reversals, never deleted history. Chargebacks can produce negative balances and payout restriction. Safety, document, fraud, legal or payment review can cool off/suspend an account; termination preserves valid liabilities and legally retained records.

Use 2FA and biometric lock; never copy rider data off-platform. KiloDrive uses TLS, private storage, tenant/country isolation, audit and log redaction. Verified law-enforcement requests are scoped and disclosed minimally; emergency life/safety access is documented.

Appendix C. Breakdown, towing, collision, and injury

1. Stop safely, activate hazards and call emergency services for injury, fire, crime, obstruction or danger (119 in Jamaica).
2. Account for occupants; do not diagnose or move an injured person except under professional instruction or immediate hazard.
3. Inform the rider, use active-trip safety, stop accepting jobs and do not falsely complete.
4. When safe, capture location, plate, damage, road/weather, other-party/insurer details, witnesses and police report. Do not admit liability.
5. Request approved roadside help. Keep the vehicle offline until repaired/reverified.
6. Verify towing authority/operator/destination and custody. Never immobilize a moving vehicle.
7. For injury, obtain care, notify insurer, preserve evidence and use the restricted case channel for medical data.

Insurers/authorities determine fault, coverage and compensation.

Appendix D. Driver membership purchase, usage, and renewal

Billing & Membership shows usage fillers against bids, accepted rides, vehicles, vehicle changes, favorites, and other plan limits. Select a 1-week, 1-month, or 3-month term and review the local-currency quote.

1. In an App Store or Google Play build, purchase a digital membership only through the native store checkout. External membership methods are hidden. Other approved channels may be offered outside those store builds where policy and local law permit.
2. Hosted and bank payments remain pending until verified or approved.
3. Keep the congratulations receipt showing plan, cost, effective date, expiry date, and benefits.
4. Push, email, and SMS reminders are sent two days before expiry.

Payments are idempotent and financial events use balanced integer-minor-unit debit/credit journals.

Driver task procedure and recovery reference

KiloDrive support codes

Support needs the KD code and correlation ID, plus trip/vehicle reference and time. Never send passwords, codes, tokens, complete payment data or unredacted identity evidence through ordinary support messages.

Current workflow and recovery

Choose your country and Drive and earn role and retain these choices through registration. Confirm your email for manual email signup and confirm the required phone number. Upload legible identity, licence and profile evidence, then add the vehicle and required registration, insurance and fitness evidence. Uploading a document is not approval. Review notes explain corrections; the authoritative activation checklist supplies the next action.

Identity, driver profile, document review, vehicle approval, membership or trial, payout readiness and safety acknowledgment are separate requirements. The API owns the readiness decision. An approved identity badge alone does not permit bidding or going online. Reload the checklist after review or a country/account change.

Review the latest offer, trip or booking before a state-changing action. A stale revision means another decision changed the record. Reload and review it before continuing. During a trip, expand the map for route context and use trip details for the next permitted arrival, start or completion control. Stale or inaccurate GPS is not proof of arrival. Avoid interacting with the app while driving.

Calls and chat require available connectivity, eligibility and provider service. Use the safe support/contact alternatives when they are unavailable. Read aloud is optional in accessibility settings and hidden by default. A timeout does not prove that a payment failed: check the original outcome and keep its support reference before another submission. Keep currencies separate when reviewing money.

Authorized operators can use the expandable mobile management domains for people, operations, finance, support, communications, system and insights. Follow the mobile administrator guide for evidence review, readiness refresh, top-up issuance and read-only investigation. A visible route is not proof that every mutation or provider is certified.

Glossary

Compliance gate

The server-side evidence, vehicle, membership, block-list, duty, and trip-state checks a driver must pass before receiving or submitting a bid.

Any driver

An opt-in country-wide request surface governed by driver filters and notifications rather than only the Near Me expansion.

Active-trip telemetry

Location samples collected for approach, trip progress, safety, and RideCheck while an eligible assignment is active, including permitted background operation.

Scheduled guarantee

A state reached only after a reserved driver reconfirms and KiloDrive rechecks eligibility; a future request alone is not guaranteed.

Chain of custody

The ordered parcel pickup, OTP/QR, evidence, stop, delivery, failed-attempt, and return events that identify who held the parcel.

Outbox

The durable queue written with a business change so notifications and external effects can retry without repeating the financial or trip mutation.

Smart ranking

The proximity, ETA, traffic, eligibility, and quality score used to stage notifications. Standard rides remain negotiated and rider-selected.

Membership entitlement

The current Free, Silver, or Gold operational limits and service period verified by the API. KiloDrive does not deduct a trip commission from driver earnings.

Primary vehicle

The active assigned vehicle used for bidding eligibility; required registration, fitness, and insurance evidence must remain valid.

Settlement ledger

The immutable minor-unit records for fare, fees, taxes, tips, holds, releases, refunds, cash debt, and driver earnings.

Index