Title: Kargomucuz Shipping for WooCommerce
Author: xristal
Published: <strong>November 3, 2026</strong>
Last modified: November 3, 2026

---

Search plugins

![](https://ps.w.org/kargomucuz-shipping-for-woocommerce/assets/banner-772x250.png?
rev=3781076)

![](https://ps.w.org/kargomucuz-shipping-for-woocommerce/assets/icon-256x256.png?
rev=3781076)

# Kargomucuz Shipping for WooCommerce

 By [xristal](https://profiles.wordpress.org/xristal/)

[Download](https://downloads.wordpress.org/plugin/kargomucuz-shipping-for-woocommerce.2.6.1.zip)

 * [Details](https://wordpress.org/plugins/kargomucuz-shipping-for-woocommerce/#description)
 * [Reviews](https://wordpress.org/plugins/kargomucuz-shipping-for-woocommerce/#reviews)
 *  [Installation](https://wordpress.org/plugins/kargomucuz-shipping-for-woocommerce/#installation)
 * [Development](https://wordpress.org/plugins/kargomucuz-shipping-for-woocommerce/#developers)

 [Support](https://wordpress.org/support/plugin/kargomucuz-shipping-for-woocommerce/)

## Description

Kargomucuz Shipping for WooCommerce connects your store to the Kargomucuz shipping
service (Turkey). Orders are sent to the carrier you choose with one click or automatically,
and shipment status, tracking numbers and labels are kept in sync with WooCommerce.

**Features**

 * Manual (single or bulk) and automatic order transfer. Automatic transfer runs
   in the background when an order becomes Processing and retries failed transfers.
 * Choice of the carrier services that are active on your Kargomucuz account.
 * Desi calculation from product dimensions and weight, with a fallback value and
   a per-order override.
 * Cash on delivery (corporate Kargomucuz accounts only): the order total is collected
   by the carrier.
 * Province, district and neighbourhood selection for Turkish addresses on the classic
   and block checkout.
 * Shipment status sync every 15 minutes; delivered orders can be completed automatically
   and customers receive their tracking number by email.
 * Printable shipping label with barcode, tracking links for customers and the “
   My account” page.
 * Wallet balance and debt overview, with debt payment from the wallet balance.
 * Compatible with WooCommerce High-Performance Order Storage and the checkout block.

The plugin requires a Kargomucuz account and an API token created in the account’s
developer settings.

#### External service and data disclosure

This plugin relies on the Kargomucuz API (https://api.kargomucuz.com/), a third-
party service operated by Kargomucuz.

 * When an administrator connects an account, the API token is validated with the
   API and stored in the WordPress options table.
 * When an order is transferred, the recipient name, address, telephone number, 
   email address, package desi/weight and, for cash on delivery orders, the order
   total are sent to the API.
 * The checkout page requests the district and neighbourhood lists for the selected
   province from the API through the site’s own server; no customer data is sent
   with these requests.
 * The plugin requests the account name, wallet balance, debt, active carrier services
   and shipment status, and submits a debt payment only when an administrator requests
   it.
 * Carrier logos shown in the admin screens are loaded from the image addresses 
   returned by the API, which may be hosted by the carriers themselves.

Service: https://kargomucuz.com/
 Sign up: https://auth.kargomucuz.com/sign-up/ 
Contact: https://kargomucuz.com/iletisim API: https://api.kargomucuz.com/ Privacy
policy: https://kargomucuz.com/gizlilik-politikasi Terms of use: https://kargomucuz.
com/kullanim-kosullari

## Installation

 1. Install and activate WooCommerce.
 2. Upload and activate this plugin.
 3. In your Kargomucuz account, open your profile photo, Account Settings, Developer
    Tools, API Token Management, then create a new token with the permissions needed
    for shipments, addresses, account and payments. Leave the expiry field blank if
    you want a token without an expiry.
 4. Open the Kargomucuz menu in WordPress and paste the token. The plugin verifies 
    it before saving it.
 5. Save your sender address, choose a carrier and the transfer mode under Kargomucuz
    > Settings.

## FAQ

### Is a Kargomucuz account required?

Yes. Shipment, label, wallet and debt operations are provided by the Kargomucuz 
service.

### What happens when the wallet balance is lower than the debt?

The debt payment action submits the amount currently available in the wallet. Any
remaining debt stays visible in the panel.

### How often are shipment statuses checked?

Every 15 minutes with WP-Cron. If your server cannot run WP-Cron (for example when
loopback requests are blocked), the plugin runs the check during admin page visits
and the settings page shows a server cron command you can add.

### Which payment methods are treated as cash on delivery?

WooCommerce’s “Cash on delivery” method. Cash on delivery is available only for 
corporate Kargomucuz accounts. Other gateways can be added with the `kargomucuz_cod_payment_methods`
filter.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Kargomucuz Shipping for WooCommerce” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ xristal ](https://profiles.wordpress.org/xristal/)

[Translate “Kargomucuz Shipping for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/kargomucuz-shipping-for-woocommerce)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/kargomucuz-shipping-for-woocommerce/),
check out the [SVN repository](https://plugins.svn.wordpress.org/kargomucuz-shipping-for-woocommerce/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/kargomucuz-shipping-for-woocommerce/)
by [RSS](https://plugins.trac.wordpress.org/log/kargomucuz-shipping-for-woocommerce/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 2.6.1

 * All admin scripts and styles are now enqueued; no inline script or style blocks.
 * The checkout no longer contacts the Kargomucuz API until an administrator has
   connected an account.
 * Moved the admin menu below the WooCommerce section.
 * Removed unused settings registrations and an unused admin-post handler.

#### 2.6.0

 * Fixed a fatal error after the first transfer of a new order.
 * Fixed shipment status sync: delivered, returned and cancelled shipments are no
   longer polled forever; delivered orders can be completed automatically.
 * Fixed desi calculation: product dimensions and weights are converted to cm/kg,
   the “per order” fallback desi works, virtual and refunded items are skipped, 
   and a per-order desi can be entered on the order screen.
 * Automatic transfer now runs in the background when an order becomes Processing(
   or On hold when unpaid orders are allowed), never twice, and retries at most 
   3 times with an order note on failure.
 * Cash on delivery orders are sent with the order total to be collected by the 
   carrier (can be turned off).
 * The shipping company list now shows the services active on your Kargomucuz account.
 * Added a Kargomucuz box to the order screen: neighbourhood selection, desi, single-
   order transfer, status refresh and a printable label with barcode.
 * Added the neighbourhood field and phone validation to the block checkout.
 * Transfers no longer stop when the neighbourhood service is unavailable; the address
   is sent without it and an order note is added.
 * Clear error messages from the Kargomucuz API are shown on the order and in bulk
   transfer.
 * Declared compatibility with WooCommerce HPOS and checkout blocks.
 * New admin design matching the Kargomucuz panel: card layout, order filters and
   search, sticky bulk transfer bar, responsive on mobile. The admin menu is now
   labelled “Kargomucuz”.
 * Shipment status sync now also runs when WordPress cron cannot reach the site (
   loopback blocked).

#### 2.5.0

 * Added district and neighbourhood selection to the checkout and My Account address
   forms for Turkish addresses.
 * Added neighbourhood selection to the sender address settings.
 * Sender and receiver addresses now send the selected neighbourhood to Kargomucuz,
   which is now required.

#### 2.4.2

 * Show the last automatic shipment check and the next scheduled check in plugin
   settings.
 * Retry eligible failed orders even when no active shipments need status updates.

#### 2.4.1

 * Removed webhook registration guidance and the incoming webhook endpoint.
 * Kept scheduled shipment status checks at 15-minute intervals.

#### 2.4.0

 * Replaced username and password sign-in with a validated Bearer API token.
 * Removed stored legacy session credentials and switched all API calls to token
   authorization.
 * Updated registration and contact links, and improved WordPress database query
   compatibility.

#### 2.3.0

 * Added wallet balance and debt display and administrator initiated debt payments.
 * Added capability and nonce checks for administration actions.
 * Removed sensitive request and response logging and external font loading.
 * Fixed WooCommerce dependency metadata and scheduled status checks.

## Meta

 *  Version **2.6.1**
 *  Last updated **1 day ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.2 or higher **
 *  Tested up to **7.1.4**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [cash on delivery](https://wordpress.org/plugins/tags/cash-on-delivery/)[kargo](https://wordpress.org/plugins/tags/kargo/)
   [shipment tracking](https://wordpress.org/plugins/tags/shipment-tracking/)[shipping](https://wordpress.org/plugins/tags/shipping/)
   [woocommerce](https://wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://wordpress.org/plugins/kargomucuz-shipping-for-woocommerce/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/kargomucuz-shipping-for-woocommerce/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/kargomucuz-shipping-for-woocommerce/reviews/)

## Contributors

 *   [ xristal ](https://profiles.wordpress.org/xristal/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/kargomucuz-shipping-for-woocommerce/)