Integrate PechMove

Haulage & delivery for marketplaces

PechMove is PECH’s logistics product. PMap is the map, address, GPS, and proof layer it already uses. Ecommerce and marketplaces call /api/v1 from your server for pins, tracking, and POD — and keep orders, quotes, and money in PechMove (or your own fleet). Attribution is always © PMap.

Get an API key Logistics API reference Full map catalog GET /capabilities

Split of responsibility

PMap — geocode, reverse, pin confirm, route, track, POD metadata, disputes, traffic where probes exist.

PechMove — haulage quotes, driver assign, rate cards, outdoor pin gates. Not hosted in this map API.

PechPay — payments (separate product).

Ecommerce → delivery flow

1. Confirm the door

Suggest / reverse the pin, then POST /v1/stops/confirm. Only then is pinConfirmed true — never invent a landmark.

2. Hand off to PechMove

Create the haulage job in PechMove (or your fleet) with the confirmed lat/lng and your orderId. Quotes and drivers stay in PechMove.

3. Live track

Driver POST /v1/track/ping. Buyer and ops GET /v1/track/{device}?trail=1. Empty trail until a real ping — no fake GPS.

4. Proof & disputes

POST /v1/pod (you host the photo). POST /v1/disputes for evidence. Trip survey → /v1/integrations/pech-move/trip-outcome.

What you can access on /api/v1

Checkout pins

GET/POST /geocode · GET /search/suggest · POST /parse/freeform
GET /reverse after the buyer drags the pin
POST /stops/confirm (required)
GET /dispatchable · /address/* · /delivery/{code}
Widget: pmap-address.js → pmap:stop-confirmed

Route & cards

GET /route (driving / motorcycle / walking / cycling)
GET /staticmap for order thumbnails
GET /traffic · /weather at the drop pin

Tracking & fleet

POST /track/ping · GET /track/{device}?trail=1
GET/POST/DELETE /fleet/vehicles
GET /geofence/check against your zones

POD & disputes

POST/GET /pod (metadata; you host photos)
POST/GET /disputes (POD + GPS window)
POST /integrations/pech-move/trip-outcome
POST /integrations/{your-slug}/trip-outcome
GET /hints (UX only — never surge)

Keys & honesty

pm_live_ for production pins and GPS. pm_test_ is canned Lagos — not outdoor QA.
Partner slug for PechMove flows: pech-move. Your shop can use its own slug on POD / disputes.
We never invent GPS or mark a pin confirmed without POST /stops/confirm.

Full written guide: Logistics docs · Shareable markdown in the repo: docs/INTEGRATE-PECHMOVE.md

Getting your bearings…