Shipping integration

HepsiJet

What it does

  • Creates HepsiJet shipments over the REST API and returns label, barcode, and tracking number.
  • Receives status changes from HepsiJet by webhook and updates the order and the customer at once.
  • Passes the cash-on-delivery amount to HepsiJet for COD orders.

Provider based in Turkey

HepsiJet is part of Kambloo's launch catalog. It connects through a REST API and reports status changes by webhook, which puts it in the same technical group as MNG. The adapter is an Internal Module. You ship under your own HepsiJet agreement and Kambloo charges nothing for the connection.

How it works with Kambloo

Shipment creation is a single call from the order. Kambloo sends the recipient and parcel details to HepsiJet and receives a label, barcode, and tracking number. The PDF is stored in your bucket for single or batch printing, and the tracking number is saved on the order and sent to the customer with a link through the notification channel you configured.

Status tracking is push-based. HepsiJet posts each event to the central webhook endpoint for your store. Kambloo resolves the store from the URL, verifies the signature, records the raw event under a unique ID, and returns 200 in under a second. Processing happens in a queue job that updates the shipment and the order timeline. A delivered event closes the order and starts the return window. The tracking job still runs as a backstop, so a lost webhook cannot leave a shipment without a status.

Every outbound request to HepsiJet carries an idempotency key. A retry after a timeout does not create a second shipment. Failed jobs retry with backoff and, after the final attempt, show up on the integration health screen with the last error so your team can act.

Cash on delivery follows the platform pattern: the amount is passed at creation, stock is deducted firmly at order time, and collection is confirmed against HepsiJet's report. Cart prices come from your uploaded HepsiJet rate table using desi or real weight and the origin and destination provinces.

Requirements

  • A HepsiJet customer agreement with REST API access.
  • A live store domain reachable by HepsiJet webhooks.
  • Your rate table as CSV and product dimensions for pricing.

Setup steps

The short version. The screens in your store admin follow the same order.

  1. Install the HepsiJet module from the Market. It is free.
  2. Enter your HepsiJet API credentials under Settings > Shipping > HepsiJet.
  3. Register your store's webhook URL with HepsiJet.
  4. Upload your rate table and ship a test order.
  5. Enable HepsiJet for your zones.

Questions about HepsiJet

Do I need a HepsiJet contract to use this module?

Yes. The module connects your own HepsiJet account. Kambloo does not resell HepsiJet shipping.

How are webhook events protected?

Each event hits your store's central webhook endpoint, the signature is verified before processing, and the event ID is stored uniquely. Repeated deliveries do not trigger a second update.

Does HepsiJet work with cash on delivery?

Yes. The collection amount is included when the shipment is created and collection is confirmed against HepsiJet's report in the admin panel.

All integrations

Connect HepsiJet to a free test store

The test store runs the complete software with sandbox payments. Paste your credentials, place a test order and go live when it works.

Start free

Free software forever · No credit card · First month of hosting free