Lalamove: on-demand delivery with map points
Connect Lalamove for on-demand delivery with a quote and a driver. Bangladesh is not an Open API market unless Lalamove enabled it for you. Fields, map points, no cash on delivery and common errors.
Lalamove is different from the other couriers: it is on-demand delivery priced by distance, it cannot collect cash, and it works in Bangladesh only if Lalamove enabled its API for your account.
What it is#
Lalamove is an on-demand delivery service. You ask for a quote, place the order, and follow the driver. It suits deliveries of orders that are already paid and need a driver quickly.
What you need#
- A Lalamove partner account with API access for your market. Bangladesh is not listed among the countries for which Lalamove opens its API, so check with Lalamove that your account has API access. There is no cash on delivery.
- Fields in Jukto:
| Field in Jukto | What it is |
|---|---|
| API key | From the Lalamove partner (developer) portal |
| API secret | From the same portal (a secret) |
| Market | The market code Lalamove enabled for your key. Required |
Where to find your keys#
- 1
Open the partner portal
Sign in to the Lalamove partner (developer) portal for your account. If you cannot find API keys, ask Lalamove to enable the Open API for your account.
- 2
Copy the key and the secret
Copy the API key and the API secret. Sandbox and live have different pairs.
- 3
Choose the market
Choose the Market code that Lalamove enabled for your key. Choose BD only if Lalamove confirmed it.
- 4
Match the mode
Choose Sandbox (testing) or Live to match the pair.
What Jukto does#
- Keys. Saved encrypted for this website only.
- Map points. Lalamove prices by place on the map. The Courier card shows Map points (Lalamove): type the Pickup address, the Pickup latitude and longitude, and the Buyer latitude and longitude.
- Quote. Get the price asks Lalamove for a quotation. It shows the delivery charge and how long the quotation is valid ("Valid until").
- Booking. Book with this courier places the Lalamove order from the quotation and saves the order ID and tracking on the order. You can follow the driver there.
- No cash on delivery. Lalamove cannot collect cash. Jukto refuses a booking with cash to collect above 0: "Lalamove cannot collect cash on delivery; book it only for an order that is already paid".
- Status and webhook. Jukto reads open parcels every 15 minutes, or at once with Check status now. Lalamove sets one webhook address per key: ask Lalamove to use the Webhook address from the provider page. Calls are checked with your API secret.
- Cancel. Cancel booking on the order also cancels the order at Lalamove.
Text version of the diagram
- Enter the map points to Get the price (quotation)
- Get the price (quotation) to Order already paid?
- Order already paid? to Book with this courier (Yes)
- Order already paid? to Cash to collect must be 0 (No)
- Book with this courier to Follow the driver
Test and turn on#
- 1
Open the provider
Go to Dashboard > Tools > Integrations, open the Couriers group and choose Lalamove.
- 2
Choose the mode and fill the fields
Pick Sandbox (testing) or Live, fill API key, API secret and Market, then press Save.
- 3
Press Test connection
Jukto signs a request and asks Lalamove for its cities. You see "Lalamove accepted the keys" with the mode, the market and the number of cities.
- 4
Press Turn on
Pick the map points on an order that is already paid, press Get the price, then Book with this courier.
Common errors#
| What you see | What it means | What to do |
|---|---|---|
| Fill in: API key, API secret, Market | A required field is empty | Fill all three and save |
| Lalamove: the courier did not accept the saved keys (401) | The pair is wrong, or the market or mode does not match | Re-check the pair, the market and the mode with Lalamove |
| Lalamove needs the pickup and drop-off map points | Latitude and longitude are missing | Fill the map points on the Courier card |
| Lalamove cannot collect cash on delivery; book it only for an order that is already paid | Cash to collect is above 0 | Book only paid orders, with cash to collect at 0 |
| Lalamove answered without a quotation | Lalamove gave no price | Check the points and the market, then try again |
| Lalamove answered without stop ids | The quotation was incomplete | Get the price again |
| Lalamove answered without an order id | Lalamove did not create the order | Try again; ask Lalamove if it repeats |
| the courier did not answer in time; try again in a moment | Lalamove was slow | Try again in a minute |
Next#
- Couriers overview
- Steadfast or Pathao Courier: couriers with cash on delivery.
- Book a courier

Comments (0)
Anyone can comment. Please do not post phone numbers, passwords or customer details.