Trendyol Integration: API, XML, Fulfillment, and Single-Panel Store Management

About Trendyol: Founding, Investors, and Market Position

Founding and History (2010 – Today)

Trendyol was founded in 2010 in Istanbul by Harvard Business School graduate Demet Mutlu as a fashion-focused discount and members-club model. Its first investor was Tiger Global Management. Between 2011 and 2017, it became the largest player in online clothing sales in Turkey. In 2018, Alibaba Group acquired a majority stake in Trendyol for roughly $750 million — one of the largest investments in Turkish tech history.

In 2021, in a $1.5 billion funding round led by SoftBank Vision Fund 2, General Atlantic, and Princeville Capital, Trendyol became Turkey's first "decacorn" with a $16.5 billion valuation. Today Trendyol is a multi-vertical technology ecosystem spanning marketplace (3P), private label (1P), Trendyol Express shipping, Trendyol Yemek (food delivery), Trendyol Tickets, Dolap (second-hand), and services.

Trendyol Ownership Structure (2025)

• Alibaba Group — Majority shareholder (≈87%, 2018 acquisition + 2021 add-on)
• General Atlantic — Minority (from the 2021 round)
• SoftBank Vision Fund 2 — Minority
• Princeville Capital, Qatar Investment Authority — Other institutional investors
• Demet Mutlu — Co-founder, strategic advisor

Position in Turkish E-Commerce

As of 2024, Trendyol holds roughly 35-40% of the Turkish e-commerce market, ahead of Hepsiburada, N11, and Amazon.com.tr. Six out of every ten online shoppers in Turkey use Trendyol. Its mobile app is the most downloaded shopping app in the country.

Trendyol Sales Volume and Scale (2024–2025 Data)

Over the last five years, Trendyol has become the engine of Turkish e-commerce. Gross Merchandise Value (GMV) and order volume have grown by 40–60% year over year.

Year	GMV (USD)	Orders	Active Customers	Active Sellers
2020	~$3 billion	220 million	18M	100K
2022	~$6 billion	600 million	26M	170K
2024	~$10 billion	1.5 billion	30M+	230K+
2025 (forecast)	~$13 billion	2 billion	35M	280K

This growth has been driven by Trendyol Express's same-day/next-day delivery infrastructure across Turkey, the personalization algorithm in the mobile app, and the Trendyol Star Seller program. Becoming a seller on the Trendyol marketplace is the fastest online growth path in Turkey.

Opening a Trendyol Store (Current Rules for 2026)

1. Legal and Financial Requirements

To sell on Trendyol you must have active tax registration in Turkey. Sole proprietorship, LLC, or joint-stock company all work — but you must be an e-Invoice taxpayer and able to issue e-Archive invoices.

• Tax certificate (current year)
• Tax number and national ID number (for sole proprietorships)
• Trade registry gazette (for LLC/JSC)
• Signature circular
• Bank account (IBAN) — payouts are deposited here
• e-Invoice/e-Archive private integrator or the GİB (Turkish Revenue Administration) portal
• Trademark registration certificate (in protected categories such as cosmetics, food, and toys)

2. Applying to the Trendyol Seller Panel

You submit your application via partner.trendyol.com. Approval typically takes 3–7 business days. After approval, you receive a Store ID (Supplier ID), an API key (apiKey), and an API secret (apiSecret) — these are critical for the integration.

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

3. Product Upload and Content Rules

Trendyol enforces strict content rules for product listings:

• Title: 50–150 characters, brand + product name + key feature
• Imagery: white background, minimum 1000×1000px, up to 8 photos, no watermarks or text
• Description: HTML supported, minimum 200 characters
• Category mapping: Trendyol category ID + attributes (color, size, material)
• Barcode (GTIN/EAN): if available, dramatically speeds up matching
• Content score: must be 80+; otherwise the product won't appear on the storefront

Trendyol Commission Rates (2026)

Trendyol's 2026 commission rates range from 5% to 22.5% depending on the category. 20% KDV (VAT), plus service and shipping fees, are added on top of the commission. Pricing without running a gross-to-net calculation is the most common mistake we see sellers make. Below is a quick breakdown of the three main commission tiers:

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

Trendyol API Integration — Technical Details

The Trendyol API is a RESTful interface that lets sellers programmatically sync product, stock, order, price, shipping, and return data with the Trendyol system. Base URL: https://api.trendyol.com/sapigw/suppliers/{supplierId}/

API Authentication

The Trendyol API uses HTTP Basic Authentication. apiKey:apiSecret is sent Base64-encoded in the Authorization header. Tokens don't expire, but rotating them every 6–12 months is recommended for security.

Main Endpoint Categories

• Products API — Create and update products, map categories, query content score
• Inventory API — Stock and price synchronization (bulk endpoint max 100 products/request)
• Orders API — List orders, update status, create packages
• Shipment API — Create shipping labels, sync tracking numbers
• Claims API — Query return requests, accept or reject
• Settlements API — Payouts, invoicing, and reconciliation
• Webhooks — Real-time callbacks on order and stock changes

Rate Limit and Error Handling

The Trendyol API rate limit is 10 requests per second per seller. When exceeded, it returns 429 Too Many Requests. Common error codes: 400 (invalid product data), 401 (authentication failure), 404 (category/barcode not found), 500 (Trendyol system error — retry). The Zunapro integrator handles these automatically with exponential backoff retries and a dead-letter queue.

