Hepsiburada Integration: API, XML, HepsiLojistik and Unified Store Management

About Hepsiburada: Founding, Investors and Market Position

Founding and History (2000 – Today)

Hepsiburada was founded in 2000 in Istanbul by Hanzade Doğan Boyner within Doğan Holding as Turkey's first major online shopping platform. Starting with books, music and electronics in the early 2000s, the platform expanded to every category after 2010. Between 2015 and 2020 it transitioned to a marketplace (3P) model, growing its seller base from 10K to 50K. HepsiJet, its own shipping company, launched in 2017; the HepsiLojistik fulfillment program went live in 2018.

Hepsiburada went public on the NASDAQ exchange under the HEPS ticker on July 1, 2021; its IPO valuation was approximately $3.9 billion — making it the first Turkish technology company to list on a U.S. stock exchange. In 2024, Kaspi.kz (Kazakhstan's largest fintech-marketplace group) acquired a stake as a strategic investor. Today Hepsiburada is a publicly traded technology ecosystem spanning marketplace (3P), first-party retail (1P), HepsiJet shipping, HepsiLojistik fulfillment, HepsiPay payments, HepsiAd advertising and HepsiGlobal cross-border verticals.

Hepsiburada Ownership Structure (2025)

• Doğan Holding (Hanzade Doğan Boyner family) — Principal shareholder (~24%, founding family)
• NASDAQ HEPS — Public float (free float since the 2021 IPO)
• BIST HEPSI — Secondary listing on Borsa Istanbul
• Kaspi.kz — Strategic investor (as of 2024)
• Hanzade Doğan Boyner — Founder and Chair of the Board

Position in Turkish E-Commerce

As of 2024, Hepsiburada holds approximately 18–22% of the Turkish e-commerce market — a clear second place behind Trendyol. It is the category leader in electronics, white goods, phones, computers and technology in particular. 7 out of every 10 Turkish online shoppers have a Hepsiburada account. As the only publicly traded Turkish e-commerce company, it offers a significant source of trust for sellers thanks to its financial transparency.

Hepsiburada Sales Volume and Scale (2024–2025 Data)

Over the past five years, Hepsiburada has shown steady growth as the well-established #2 player in Turkish e-commerce. Gross Merchandise Value (GMV) and order volume have grown 30–50% year over year; its leadership in electronics and technology categories has only strengthened.

Year	GMV (TL)	Active Customers	Active Sellers	Key Milestone
2020	~₺18 billion	10M	32K	2x order growth driven by the pandemic
2022	~₺55 billion	12M	45K	NASDAQ HEPS public listing (2021)
2024	~₺105 billion	13M+	60K+	Kaspi.kz strategic investment
2025 (forecast)	~₺140 billion	15M	75K	Regional cross-border expansion

This growth has been powered by HepsiJet's nationwide same-day/next-day delivery infrastructure, the HepsiLojistik fulfillment program and the Hepsiburada Star Seller program. Becoming a seller on the Hepsiburada marketplace is one of Turkey's most profitable online growth routes — especially in the electronics, technology and premium product categories.

Opening a Hepsiburada Store (2026 Rules and Process)

1. Legal and Financial Requirements

To become a Hepsiburada seller you must have an active tax registration in Turkey. Sole proprietorship, limited or joint-stock company — the legal form doesn't matter; however, you are required to be an e-Invoice taxpayer and able to issue an e-Archive invoice.

• Tax certificate (current year)
• Tax number and TR national ID (for sole proprietorship)
• Trade registry gazette (for Ltd./Inc.)
• Signature circular
• Bank account (IBAN) — payments are transferred to this account
• e-Invoice/e-Archive private integrator or the GİB (Turkish Revenue Administration) portal
• Trademark registration certificate (for protected categories such as cosmetics, food and toys)

2. Applying via the Hepsiburada Seller Panel

You submit your application via partner.hepsiburada.com. The approval process typically takes 3–7 business days. Upon approval you receive your Merchant ID, OAuth2 client_id and client_secret — these credentials are critical for MPOP API integration.

📥 Official Hepsiburada Seller Application partner.hepsiburada.com — free application, 3–7 business days approval →

3. Product Upload and Content Rules

Hepsiburada enforces strict content rules for product listings:

• Title: 50–150 characters, brand + product name + key attribute
• Image: White background, minimum 1000×1000px, max 8 photos, watermark/text forbidden
• Description: HTML supported, minimum 200 characters
• Category mapping: Hepsiburada category ID + attributes (color, size, material)
• Barcode (GTIN/EAN): Mandatory in electronics and technology; significantly increases matching speed
• Content score: Must be 80+; otherwise the product will not appear in the storefront

Hepsiburada Commission Rates (2026)

Hepsiburada 2026 commission rates range between 5% and 22% depending on the category. 20% VAT (KDV), service fees and shipping costs are added on top of commissions. Pricing without running a gross-to-net calculation is the most common mistake sellers make. Below is a clear summary of the three main commission tiers:

Net profit calculation: Sale price − Commission − VAT (KDV) − Service fee − Shipping fee − Cost of goods = Net profit. The Zunapro pricing module runs this calculation automatically for every product and category, ensuring you never sell below your minimum profit threshold.

Hepsiburada API Integration — Technical Details

The Hepsiburada MPOP API (Marketplace Open Platform) is a RESTful interface that enables sellers to programmatically synchronize product, inventory, order, price, shipping and returns data with Hepsiburada systems. API base URL: https://mpop.hepsiburada.com/

API Authentication

The Hepsiburada API uses OAuth2 Bearer Tokens. An access_token is obtained from the token endpoint using client_id and client_secret, then sent in the Authorization: Bearer {token} header. Tokens are valid for 24 hours and are refreshed automatically. Full documentation: developers.hepsiburada.com

Main Endpoint Categories

• Listings API — Product listing, updates, category mapping, content score queries
• Inventory API — Stock and price synchronization (bulk endpoint up to 100 products per request)
• Orders API — Order listing, status updates, package creation
• Shipment API — HepsiJet shipping label creation, tracking number synchronization
• Cancellations API — Querying cancellation and return requests, accept/reject
• Settlements API — Payout, invoice and reconciliation reports
• Webhooks — Real-time callbacks on order and stock changes

Rate Limit and Error Handling

The Hepsiburada API rate limit is 100 requests per minute per seller. When exceeded, it returns 429 Too Many Requests. Common error codes: 400 (invalid product data), 401 (expired token — refresh), 404 (category/barcode not found), 500 (Hepsiburada system error — retry). The Zunapro integrator handles these errors automatically via token refresh, exponential backoff retries and a dead-letter queue.

Hepsiburada XML Integration — Bulk Product Upload

Hepsiburada XML integration is a system that automatically reads the product catalog of your supplier or your own e-commerce site in XML format and pushes it into the Hepsiburada seller panel. As an alternative to manual product creation, it lets you upload thousands of products within minutes.

XML Schema (Hepsiburada-Compatible)

Core fields for XML to be uploaded to Hepsiburada:

• HepsiburadaSku — Master product code (groups variants)
• productId, brand, productName, merchantSku, barcode
• categoryId (Hepsiburada category), attributes (color, size, material)
• availableStock (stock), price, listPrice, vatRate
• dispatchTime, shippingAddressId
• images (1–8 URLs), description (HTML)

From Supplier XML to Hepsiburada

Most Turkish wholesalers/suppliers (especially electronics, white goods and phone distributors in Karaköy/Sirkeci and technology wholesalers in İstoç) share their product catalogs as XML. The Zunapro XML module:

1. Reads the supplier XML URL (hourly/daily cron)
2. Learns category mapping (manual on first match, then automatic)
3. Normalizes attributes such as brand, material and size
4. Adds your profit margin + commission to the price
5. Tracks stock — automatically deactivates products that are out of stock at the supplier
6. Uploads to Hepsiburada via the MPOP API

HepsiLojistik (Hepsiburada Fulfillment) — The Logistics Solution

HepsiLojistik is a service in which storage, packaging, shipping and returns management are fully handled by Hepsiburada once you deliver your products to Hepsiburada warehouses. Think of it as the Hepsiburada version of Amazon FBA; it works in tandem with HepsiJet shipping priority.

HepsiLojistik Advantages

• Same-day / next-day shipping — HepsiJet priority
• Higher Buy Box chance — Products with the HepsiLojistik badge surface more often
• Hepsiburada handles customer service — returns, exchanges, complaints
• "Fast Delivery" badge — increases conversion rate by 15–25%
• Zero operational burden — you don't pack or ship

HepsiLojistik Costs (2025, approximate)

• Storage: ₺70–130 per m³/month
• Order handling: ₺5–10 per product
• Return handling: ₺7–12 per return
• Commission: Standard Hepsiburada commission + 1–2% HepsiLojistik fee

HepsiLojistik becomes cost-effective for sellers with 500+ monthly orders. Low-volume sellers should prefer shipping from their own warehouse.

Hepsiburada Store Performance Score and Cancellation Rates

Hepsiburada assigns each seller a store score between 1 and 10; this score directly affects storefront visibility. To qualify for the Hepsiburada Star Seller program, you need a score of 8.5+. The main factors that lower the score:

• Cancellation rate — Out-of-stock cancellations are the biggest penalty; above 2% triggers a warning, above 5% risks store closure
• Late shipping — Orders not shipped within the handling window (dispatchTime)
• Return rate — Returns above expectations (5–10% is natural in electronics, 25%+ in fashion)
• Customer reviews — Must not drop below 4.0 stars
• Response time — Messages must be answered within 24 hours

With Zunapro automatic stock synchronization, you reduce your cancellation risk by 90%; products sold on your site, in the warehouse or on another marketplace are instantly deactivated on Hepsiburada, preserving your Star Seller status.

Hepsiburada Advertising, Promotions and Smart Pricing

Hepsiburada Advertising Platform (HepsiAd)

• Sponsored Products — Top positions in search results (CPC-based, ₺/click)
• HepsiAd Smart Ads — Algorithmic budget optimization
• Banner / Display ads — Homepage and category banner placements
• HepsiLojistik promotions — Discount campaigns for products with the Fast Delivery badge

Smart Price (Repricer)

The Buy Box battle on Hepsiburada is especially intense in the electronics category. When 10+ sellers offer the same product, the one with the lowest price (or highest store score) wins the Buy Box. The Zunapro Smart Price (repricer) module automatically adjusts your prices against competitors within seconds — and never drops below your minimum profit threshold.

Hepsiburada E-Invoice and E-Archive Integration (GİB Compliance)

All sellers on Hepsiburada are required to issue an e-Archive invoice to B2C customers and an e-Invoice to B2B customers (per GİB — Turkish Revenue Administration — regulation). Issuing invoices manually is not feasible at 100+ orders per day.

The Zunapro e-Invoice module:

• Automatically issues an e-Archive/e-Invoice the moment a Hepsiburada order arrives
• Connects to GİB-approved private integrators (Logo, Mikro, Uyumsoft, Foriba, Veriban, etc.)
• Automatic refund invoice on returns
• Monthly KDV1 and KDV2 (VAT) reporting
• Automatic PDF e-Archive delivery to customers via email + SMS

Hepsiburada Shipping Integration — HepsiJet + Others

By default, Hepsiburada orders are shipped via HepsiJet (Hepsiburada's own carrier, with same-day/next-day delivery across all 81 provinces in Turkey). Additionally: Yurtiçi Kargo, Aras Kargo, MNG Kargo, Sürat Kargo and PTT Kargo can be integrated.

The Zunapro multi-carrier module automatically selects the best carrier based on order weight, destination city and customer preference; it prints labels and automatically pushes tracking numbers to Hepsiburada. A dedicated API endpoint is used for HepsiJet specifically.

Hepsiburada Returns and Customer Service Management

In Turkish e-commerce, return rates are 25–35% in fashion, 5–10% in electronics and 10–15% in home & living. Mishandling the returns process drops your store score and risks losing Star Seller status.

Hepsiburada standard returns process:

1. The customer opens a return request from the Hepsiburada panel (within 14 days of delivery)
2. HepsiJet picks up the product free of charge (1–3 business days)
3. The Hepsiburada warehouse inspects the product and either forwards it to the seller or approves the return
4. The seller approves or rejects the return within 1–3 business days
5. If approved, the customer is refunded to their HepsiPay wallet

The Zunapro returns module tracks every step automatically; it sends in-panel notifications to the seller and issues automatic refund invoices for customer returns.

Hepsiburada Integration with Zunapro — 4-Step Setup (10 Minutes)

1. Enter Your Hepsiburada Store Details — In the Zunapro panel, go to Marketplace → Hepsiburada and enter your Merchant ID, OAuth2 client_id and client_secret.
2. Connect Your Existing Site — Ready-made connectors for Shopify, WooCommerce, OpenCart, İkas, Ticimax, PrestaShop and Magento. Enter the API URL + access key.
3. Category Mapping Wizard — Map your site's categories to Hepsiburada categories with drag-and-drop. AI suggestions complete the work within minutes.
4. Initial Synchronization — Products, inventory, prices, orders and shipping — all sync automatically. Within 10 minutes, your Hepsiburada store is fully manageable from the Zunapro panel.

Frequently Asked Questions About Hepsiburada Integration (FAQ)