Trendyol Entegrasyonu Nasıl Yapılır? Adım Adım 2026

Bu yazıda

Kısa cevap: Trendyol entegrasyonu nasıl yapılır?
Başlamadan önce hazırlayın
Adım 1: API bilgilerini bulun
Adım 2: Entegratörü tanımlayın
Adım 3: Bilgileri programa girin ve bağlantıyı test edin
Adım 4: Ürünleri eşleştirin ya da aktarın
Sık görülen hatalar ve anlamları
Güvenlik: API bilgilerini kim görmeli?
Webtegra'ya Trendyol mağazası bağlamak
Sık sorulanlar
Kaynaklar

Trendyol'da satıyorsunuz ve siparişleri, stoğu, faturayı bir entegrasyon programından yönetmeye karar verdiniz. Programın ilk sorduğu şey "Trendyol API bilgileriniz" olur. Bu bilgilerin nerede durduğu, kimin görebildiği ve programa nasıl verileceği Trendyol'un satıcı merkezinde yazılı; ama birkaç sayfaya dağılmış durumda.

Entegrasyonun genel mantığını pazaryeri entegrasyonu nedir yazısında anlattık. Bu yazıda Trendyol entegrasyonunu dört adımda topladık: API bilgilerini bulmak, entegratörü tanımlamak, bilgileri programa girmek ve ürünleri eşleştirmek. Sonunda sık görülen hata mesajları ve API bilgisinin güvenliği var. Bütün adımlar Trendyol Satıcı Bilgi Merkezi'nden, 1 Kasım 2026'da okundu.

Kısa cevap: Trendyol entegrasyonu nasıl yapılır?

Trendyol satıcı paneline hesap sahibi kullanıcıyla (master user) girin.
Hesap Bilgilerim > Entegrasyon Bilgileri sayfasını açın. İlk kez giriyorsanız ekrandaki kaydırma düğmesini sağa kaydırın.
Satıcı ID (supplier id), API Key ve API Secret bilgilerini görün. "Pazaryeri entegratörü ile çalışıyor musunuz?" sorusuna Evet deyip çalıştığınız programın adını yazın.
Bu üç bilgiyi entegrasyon programınızın Trendyol mağaza ayarına girin ve bağlantıyı test edin.
Ürünleri barkodla eşleştirin ya da programdan Trendyol'a aktarın.

İkinci bir program eklemek isterseniz aynı sayfada "Entegratör Firma Ekle" düğmesini kullanır ve programın hangi servislere erişeceğini seçersiniz.

Başlamadan önce hazırlayın

Onaylı bir Trendyol mağazası. Başvurunuz henüz sürüyorsa önce onu tamamlayın; adımlar Trendyol'da mağaza açma yazısında.
Hesap sahibi kullanıcının erişimi. Alt kullanıcılar entegrasyon bilgilerini göremez.
Barkodu doğru ürün kartları. Eşleştirme barkodla yapılır. Trendyol'da barkod zorunludur, 2-40 karakterdir ve ürün onaylandıktan sonra değiştirilemez.
Kargo ve fatura kararları. Hangi kargo firmasıyla çalıştığınız ve faturayı hangi e-belge sağlayıcısından kestiğiniz, programın kurulumunda sorulur.

Adım 1: API bilgilerini bulun

Trendyol'un servisleri Basic Authentication ile çağrılır ve bunun için üç bilgi gerekir: satıcı numarası (supplier id), API Key ve API Secret. Üçü de satıcı panelinde Hesap Bilgilerim bölümündeki Entegrasyon Bilgileri sayfasındadır. Trendyol'a göre bu bilgileri görmek için panele hesap sahibi kullanıcıyla girmek gerekir. Sayfaya ilk kez giriyorsanız bilgiler, ekrandaki kaydırma düğmesini sağa çektiğinizde görünür.

İlk oluşturulan API Key bütün rollerle tanımlıdır; Satıcı ID, API Key ve API Secret birlikte mağazanızın siparişlerine, stoğuna ve fiyatına erişim demektir. Bu üçlüyü ekran görüntüsüyle ya da mesajla göndermeyin; programa kendiniz girin. Terimin ayrıntısı API anahtarı maddesinde.

Adım 2: Entegratörü tanımlayın

Entegrasyon Bilgileri sayfasında "Pazaryeri entegratörü ile çalışıyor musunuz?" sorusu çıkar. Evet derseniz çalıştığınız entegratörün adını yazarsınız. Trendyol'un anlattığı kurallar şöyle:

