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, lng | or | The drop-off pin. Best. |
address | or | Text Dropoint finds on the map. |
area | A Dropoint area name, e.g. Kilimani. Used when there's no pin or address. | |
size | optional | small (default), or another parcel size the store uses. |
vehicle_type | optional | motorcycle (default), car, van… |
branch_id | optional | The 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#
| Code | Meaning |
|---|---|
address_not_found | Dropoint couldn't find the address. Send a pin (lat, lng) or an area. |
not_covered | Dropoint doesn't deliver there yet. |
not_offered | The store doesn't deliver there (own prices). |
vehicle_not_available | No such vehicle for this parcel; vehicles lists the ones that work. |
no_pickup | The store has no pickup point yet. |
quote_limit | Too many prices today (429). |