API and integration surface

Driver API & Integrations

Hisbuu includes a token-based driver API, partner data import workflows, bank parsing, configurable storage, and WhatsApp settings. Deeper aggregator or ERP integrations can be scoped during rollout.

Plan Integration tech@hisbuu.com

What is available today

The current product separates driver app APIs, operational imports, and deployment integrations.

Driver REST API

Bearer-token endpoints for driver login, dashboard, submissions, KYC documents, adjustments, assets, and payouts.

Partner data imports

Admin workflows for partner daily uploads, comparison screens, missing submissions, and cash mismatch review.

Bank and settlement flows

Bank transaction logs, Bank Muscat parsing, settlement targets, remittances, and proof attachments for finance review.

Deployment integrations

Configurable Bunny CDN storage and WhatsApp messaging settings, plus client-specific environment setup.

Driver API endpoint groups

The documented driver API supports the native Hisbuu Driver app, the web/PWA driver portal, and client integrations that need authenticated access to driver-facing workflows.

  • JSON response formatConsistent success, error, validation, and pagination responses.
  • Bearer-token authLogin, refresh, current-driver profile, and logout flows.
  • Multipart uploadsSubmission proof and KYC files support image, PDF, and webp uploads.
Base path /api/driver

Authentication

Driver login, session refresh, profile, and logout.

/auth/login/auth/me/auth/refresh

Dashboard

Monthly orders, collection, deposit, balance, and pending work.

/dashboard

Submissions

Create, list, update, and inspect daily driver submissions.

/submissions/submissions/show/submissions/pending

KYC Documents

Status, required sides, document numbers, expiry dates, and file uploads.

/kyc/status/kyc/documents

Adjustments

Positive and negative monthly adjustment summaries and item history.

/adjustments

Assets and Payouts

Assigned equipment, payout cycle list, and detailed payout breakdowns.

/assets/payouts/payouts/show

Integration work we scope per client

Not every operator uses the same aggregator, payroll logic, bank format, or hosting model. During rollout, we map the practical data flow first.

  • Aggregator syncWhen direct aggregator APIs are available, we can scope order, earning, and driver-data sync against the client's partner contracts.
  • Finance exportsCustom accounting, ERP, or payroll exports can be shaped around the final payout cycle and approval policy.
  • Hosting controlsManaged hosting, dedicated installs, self-hosted deployments, backups, and CDN setup are selected per operating model.

Planning a technical rollout?

Send the current workflow, partner report format, and target hosting model. We will map what Hisbuu already supports and what needs custom integration work.