Dropoint for developers

Prices at checkout

Show the delivery price on your checkout so the customer pays the right amount. Dropoint keeps the price it gave you for 48 hours.

Get a price#

POST https://api.dropoint.co.ke/api/integrations/v1/stores/quotes/ (scope orders:quote)

Field
lat, lngorThe drop-off pin. Best.
addressorText Dropoint finds on the map.
areaA Dropoint area name, e.g. Kilimani. Used when there's no pin or address.
sizeoptionalsmall (default), or another parcel size the store uses.
vehicle_typeoptionalmotorcycle (default), car, van…
branch_idoptionalThe shop it leaves from, when the store has branches.
{"quote_id": "6f1c…", "fee": "240.00", "currency": "KES", "priced_by": "dropoint",
 "vehicle_type": "motorcycle", "package_size": "small", "distance_km": "4.300",
 "expires_at": "2026-11-24T13:20:00+03:00",
 "drop_off": {"address": "…", "area": "Kilimani", "point": {"lat": -1.29, "lng": 36.78}}}
  • Asking again for the same place within a few minutes gives the same quote_id, so reloading the checkout costs nothing.
  • Each store may ask for 2000 prices a day.

The price promise#

Send the quote_id with the order. If the store marks the order ready within 48 hours and Dropoint's price went up, the store still pays the price your customer saw. If it went down, the store pays less.

The promise holds while the drop-off stays where it was quoted (within about 150 m), with the same vehicle and shop. A rise above 30%, or a promise that has run out, needs the store to confirm the new price: ready/ then answers 409 price_changed with old_fee and new_fee (Approve and ready).

Stores with their own prices#

A store can set its own delivery prices by area on the store portal (Delivery prices). Then quotes/ answers the store's price with "priced_by": "store", and the order is charged that price. A place outside the store's list answers not_offered: tell the customer the shop doesn't deliver there. GET stores/pricing/ shows which way the store prices.

Errors#

CodeMeaning
address_not_foundDropoint couldn't find the address. Send a pin (lat, lng) or an area.
not_coveredDropoint doesn't deliver there yet.
not_offeredThe store doesn't deliver there (own prices).
vehicle_not_availableNo such vehicle for this parcel; vehicles lists the ones that work.
no_pickupThe store has no pickup point yet.
quote_limitToo many prices today (429).
Base address: https://api.dropoint.co.ke/api/integrations/v1 · Questions? Use Support on the store portal.