Durum	Ne olur
İlk oluşturulan API Key	Entegratör adı boştur, rol bilgisi "tüm roller" olarak belirlenir
Tek entegratörle çalışıyor, bilgisini değiştirmek istiyorsunuz	"Düzenle" ile güncellersiniz
İkinci bir entegratör ekliyorsunuz	"Entegratör Firma Ekle" ile yeni kayıt açar, servisleri seçersiniz
Kendi yazılımınızla bağlanıyorsunuz	Entegratör adı alanına "Self Integration" yazarsınız
Eklediğiniz entegratörü kaldırıyorsunuz	"Düzenle" ve ardından "Entegratörü Sil"

Servis seçimi önemlidir. Trendyol entegratör eklerken şu servislerden seçim yapılmasını istiyor: ürün, satıcı bilgileri, sipariş, fatura, iade, webhook, teslimat, soru cevap, muhasebe ve finans entegrasyonu. Seçtiğiniz servislere göre üretilen API Key yalnız o servislerde çalışır. Örneğin yalnız fatura kesen bir programa ürün ve fiyat servisi açmanız gerekmez.

Adım 3: Bilgileri programa girin ve bağlantıyı test edin

Her programın mağaza ekleme ekranı farklıdır, ama istenen bilgiler aynıdır: Satıcı ID, API Key, API Secret. Girdikten sonra bağlantıyı üç basit denemeyle doğrulayın:

Sipariş: Son birkaç günün siparişleri programa düştü mü?
Stok: Programda bir ürünün stoğunu değiştirin; birkaç dakika sonra Trendyol panelinde aynı rakamı görün.
Fiyat: Düşük satışlı bir üründe fiyatı bir kuruş değiştirip panelde kontrol edin, sonra geri alın.

Üçü de çalışıyorsa bağlantı tamamdır. Siparişler geliyor ama stok gitmiyorsa ilk bakılacak yer servis seçimidir: entegratör tanımında ürün servisinin seçili olup olmadığını kontrol edin.

Adım 4: Ürünleri eşleştirin ya da aktarın

Trendyol'da zaten satışta olan ürünleriniz varsa program onları barkodla eşleştirir. Eşleşmeyen ürünler genellikle barkodu farklı yazılmış ya da varyantı ayrı açılmış ürünlerdir; bunları tek tek düzeltin. Kategori ve marka eşleştirmesini de bu adımda yaparsınız.

Programdan Trendyol'a yeni ürün gönderiyorsanız ürün hemen satışa çıkmaz. Trendyol'un anlattığı akış şöyle: ürün yaratma isteği başarılıysa dönen işlem numarasıyla aktarımın sonucu 4 saat içinde kontrol edilir; hatasız ürünler onay aşamasına girer; onaylanan ürünler stok ve fiyatla satışa açılır. Reddedilen üründe red sebebi düzeltilip ürün yeniden gönderilir. Programınız bu durumları ekranda göstermiyorsa Trendyol panelindeki ürün listesinden takip edin.

Sık görülen hatalar ve anlamları

Hata	Trendyol'un açıklaması	Ne yapmalı
401	API Key ve API Secret eksik ya da yanlış	Bilgileri panelden yeniden kopyalayıp girin; yakın zamanda güncellediyseniz yeni bilgileri kullanın
403 ya da 556	Hatalı adres ya da servis parametresiyle istek yapılıyor	Programın sorunudur; destek ekibine iletin
Ürün yüklendi ama yayında değil	Ürün onay aşamasında ya da reddedilmiş	Aktarım sonucunu ve red sebebini kontrol edin
Bilgiler görünmüyor	Panele alt kullanıcıyla girilmiş	Hesap sahibi kullanıcıyla girin

Programla çalışırken bilmeniz gereken bir tarih var: Trendyol, ürün entegrasyonunun V1 servislerinin Ağustos 2026 itibarıyla kullanım dışı kaldığını, V2 servislerinin kullanılması gerektiğini yazıyor. Ürün aktarımında sürekli 403 ya da 556 alıyorsanız programın güncel servisleri kullanıp kullanmadığını sorun.

Güvenlik: API bilgilerini kim görmeli?

