DOEH Rider API (0.1.0)

First-party fulfillment API. This is the rider/delivery operational API used by the DOEH rider app. It is not part of the public integration SDK (sk_/edge) — it uses Sanctum bearer-token auth against the POS shop domain. Money is integer minor units.

First-party rider fulfillment API consumed by the DOEH rider app (doeh-rider-app). This is the rider stack, distinct from the @beyondplusmm/doehpos-sdk integration stack:

• Audience: delivery riders (a rider is a users row with role='rider'), not third-party integrators.
• Auth: the rider logs in with email + password and receives a personal Laravel Sanctum bearer token. There is no sk_ API key and no edge gateway in this path — the app calls pos-shop directly.
• Scope (INV-RIDER-2): a token represents exactly one shop context; shop_id is derived from the authenticated user, never sent by the client, and there is no cross-shop data access. A rider registered in multiple shops uses a separate login/token per shop.

Money is integer minor units (*_minor) on this public contract, matching the Orders convention. The internal Laravel aggregate stores float major units; a backend float⇄minor adapter is the authority that converts at the boundary (parallel to the Orders MoneyCodec). This document is therefore a governed projection of the already-authoritative API implemented in RiderDeliveryController / RiderNotificationController: it documents the public-facing surface, not the raw internal field shapes. Exception — the rider wallet is not yet on this minor-units ABI. Its fields (balance, total_collected, total_settled) are emitted as raw major-unit floats. The wallet aggregates COD across deliveries that may span branches and currencies, so it has no single currency to attribute and no canonical minor-units projection is defined for it yet (deferred — INV-RIDER-1b).