Trendyol XML Integration — Bulk Product Transfer

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

XML Schema (Trendyol-Compatible)

Core fields in the XML uploaded to Trendyol:

• productMainId — Parent product code (groups variants)
• brand, title, productCode, stockCode, barcode
• categoryId (Trendyol category), attributes (color, size, material)
• quantity (stock), listPrice, salePrice, vatRate
• cargoCompanyId, shipmentAddressId
• images (1–8 URLs), description (HTML)

Transferring from Supplier XML to Trendyol

Most wholesalers and suppliers in Turkey (especially in the Bursa, Konya, and Istanbul Laleli/Merter districts) share their product catalogs as XML. The Zunapro XML module:

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

Trendyol Fulfillment (TGF / FBT) — Logistics Solution

Trendyol Global Fulfillment (TGF) is a service where, after you deliver your products to Trendyol's warehouses, storage, packing, shipping, and returns management are handled entirely by Trendyol. Think of it as Trendyol's version of Amazon FBA.

TGF Advantages

• Same-day / next-day shipping — Trendyol Express priority
• Higher Buy Box chance — TGF-badged products surface more often on the storefront
• Trendyol handles customer service — returns, exchanges, complaints
• "Order today, get it tomorrow" badge — lifts conversion rate by 15–25%
• Zero ops overhead — no packing or shipping on your end

TGF Costs (approx. 2025)

• Storage: ₺80–150 per m³/month
• Order processing: ₺6–12 per product
• Return processing: ₺8–15 per return
• Commission: Standard Trendyol commission + 1–2% TGF fee

TGF becomes cost-effective for sellers with 500+ orders per month. Lower-volume sellers should ship from their own warehouse.

Trendyol Store Performance Score and Cancellation Rates

Trendyol assigns every seller a store score from 1 to 10 — and this score directly drives visibility on the storefront. The main factors that pull the score down:

• Cancellation rate — Out-of-stock cancellations are the harshest penalty; above 2% triggers a warning, above 5% risks store suspension
• Late shipping — Orders not shipped within the prep window
• Return rate — Returns above the expected baseline (30%+ is considered normal in fashion)
• Customer reviews — Should not fall below 4.0 stars
• Response time — Messages should be answered within 24 hours

Zunapro's automatic stock synchronization reduces your cancellation risk by 90% — the moment a product sells on your site, in your warehouse, or on another marketplace, it goes inactive on Trendyol instantly.

Trendyol Ads, Promotions, and Smart Pricing

Trendyol Ad Platforms

• Sponsored Products — Top slots in search results (CPC-based, TL/click)
• Trendyol Smart Ads — Algorithmic budget optimization
• Brand store ads — Banner and display
• Trendyol Express promotions — Discount campaigns for TGF-badged products

Smart Pricing (Repricer)

The Buy Box war on Trendyol is intense. When 10+ sellers offer the same product, the lowest-priced seller (or the one with the highest store score) wins the Buy Box. The Zunapro repricer module adjusts prices against your competitors automatically within seconds — and never drops below your minimum profit threshold.

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

Every seller on Trendyol is required to issue an e-Archive invoice to B2C customers and an e-Invoice to B2B customers (per GİB regulations). Issuing invoices manually simply isn't feasible once you hit 100+ orders a day.

The Zunapro e-Invoice module:

• Issues e-Archive/e-Invoice automatically the moment a Trendyol order arrives
• Works with GİB-approved private integrators (Logo, Mikro, Uyumsoft, Foriba, Veriban, and others)
• Generates an automatic return invoice when a return occurs
• Monthly KDV1 and KDV2 (VAT) reporting
• Automatic e-Archive PDF email + SMS to the customer

Trendyol Shipping Integration — Trendyol Express + Others

Trendyol orders ship by default via Trendyol Express (Trendyol's in-house carrier, with same-day/next-day delivery to all 81 Turkish provinces). On top of that, you can integrate Yurtiçi Kargo, Aras Kargo, MNG Kargo, Sürat Kargo, and PTT Kargo.

Zunapro's multi-carrier module automatically picks the best carrier based on order weight, destination city, and customer preference; it prints the label and pushes the tracking number back to Trendyol automatically.

Trendyol Returns and Customer Service Management

Return rates in Turkish e-commerce sit at 30–40% in fashion, 5–10% in electronics, and 10–15% in home & living. If returns aren't managed properly, store score drops.

Standard Trendyol return flow:

1. The customer opens a return request from the Trendyol panel (within 14 days of delivery)
2. Trendyol Express picks up the product for free (1–3 business days)
3. The Trendyol warehouse inspects and either routes to the seller or approves the return
4. The seller approves or rejects the return within 1–3 business days
5. If approved, the refund is returned to the customer's Trendyol wallet

The Zunapro returns module tracks every step automatically, pushes notifications to the seller panel, and issues the return invoice for customer returns automatically.

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

1. Enter Your Trendyol Store Details — In the Zunapro panel, go to Marketplace → Trendyol and enter your Supplier ID, API key, and API 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 — Drag-and-drop to map your site's categories to Trendyol's. AI suggestions handle most of it within minutes.
4. First Sync — Products, stock, prices, orders, shipping — all sync automatically. Within 10 minutes, your Trendyol store is managed from the Zunapro panel.

Frequently Asked Questions About Trendyol Integration (FAQ)