Birincil API bilgileri silinemez. Bilgileri üçüncü kişilerle paylaştıysanız ve erişimlerini kesmek istiyorsanız Entegrasyon Bilgileri sayfasındaki "API Bilgilerini Güncelle" düğmesini kullanın. Trendyol'a göre bundan sonra eski bilgilerle yapılan istekler hata alır.
Güncelleme bağlantıyı da keser. Aynı bilgileri kullanan programınız da yeni bilgilerle güncellenene kadar çalışmaz. Güncellemeyi siparişlerin az olduğu bir saatte yapın ve yeni bilgileri hemen programa girin.
Bıraktığınız programın kaydını silin. Eklediğiniz entegratörü "Düzenle" ve "Entegratörü Sil" ile kaldırın. Programı değiştirirken izlenecek sıra entegrasyon programı değiştirme yazısında.
Yalnız gereken servisi açın. Servis bazlı anahtar, bir programın ihtiyacından fazlasına erişmesini önler.

Webtegra'ya Trendyol mağazası bağlamak

Webtegra'da sıra şöyledir: kayıt olur, firma ayarlarınızı yapar, Entegrasyon API ayarları ekranına Trendyol'daki Satıcı ID, API Key ve API Secret bilgilerinizi girersiniz. Ardından kategori ve Trendyol marka eşleştirmesini yapar, ürün kartlarınızı Trendyol ilanlarına bağlarsınız. Her adımın videosu eğitim sayfasında. İsterseniz destek ekibi uzaktan bağlanarak kurulumu sizinle birlikte yapar; yerinde kurulum yapılmaz.

Bağlantıdan sonra Trendyol siparişleri diğer pazaryerlerinizin siparişleriyle aynı listeye düşer, stok bütün mağazalarda aynı ürün kartından düşer (stok yönetimi), fatura siparişten kesilip bağlantısı Trendyol'a gönderilir. Neler eşitlendiği Trendyol entegrasyonu sayfasında; bir satışın komisyon, hizmet bedeli, kargo ve stopajdan sonra ne bıraktığını Trendyol komisyon ve kâr hesaplama aracında görebilirsiniz.

Kullandıkça Öde paketinde aylık sabit ücret yok, sipariş başı 3 TL (KDV dahil) ödersiniz. Mikro, KOBİ ve Kurumsal paketlerde 3 ay koşulsuz iade imkânı var.

Sık sorulanlar

Trendyol API bilgileri nerede?

Satıcı panelinde Hesap Bilgilerim > Entegrasyon Bilgileri sayfasında: Satıcı ID, API Key ve API Secret. Bu sayfayı yalnız hesap sahibi kullanıcı görür; ilk girişte kaydırma düğmesini sağa çekmeniz gerekir.

API Key'imi paylaştım, erişimi nasıl iptal ederim?

Entegrasyon Bilgileri sayfasında "API Bilgilerini Güncelle" düğmesine tıklayın. Eski bilgilerle yapılan istekler hata alır; çalışmaya devam edecek programa yeni bilgileri girmeniz gerekir. Birincil API bilgileri silinemez, yalnız güncellenir.

Trendyol'da birden fazla entegrasyon programı kullanabilir miyim?

Evet. "Entegratör Firma Ekle" ile her programı ayrı tanımlar ve her birine yalnız gereken servisleri açarsınız. Stok ve fiyatı ise tek bir programdan gönderin; iki program aynı ürüne farklı rakam gönderirse son gelen geçerli olur. Ayrıntısı stok senkronizasyonu maddesinde.

Kendi yazılımımla Trendyol'a bağlanabilir miyim?

Evet. Entegratör eklerken entegratör adı alanına "Self Integration" yazarsınız. Servislerin ayrıntısı Trendyol'un geliştirici dokümanında.

Entegrasyondan sonra Trendyol panelinden stok değiştirebilir miyim?

Teknik olarak değiştirebilirsiniz, ama bir sonraki eşitleme paneldeki değişikliğin üzerine yazar. Stoğu ve fiyatı yalnız entegrasyon programından değiştirin.

Bu yazı bilgilendirme amaçlıdır; mali ve hukuki görüş değildir. Adımlar 1 Kasım 2026 itibarıyla Trendyol Satıcı Bilgi Merkezi'nden derlendi; panel menü adları değişebilir. Fatura ve e-arşiv ayarlarınız için mali müşavirinize danışın.

Trendyol Entegrasyonu Nasıl Yapılır? API Bilgileri Nerede, Adım Adım (2026)