Setting up the Hepsiburada integration

Create a service key in your Hepsiburada seller panel, connect with your merchant ID and password, pair listings to products, run orders from one panel.

5 min de lectureDernière mise à jour : 2026-08-30

The Hepsiburada integration pulls the listings, orders, claims, questions and settlement records of your seller account into your own admin. You push price and stock from here, and you process incoming orders on your own order screen. The first step of the setup does not happen in our panel: Hepsiburada requires the seller to grant the access from their own seller panel.

Avant de commencer

  • The Hepsiburada Pazaryeri plugin enabled on your plan
  • Access to the Hepsiburada seller panel — the service key is created there
  • Your merchant ID (it doubles as the API username)
  • For Excel product imports, the Hepsiburada Aktarma plugin as well

Étapes

Les écrans sont illustratifs ; les données de votre panneau différeront.

  1. Étape 1: Create a service key in your Hepsiburada panel

    Open Pazaryerleri → Hepsiburada → Ayarlar. Before a connection exists, the page starts with a card titled 'Başlamadan önce: Hepsiburada panelinizde yetki verin' containing our integrator name. Copy it, go to Ayarlar → Entegrasyon Bilgileri → Servis Anahtarı Ekle in the Hepsiburada seller panel, search that integrator name and grant access. Copy the password it generates immediately — it is shown only once.

    Not connected

    Settings

    Before you start: grant access in your Hepsiburada panel

    Integrator name
    magazamhazir

    Search this exact name in Hepsiburada's integrator box and grant access.

    CopyOpen the Hepsiburada guide
    Settings — exemple de vue du panneau
  2. Étape 2: Connect with the merchant ID and password

    The Bağlantı Durumu card on the same page has only two inputs. Enter your merchant ID and the password you just generated, then press Bağlan — no separate username is asked for, because the merchant ID is the API username. When you see 'Kimlik bilgileri kaydedildi' and the Bağlı badge, the connection is live. A wrong value returns 'Bağlantı başarısız. Kimlik bilgilerinizi kontrol edin.'

    Not connected

    Connection status

    Merchant ID
    482913

    Your merchant ID from the Hepsiburada seller panel. It is also used as the API username.

    Password
    Enter your Hepsiburada password

    The password shown when the service key was created. Shown once only; if lost, create a new key in the panel.

    Connect
    Connection status — exemple de vue du panneau
  3. Étape 3: Decide on the two sync switches

    As soon as the connection is made, a Webhook Durumu card and a Senkronizasyon Ayarları card appear. 'Sipariş senkronizasyonu aktif' polls Hepsiburada for new orders every 5 minutes in the background. 'Otomatik fatura oluştur' arrives OFF: while it is off you issue the invoice yourself from the order screen; turned on, every packed order gets an invoice automatically and its link is sent to Hepsiburada.

    Connected

    Sync settings

    Order synchronisation on

    Pulls new Hepsiburada orders in the background every 5 minutes.

    açık

    Create invoices automatically

    While off, you issue the invoice from the order screen (default).

    kapalı

    Settings saved

    Sync settings — exemple de vue du panneau
  4. Étape 4: Pair listings with your own products

    The Ürünler page has two tabs: Pazaryeri kataloğu lists your Hepsiburada listings, Mağazamdaki ürünler lists your own variants. Pull the catalogue with Senkronize et. Otomatik eşleştir links rows whose stock code matches exactly and reports how many it linked. Akıllı eşleştir proposes candidates from barcode, name and attribute similarity; those do not link themselves — they wait in the "eşleşme onayını bekliyor" card with Onayla and Reddet.

    Connected

    Products

    Marketplace catalogueMy products
    SyncAuto-pairSmart match
    Marketplace catalogueSKUPriceMarketplace stateMarketplaces
    Wireless Headphones BT-40BT40-SYH₺1,249On saleAlready listed
    Desktop Charging DockCHG-3X₺699On salePair
    Portable Speaker S2SPK-S2-GRI₺899Sold outPair

    3 matches awaiting your approval

    Products — exemple de vue du panneau
  5. Étape 5: Push price and stock differences

    The Fiyat/stok farkları page lists every row where your value and Hepsiburada's value have diverged, with Mağaza fiyatı, Mağaza stoğu and Fark columns. The difference reads 'Sadece fiyat', 'Sadece stok' or 'Fiyat ve stok'. What you send is processed on Hepsiburada's side within a few minutes. This screen updates existing listings; it does not open new ones.

    Connected

    Price/stock differences

    My productsStore priceStore stockDifference
    Wireless Headphones BT-40₺1,19912Price only
    Desktop Charging Dock₺69934Stock only
    Portable Speaker S2₺8496Price and stock

    Creating new Hepsiburada listings from this panel is not open yet.

    Price/stock differences — exemple de vue du panneau
  6. Étape 6: Follow orders, claims and invoices

    The Kontrol Paneli shows four counts — products, orders, questions, claims — and, below them, recent orders and recent claims. Order statuses arrive translated: Açık, Paketlendi, Kargoya Verildi, Teslim Edildi. When Hepsiburada is waiting for an invoice, a 'Fatura Bekleyen Paketler' card appears: pressing Fatura Oluştur imports the order into your store, prepares its invoice and sends the link to Hepsiburada.

    Connected

    Dashboard

    Products

    128 records

    Orders

    37 records

    Questions

    2 records

    Claims

    1 record

    Order noCustomerTotalStatusDate
    HB-4820193Deniz Yılmaz₺1,249Packed28.08.2026
    HB-4819772Merve Arslan₺1,398Shipped27.08.2026
    HB-4818410Onur Kaya₺699Delivered26.08.2026
    Dashboard — exemple de vue du panneau
  7. Étape 7: Import your catalogue from Excel

    If your Hepsiburada products do not exist in your store yet, upload Hepsiburada's product Excel from İçe Aktarma → Hepsiburada. The wizard walks through Dosya, Sütun eşleme, Özellikler, Önizleme and Sonuç. Because Hepsiburada's column headers are already known, the mapping is done directly — no AI call, no credit spent. Nothing is created until you press 'Onayla ve aktar'.

    Hepsiburada import

    1. File
    2. Column mapping
    3. Attributes
    4. 4Preview
    5. 5Result

    Mapped with the marketplace template

    Nothing is created until you approve.

    Approve and importBack
    Hepsiburada import — exemple de vue du panneau

