Help Center
Help Center›Shipping

How to Connect Your Own Lalamove Account

Updated
Feature Availability User Permissions Time to Complete Skill Level
Philippine stores on Launch, Grow, Scale and the free trial Store owner, or a team member with Store settings & administration access About 15 minutes Intermediate

Summary

Overview: If you have your own Lalamove business account, you can connect it with your Lalamove API keys. Your Same Day Delivery orders are then quoted, booked and billed on your own Lalamove account and your negotiated rates, instead of Prosperna's. Customers stop paying Prosperna's 3% service fee, and you can set your own markup or flat rates. If you leave this disconnected, your store keeps using the Prosperna-managed Lalamove account.

Prerequisites:

  • A Philippine store on Launch, Grow, Scale or the free trial.
  • Store owner access, or a team member with Store settings & administration access.
  • Your own Lalamove account with API access: its API Key (Public Key) (starts with pk_) and its Secret Key.
  • Enough balance in your Lalamove wallet to pay for deliveries.
  • Check whether your Lalamove account already sends delivery updates (webhooks) to another system. Connecting replaces that address (see Step 2).
  • Same Day Delivery activated, set up, switched on and given a pickup address. See "How to Ship with Prosperna's Courier Partners". You can connect your keys before or after this, but Lalamove won't appear at checkout until it's done.

Step-by-Step Instructions

Step 1: Open the Lalamove connection section

  1. In the sidebar, click Settings, then Shipping.

  2. Scroll below the shipping cards to Connect your own Lalamove account.

  3. If you see Before your customers can see Lalamove, follow its three items on the Same Day Delivery card. Each item gets a tick when it's done, and the box disappears once all three are finished:

    1. Activate Lalamove.
    2. Open Set Up and add your pickup address, the address couriers collect your packages from.
    3. Switch on Same Day Delivery. The switch appears on the card once you've saved step 2.

    The pickup address section only appears after Same Day Delivery is switched on. So save the Set Up page first, switch the method on, then click Manage to add the pickup address.

Step 2: Connect your API keys

  1. Paste your public key into API Key (Public Key).
  2. Paste your secret key into Secret Key.
  3. Read the notes below the fields:
    • Prosperna makes a live test call to Lalamove to check your keys before saving them.
    • Prosperna also registers a delivery-status webhook on your Lalamove account, so your orders update on their own. If you already use Lalamove webhooks for another system, this replaces that address.
  4. Click Connect.
  5. When it works, you see Lalamove account connected and webhook registered. If you see only Lalamove account connected., your keys are saved but the webhook couldn't be set. See Step 4.

Step 3: Check your connection

After you connect, the section shows:

  • a Connected badge and Your API keys are verified and in use.
  • Public key: with the key you connected. Your secret key is never shown again.
  • Delivery status updates, with a badge:
    • Waiting for first delivery: "No delivery updates received yet. This is normal until your first booking." Click Check again after your first delivery.
    • Updates on: shows Last delivery update received with the date and time. Click Refresh to update it. If no deliveries are in progress, the time doesn't move, and that's normal.
  • Delivery rates: a reminder that you don't need to set rates (see Step 5).

Step 4: Set the webhook by hand (only if updates never arrive)

You normally don't need this. Use it only if your deliveries never update after your first booking.

  1. While the badge shows Waiting for first delivery, click Updates never arrive? Set the webhook manually.
  2. Next to Webhook URL, click Copy. You see Webhook URL copied to clipboard.
  3. Click Lalamove webhook settings to open the Webhooks page of the Lalamove Partner Portal.
  4. Paste the URL there and save.

Step 5: Choose your delivery rates (optional)

By default, customers pay exactly what Lalamove quotes you, without Prosperna's 3% service fee. To change this:

  1. On Settings → Shipping, click Manage on the Same Day Delivery card, then the Rates tab.
  2. Under Who Pays for Shipping?, keep Customer.
  3. Under Shipping Fee Calculation, choose one of these and click Confirm in the Warning window:
    • Auto-Calculated by Courier: the customer pays Lalamove's quote.
    • Courier Quote + Your Add-ons: Lalamove's quote plus a Markup % (0 to 100) and an extra fee you set per province. Type the markup and click outside the box to save it.
    • Flat Shipping Fee: your own rates replace Lalamove's quote.

For how to set per-province fees and flat rates, see "How to Set Up Manual Shipping and Shipping Rates".

Step 6: Book and pay for deliveries

You book Same Day Delivery orders the same way as before: open the order and click Book a Rider (see "How to Ship with Prosperna's Courier Partners").

What changes once you're connected:

  • The quote and the booking use your own Lalamove account, and Lalamove charges your Lalamove wallet.
  • These bookings never use Prosperna's Shipping Credits.

Step 7: Disconnect your Lalamove account (optional)

  1. In Connect your own Lalamove account, click Disconnect.
  2. In the Disconnect Lalamove account window, read the message: your store goes back to the Prosperna-managed Lalamove account for quoting, booking and billing, and your API keys are removed.
  3. Click Disconnect. You see Lalamove account disconnected.

You can connect again at any time by repeating Step 2.

Verify It Worked

Success criteria:

  • You saw Lalamove account connected and webhook registered. (or Lalamove account connected.).
  • The section shows the Connected badge and your Public key.
  • On the Same Day Delivery card's Rates tab, the options now include Courier Quote + Your Add-ons and Flat Shipping Fee.
  • After your first booking, Delivery status updates changes to Updates on.

Troubleshooting

Common errors

  • "Please enter both your Lalamove API key and secret key.": one of the boxes is empty. Fill in both and click Connect again.
  • An error from Lalamove when you click Connect: Lalamove didn't accept the keys, and nothing was saved. Copy both keys again, check that they belong to the same Lalamove account, and try again.
  • "This Lalamove account is already connected to another store.": a Lalamove account can be connected to only one Prosperna store. Use a different Lalamove account.
  • "This Lalamove account is already connected to your store "…". Disconnect it there first.": the account is connected to another store you own. Disconnect it in that store, then connect it here.
  • "Failed to connect your Lalamove account.": the connection didn't go through. Try again.
  • "Could not copy. Please copy it manually.": your browser blocked copying. Select the Webhook URL and copy it yourself.
  • "Failed to disconnect.": the account wasn't disconnected. Try again.
  • "Lalamove is temporarily unavailable. System maintenance ongoing. We will be back shortly." on the Same Day Delivery card or an order: after you connect, this also appears when your own Lalamove wallet balance has run out. Top up your Lalamove wallet, then try booking again.
  • Lalamove doesn't appear at checkout: finish the three items in Before your customers can see Lalamove (Step 1). Also check the customer's address: Same Day Delivery only serves Metro Manila, Cavite, Laguna, Bulacan, Rizal, Cebu and Pampanga, in the same service area as your pickup address.
  • "Please select at least one payment option." when you save Same Day Delivery: on that page, Same Day Delivery only allows Credit Card and E-Wallets, so the other options are greyed out. If every option is greyed out, contact support.

Limitations & considerations

  • Only Philippine stores can connect a Lalamove account.
  • Connecting replaces the webhook address on your Lalamove account. Another system that uses the same Lalamove account stops getting delivery updates.
  • Courier Quote + Your Add-ons and Flat Shipping Fee are only offered while your own Lalamove account is connected.
  • Any difference between what you charge customers and what Lalamove bills you is yours. Lalamove bills your own account directly.

Next Steps & Related Resources

Need more help? For more information and assistance, please send an email to support@prosperna.com.

Last Updated: 10/09/2026