Shipping integration
MNG Kargo
What it does
- Creates MNG shipments over the REST API and returns label, barcode, and tracking number to the order.
- Receives delivery status events from MNG by webhook, so orders update without waiting for a polling cycle.
- Sends the cash-on-delivery amount to MNG when the order was placed with COD.
Provider based in Turkey
MNG Kargo is part of Kambloo's launch catalog, in the same group as Sürat, PTT, and HepsiJet. The adapter uses MNG's REST API and, unlike Yurtiçi and Aras, receives status updates by webhook. It is an Internal Module with no charge from Kambloo.
How it works with Kambloo
The adapter implements the shared ShippingCarrier contract, so the order screen looks the same whichever carrier you pick. Confirming an order for dispatch calls createShipment. MNG returns the label, barcode, and tracking number. The label PDF is stored in your bucket and can be printed alone or as part of the day's batch. The tracking number is written to the order and sent to the customer with a tracking link.
Tracking is event-driven. MNG posts each status change to your store's webhook endpoint. Kambloo initialises the tenant context from the URL, verifies the payload signature, stores the raw event with a unique event ID, and hands processing to a queue job. The endpoint answers in under a second. A shipment webhook handler updates the shipment status and the order timeline; a delivered status closes the order and starts the return window. The integration health screen shows the last event received and any recent errors.
Webhooks are primary, not exclusive. The standard tracking job still runs as a safety net for shipments that have not reported in a while, so a missed event cannot leave an order stuck.
Cash on delivery works as with every carrier in the catalog: the amount is passed as an option when the shipment is created, the stock reservation becomes a firm deduction at order time, and collection is confirmed against the carrier's report. Cart pricing comes from your own MNG rate table, computed on desi versus real weight and the origin and destination provinces.
Requirements
- An MNG Kargo customer agreement with REST API access.
- A live store domain so MNG can deliver webhooks.
- Your rate table as CSV, and product dimensions for desi calculation.
Setup steps
The short version. The screens in your store admin follow the same order.
- Install the MNG Kargo module from the Market. It is free.
- Enter your MNG API credentials under Settings > Shipping > MNG Kargo.
- Register your store's webhook URL with MNG so status events reach Kambloo.
- Upload your rate table as CSV and ship a test order.
- Enable MNG for the zones you serve.
Questions about MNG Kargo
What is the advantage of webhook tracking over polling?
Status changes arrive within seconds of MNG recording them, instead of at the next 30-minute poll. Customer notifications go out sooner and the order timeline is more precise.
Is the webhook secure?
Yes. Events land on the central webhook endpoint for your store, the signature is checked before anything is processed, and each event ID is stored once. Repeated deliveries are ignored.
Can I switch a carrier on a single order?
Yes. Cancel the MNG shipment from the order before it is picked up, then create a new shipment with another installed carrier.