Conseils

Never bulk-approve barcode matches unseen

Rows whose stock code matches exactly are safe; a barcode match is a guess, and barcodes are not always unique. A wrongly linked product sends the wrong price and stock to Hepsiburada. Approve the 'Kesin eşleşme' band in bulk, and open the 'Kontrol edilmeli' and 'Zayıf ihtimal' rows one by one.

The service key password is one-time

Hepsiburada shows the password once, on the screen where the key is created. If you lose it the same key cannot be recovered — create a new service key in the seller panel, put it in the Şifre field and press Yeniden Bağlan. The merchant ID does not change.

Questions fréquentes

Can I create a new Hepsiburada listing from this panel?
No. Hepsiburada takes a product together with its category and that category's mandatory attributes, and reviews it before publishing; that flow is not open in the panel yet. Create the listing in your Hepsiburada panel, pair it here, and manage price and stock from here.
How often do orders arrive?
With 'Sipariş senkronizasyonu aktif' on, every 5 minutes in the background. A webhook is registered on top of that, and the Webhook Durumu card shows the last event. To refresh a single order immediately, its detail page has a 'Hepsiburada'dan Yeniden Senkronize Et' button.
Are invoices issued automatically?
Not by default. 'Otomatik fatura oluştur' arrives off and you issue the invoice yourself. Turned on, every packed order gets an invoice automatically and its link is sent to Hepsiburada — an invoice is a legal document, so turn this on deliberately.

Extensions associées

La tâche décrite ici est fournie avec ces extensions.

Essayez dans une démo en ligne

De vraies boutiques utilisant cette fonctionnalité. Ouvrez-les et explorez.

Guides associés

En ligne instantanément — lancez votre site aujourd'hui

Launch your website today.

Start for free. No credit card required. Create your first store in minutes.

No credit card required