Documentation

# Platform Overview

Tumr is a modern, pan-African logistics orchestration operating system. We provide standard REST APIs, mobile driver telemetry, automated wallet escrow locks, and On-Demand Courier comparisons. Tumr is live in Nigeria, with additional African markets planned as we expand.

Rather than building brittle integrations with dozens of regional courier services, merchants connect to Tumr once to access unified quotes, automated driver dispatching, geocoded addresses, and automated reconciliation.

Core Capabilities

Multi-Carrier Rate Aggregator: Query real-time quotes across regional and national courier fleets, on-demand rider networks, and private carrier fleets in a single API call.
Escrow-Secured Billing Ledger: Merchant order funds are locked in cryptographic escrow upon dispatch and released immediately to carriers upon verified delivery via recipient OTP.
Scan-to-Claim Dispatch Engine: Drivers scan package QR tags directly from the Tumr Rider mobile application to claim and lock order routes.
Sub-Second Telemetry & Tracking: Ingest driver GPS breadcrumbs to compute dynamic real-time ETAs and share branded tracking links with customers.
Agent-Attributed Commission: Field agents and coordinators earn referral shares (10%/5%) from delivery #1 — no commission holiday or deferred activation period.

System Architecture

+-----------------------------------------------------------------------------------+
|                                 YOUR APPLICATION                                  |
|                 (Shopify, WooCommerce, Custom Node/Python App)                    |
+-----------------------------------------------------------------------------------+
                                         │
                         REST API (HTTPS) / Webhooks
                                         ▼
+-----------------------------------------------------------------------------------+
|                               TUMR CORE ENGINE                                   |
|   ┌───────────────────┐    ┌───────────────────┐    ┌─────────────────────────┐   |
|   │   Quotes Engine   │    │  Escrow Ledger    │    │  Geocoding & Addressing │   |
|   └───────────────────┘    └───────────────────┘    └─────────────────────────┘   |
|   ┌───────────────────┐    ┌───────────────────┐    ┌─────────────────────────┐   |
|   │  Dispatch Broker  │    │ Webhook Publisher │    │   Address Geocoder     │   |
|   └───────────────────┘    └───────────────────┘    └─────────────────────────┘   |
+-----------------------------------------------------------------------------------+
           │                                 │                         │
           ▼                                 ▼                         ▼
+─────────────────────+           +─────────────────────+   +─────────────────────+
|   CARRIER FLEETS    |           |  RIDER MOBILE APPS  |   |  RECIPIENT PORTAL   |
| (Partner networks) |           |  (Scan-to-Claim QR) |   |  (Live Track & OTP) |
+─────────────────────+           +─────────────────────+   +─────────────────────+
```