Sell your CS-Cart or Multi-Vendor catalog on Hepsiburada: mapping, price rules, stock and price sync, order import and claims in one add-on.
Tested on 2 buildsUpdated Nov 6, 2026Version 1.0.0CS-Cart, Multi-Vendor 4.17.2 – 4.21.x No core file edits
Built for
Hepsiburada Marketplace Connector: Import products, sync stock and price and import orders and claims from your own Hepsiburada merchant account1 of 9
What it does
Hepsiburada is a large online marketplace in Turkey. If you run a CS-Cart or Multi-Vendor store and want Hepsiburada as an extra sales channel, this add-on connects your merchant account to your shop. Each vendor of a marketplace can connect an own merchant account, or the owner can use one account for all. Test access needs your server IP address registered at Hepsiburada.
How it works
Enter your merchant ID, API user, password and integrator name, then test the connection. Map categories and attributes, set markup and stock buffer. The sync imports products, reads the status per product and uploads stock and price. Orders and claims are imported; packing, the invoice link and own-carrier tracking are reported back. Failed jobs retry by themselves and stay visible in the log.
Features
Credentials stored encrypted, separate test and live mode, one-click connection test
Job queue with automatic retries and a log with filters and CSV export
Works with cron (command line or secret address), no long requests during checkout
Multi-Vendor: one marketplace account or one account per vendor
Category and attribute mapping from the Hepsiburada category list, with a markup and a brand per category
Product import with the status and the reason per product, retry in one click
Order import with buyer, delivery and invoice address, company and tax number, prices as sold, status mapping
Packing, an invoice link and own-carrier tracking reported to Hepsiburada
Claims imported and approvable as refunds, cancellation of order lines
No webhook to open: the add-on polls and retries failed imports hourly
What you get
Package
kv_hepsiburada-1.0.0.zip, installed through Add-ons → Manage add-ons
Updates & support
12 months included. Download new versions from your account and install them in Add-ons → Manage add-ons or the Upgrade Center.
License
1 production installation. Staging, dev and localhost are free and unlimited. The add-on keeps working after the update period ends. How licensing works
Compatibility
We list only the builds we install and test on. “Tested” means the full test plan was run on that build; “Supported” means the build is inside the supported range and uses the same hooks.
CS-Cart version and edition compatibility
CS-Cart version
CS-Cart
CS-Cart Ultimate
Multi-Vendor
Multi-Vendor Ultimate
4.22 and later
Testing next
Testing next
Testing next
Testing next
4.21.2
Supported
Supported
Supported
Supported
4.20.x
Supported
Supported
Supported
Supported
4.19.x
Supported
Supported
Supported
Supported
4.18.x
Supported
Supported
Supported
Supported
4.17.2
Supported
Supported
Tested
Supported
Before 4.17.2
Not supported
Not supported
Not supported
Not supported
Last tested build: Multi-Vendor 4.17.2, Nov 6, 2026Tested on: Multi-Vendor 4.17.2
Requirements
Platform
CS-Cart and Multi-Vendor 4.17.2 or later (4.21.x supported)
Requirement
Administrator access to the store's admin panel
Requirement
A Hepsiburada merchant account with API access: the merchant ID, the API user and API password of your integration, and the integrator name Hepsiburada registered for it (merchant panel, integration settings)
Requirement
Products with images that are reachable from the internet (Hepsiburada downloads them)
Requirement
A public https address for your store (Hepsiburada downloads the invoice from a link on your store)
Requirement
A cron job on your server (see step 5)
Requirement
Optional, for test mode: Hepsiburada's test environment (SIT). Test access needs a test merchant account and the static IP address of your server registered at Hepsiburada (see "Test mode" below)
Core changes
None. Hooks and template overrides only
1.0.0
Nov 6, 2026
Latest
Added 7
Initial release on the Marketplace Hub.
Connection page with encrypted credentials (API user and password, merchant ID, integrator name), test and live mode and a connection test.
Category and attribute mapping from the Hepsiburada category list, price rules, stock buffer, product import with the status per product, stock and price uploads with the result per item.
Order import (buyer, addresses, prices as sold, company and tax number), status follow, packing, a signed HTML invoice link for Hepsiburada to download, own-carrier tracking, line cancellation.
Claims import and refund approval.
Job queue with retries and back-off, cron (command line and secret address), log viewer with CSV export.
Multi-Vendor: marketplace owner mode or one merchant account per vendor.
Tested on Multi-Vendor 4.17.2. First release.
Does it work with CS-Cart and Multi-Vendor?
Yes. The add-on supports CS-Cart and Multi-Vendor. In Multi-Vendor the marketplace owner can use one Hepsiburada account for everyone or let each vendor connect their own.
Which CS-Cart versions are supported?
4.17.2 to 4.21.x.
Where are my credentials stored?
In your own database, encrypted. The key is derived from your store's secret in config.php, so a database dump alone does not reveal them. They are never shown again after saving.
Does it send data to Kavio Labs?
No. The add-on talks to Hepsiburada only. The license check sends your domain name to the Kavio Labs license server once a day (Kavio Labs downloads).
Does it need a webhook?
No. The add-on polls Hepsiburada on every sync interval, so no inbound address has to be opened (the invoice link is the only public page, signed per order).
What happens when Hepsiburada is down?
Jobs fail, wait and are retried automatically (5 minutes up to 12 hours). Nothing is lost and nothing is sent twice.
What happens when the license expires?
New work stops (no new syncs or shipment steps). Work already under way is still finished.
How do I get updates?
Install the new package over the old one. See Installation.
Multichannel Product FeedsProduct feeds for Meta, TikTok, Pinterest, Microsoft Shopping, Snapchat, Criteo and idealo, validated before the channel sees them.
$79
Buy with confidence
What stands behind your license
Tested builds
This product was tested on these builds. Builds we did not test are not listed.
CS-Cart4.17.2
Multi-Vendor4.17.2
12 months of updates
Updates and support are included in the price. The product keeps working afterwards; renewing is optional.