Phumi Kasephal Marketplace
ខ្មែរ EN
Chat Cart
REST API v1.1.0

API Documentation

Role-complete API contract for Website, Android and future clients.

OpenAPI 3.1 YAML
buyer

Buyer

Catalog, cart, checkout, orders, payment evidence, wallet, reviews and disputes.

seller

Seller / Store

Store, products, inventory, media, orders, delivery documents, team and promotions.

driver

Driver

Availability, assigned jobs, pickup, delivery proof and location updates.

admin

Administrator

Users, catalog, stores, orders, finance, moderation, delivery, disputes and audit logs.

Contract standards

Bearer authenticationJSON UTF-8OpenAPI 3.1 Page / per_page paginationIdempotency-Key on mutations X-Request-ID tracingPer-route rate limitsSigned webhooks 
{
  "ok": true,
  "data": { ... },
  "meta": {
    "request_id": "REQ-...",
    "api_version": "1.1.0",
    "page": 1,
    "per_page": 25,
    "total": 42,
    "total_pages": 2
  }
}

Buyer

GET/api/v1/mobile/capabilitiesDiscover role and feature capabilities.
POST/api/v1/mobile/buyer/orders/{id}/cancelCancel an eligible order safely.
GET · POST/api/v1/mobile/buyer/orders/{id}/disputesList or open an order dispute.
GET/api/v1/mobile/buyer/orders/{id}/documentsDownload order documents.
GET · POST/api/v1/mobile/stores/{id}/reviewsList or save a verified store review.

Seller

POST/api/v1/mobile/seller/products/{id}/inventoryUpdate stock and price.
GET · POST/api/v1/mobile/seller/products/{id}/mediaList or upload product media.
GET/api/v1/mobile/seller/orders/{id}/documentsList invoice and delivery documents.
POST/api/v1/mobile/seller/orders/{id}/deliveryUpdate delivery provider and tracking.
GET/api/v1/mobile/seller/teamList store-team permissions.
GET · POST/api/v1/mobile/seller/promotionsList or create promotions.

Driver

GET/api/v1/mobile/driver/dashboardProfile, workload and recent assignments.
GET/api/v1/mobile/driver/jobsPaginated delivery assignments.
POST/api/v1/mobile/driver/jobs/{id}/acceptAccept an assigned job.
POST/api/v1/mobile/driver/jobs/{id}/statusPickup, deliver with proof, or fail.
POST/api/v1/mobile/driver/availabilityUpdate availability and vehicle.
POST/api/v1/mobile/driver/locationSend a validated location update.

Admin

POST/api/v1/mobile/admin/products/saveCreate or edit a marketplace product.
POST/api/v1/mobile/admin/orders/{id}/statusApply a controlled order transition.
GET · POST/api/v1/mobile/admin/payments/{id}Inspect or review a payment.
GET · POST/api/v1/mobile/admin/wallet-requestsReview deposit and withdrawal requests.
POST/api/v1/mobile/admin/users/{id}/roleAssign a persistent account role.
GET · POST/api/v1/mobile/admin/deliveriesList or assign delivery jobs.
GET · POST/api/v1/mobile/admin/disputesModerate buyer disputes.
GET/api/v1/mobile/admin/audit-logsPaginated administrative API audit trail.

Request example

curl -X POST \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 23ef855c-8f39-4c33-a75a-98c858e76fd4" \
  -H "X-Request-ID: mobile-01HZZY8YQZ" \
  -d '{"availability":"available"}' \
  "https://phumikasephal.com/api/v1/mobile/driver/availability"

See the OpenAPI contract for every path, body, response and security requirement.