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

Bu yazıda

Kısa cevap: Amazon entegrasyonu nasıl yapılır?
Amazon'da entegrasyon nasıl çalışır?
Başlamadan önce hazırlayın
Adım 1: Programa yetki verin
Adım 2: Ürünleri eşleştirin ya da gönderin
Adım 3: Sipariş, stok ve fiyatı deneyin
Adım 4: Yetkiyi her yıl yenileyin
Sık görülen hata kodları ve anlamları
Güvenlik: yetkiyi kim verir, nasıl kaldırılır?
Webtegra'ya Amazon mağazası bağlamak
Sık sorulanlar
Kaynaklar

Amazon Türkiye'de mağaza açtınız ya da yüzde 1 komisyon kampanyasıyla açmayı düşünüyorsunuz ve Amazon siparişlerini diğer mağazalarınızla aynı programdan yönetmek istiyorsunuz. Amazon'da bağlantı Trendyol ya da n11'deki gibi işlemez: panelden bir API anahtarı kopyalayıp programa vermezsiniz. Programın Amazon'a kayıtlı bir uygulaması vardır; siz Seller Central'a girip bu uygulamaya mağazanız adına işlem yapma yetkisi verirsiniz.

Entegrasyonun genel mantığını pazaryeri entegrasyonu nedir yazısında anlattık. Bu yazıda Amazon entegrasyonunu dört adımda topladık: programa yetki vermek, ürünleri eşleştirmek, sipariş, stok ve fiyatı denemek, yetkiyi her yıl yenilemek. Sonunda sık görülen hata kodları ve yetkinin nasıl kaldırıldığı var. Bütün adımlar Amazon Türkiye'nin satıcı sitesinden ve Satış Ortağı API'sinin geliştirici dokümanından, 5 Kasım 2026'da okundu. Amazon'un dokümanı Seller Central sayfalarını İngilizce adlarıyla veriyor; yazıda da o adlarla geçiyor.

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

Amazon Türkiye satıcı hesabınızın doğrulaması bitmiş olsun. Hesap açma adımları Amazon Türkiye'de satıcı olmak yazısında.
Çalışacağınız programın yetkilendirme düğmesine basın ya da programın uygulamasını Selling Partner Appstore'da bulup Authorize Now'ı seçin.
Seller Central'a hesabın birincil kullanıcısıyla girin, uygulamanın istediği veri erişimini okuyup izin verin.
Programın sitesinde oturum açarak yetkiyi hesabınızla eşleştirin. Amazon işlem bitince Seller Central'da başarı mesajı gösterir.
Ürünleri barkodla Amazon kataloğundaki ürünlerle eşleştirin ya da yeni ürün olarak gönderin.
Yetkiyi her yıl Seller Central'daki Manage Your Apps sayfasından Re-Authorize ile yenileyin.

Amazon'da entegrasyon nasıl çalışır?

Amazon Türkiye'nin tanımıyla Satış Ortağı API'si (SP-API), satıcıların ürün listeleme, stok ve fiyat güncelleme, sipariş, ödeme, raporlama ve müşteri soruları gibi işlemleri yapmasını sağlayan REST tabanlı bir API'dir. Entegrasyon programları Amazon'a bu API üzerinden bağlanır.

Amazon iki tür geliştirici tanımlıyor ve yetki ikisinde farklı verilir:

Tür	Kimin için	Yetki nasıl verilir
Üçüncü parti uygulama geliştiricisi (entegratör)	Birçok satıcıya hizmet veren programlar	Satıcı, Login with Amazon (OAuth 2.0) ile uygulamaya yetki verir; işlem programın sitesinden ya da Selling Partner Appstore'dan başlar
Özel geliştirici	Yalnız kendi mağazası için yazılım yapan satıcı	Satıcı kendi uygulamasını Seller Central ya da Solution Provider Portal üzerinden kendisi yetkilendirir

Entegrasyon programı kullanan satıcı için geçerli olan ilk satırdır. Kendi yazılımınızı yazacaksanız Amazon önce bir Solution Provider Portal hesabı ve geliştirici profili istiyor; Amazon Türkiye'ye göre profil başvuruları ortalama 7 gün içinde sonuçlanıyor.

Başlamadan önce hazırlayın

Doğrulanmış satıcı hesabı. Kayıt, belgeler ve kampanyanın takvimi Amazon Türkiye'de satıcı olmak yazısında.
Birincil kullanıcı erişimi. Amazon'un yetkilendirme hataları arasında, hesaba birincil kullanıcı olmayan biriyle girildiğinde çıkan bir hata var. Yetkiyi hesabın birincil kullanıcısı verir.
Barkodlar. Amazon Türkiye'nin hata rehberine göre satıcı GS1 sistemine kayıtlı bir barkod girmeli; barkodu yoksa barkod muafiyeti almalı. Terimlerin ayrıntısı GS1 ve EAN-13 maddelerinde.
Marka onayı. Amazon'da her satıcı her markayı satmaya yetkili değil. Satacağınız markalardan onay gerektirenleri baştan bilin; kendi markanız varsa Amazon'un marka kaydı sürecine bakın.
Kargo dahil fiyat. Amazon'a göre ürünü kargo dahil fiyatla listelersiniz ve alıcıdan ek kargo ücreti alamazsınız. Komisyon da ürün bedeli, KDV ve kargo dahil toplam tutardan alınır. Bu yüzden diğer mağazalarınızdaki fiyatı Amazon'a olduğu gibi taşımayın; kargoyu fiyata ekleyip komisyonu bu toplamdan hesaplayın.
Gönderim yöntemi. Kendi gönderiminiz, Amazon Kolay Gönderi ya da Amazon Lojistik. Program stoğu ve siparişi buna göre yönetir.

Adım 1: Programa yetki verin

Amazon'un dokümanına göre herkese açık uygulamalarda yetkilendirme Login with Amazon üzerinden OAuth 2.0 ile yapılır ve yetkiyi satıcı verir. İki başlangıç noktası var:

Programın sitesinden. Programın sitesindeki yetkilendirme düğmesine (Authorize) basarsınız ve Seller Central'daki izin sayfasına yönlendirilirsiniz.
Selling Partner Appstore'dan. Uygulamanın Appstore'daki sayfasında Authorize Now'ı seçer, uygulamanın istediği veri erişimini inceler ve izin verirsiniz.

İki yolda da Seller Central'a girip izin verirsiniz, ardından programın sitesinde oturum açarak yetkiyi oradaki hesabınızla eşleştirirsiniz. Amazon işlem bitince Seller Central'da başarı mesajı gösterir. Program bu yetkiyle Amazon'dan kendi erişim anahtarlarını alır ve saklar. Sizin bir API anahtarı kopyalamanız ya da programa Seller Central şifrenizi vermeniz gerekmez.

İzin ekranında uygulamanın hangi verilere eriştiğini görürsünüz. Amazon Türkiye'ye göre müşteri adı ve adresi gibi kişisel bilgi gerektiren işler için geliştiricinin ayrıca kısıtlı rollere başvurması gerekir: kargo yönetimi için Doğrudan Tüketiciye Kargo, faturalandırma için Vergi Faturalandırması. Programın Amazon siparişinden fatura ve kargo etiketi çıkarmasını bekliyorsanız bu rollerin onaylı olup olmadığını sorun.

Adım 2: Ürünleri eşleştirin ya da gönderin

Amazon'da aynı ürün için genellikle tek bir ürün sayfası (ASIN) olur. Ürününüz katalogda varsa teklifiniz o sayfaya eklenir, yoksa yeni sayfa açılır. Eşleşme barkodla kurulur; bu yüzden barkodun doğru olması şarttır. Yanlış barkod ürününüzü başka bir ürünün sayfasına bağlar.

Amazon Türkiye'nin hata rehberinden üç pratik ders:

Katalogdaki bilgiyle çelişmeyin. Gönderdiğiniz barkod katalogdaki bir ürünle eşleşip markası ya da başka bir bilgisi farklıysa ürün hata alır. Doğru ürünse bilgilerinizi katalogla aynı yapın; değilse barkodu kontrol edin.
Yanlış barkod kullanmayın. Amazon'a göre ürünle eşleşmeyen barkod kullanmak yasak ve ürün açma yetkinizin askıya alınmasına yol açabilir.
Excel'de sıfırlara dikkat edin. Amazon'un rehberi, sıfırla başlayan barkodların Excel'de baştaki sıfırı kaybetmediğini kontrol etmenizi istiyor.

Kategori de ayrı bir konudur: bazı kategorilerde ve kısıtlı ürün gruplarında satış için Amazon'dan onay gerekir.

Adım 3: Sipariş, stok ve fiyatı deneyin

Bağlantıyı üç basit denemeyle doğrulayın:

Sipariş: Son birkaç günün Amazon siparişleri programa düştü mü?
Stok: Programda bir ürünün stoğunu değiştirin; bir süre sonra Seller Central'da aynı rakamı görün.
Fiyat: Düşük satışlı bir üründe fiyatı değiştirip Seller Central'da kontrol edin, sonra geri alın. Fiyatın kargo dahil olduğunu unutmayın.

Siparişi kendiniz gönderiyorsanız Amazon gönderiden sonra Sipariş Yönetimi sayfasında Kargoyu Onayla ile bilgileri girmenizi istiyor. Bu bildirimi kimin yapacağını baştan belirleyin: program yapıyorsa panelden ikinci kez girmeyin.

Amazon Lojistik kullanıyorsanız Amazon'un deposuna gönderdiğiniz ürünler ayrı bir stoktur. Bu adetleri diğer mağazalarınızda satılabilir saymayın; kendi deponuzdaki stoğu buna göre düşün. Ayrıntısı sanal stok ve fulfillment maddelerinde.

Adım 4: Yetkiyi her yıl yenileyin

Amazon'a göre herkese açık uygulamalara verilen yetki güvenlik nedeniyle 365 günde bir ya da uygulama yeni bir rol eklediğinde yenilenmelidir. Yenileme adımları şöyle:

Seller Central'a girin.
Manage Your Apps sayfasını açın.
Uygulamayı bulun ya da Amazon'un yenileme bildirimindeki bağlantıyı kullanın.
Re-Authorize'ı seçin.
İstenen veri erişimini inceleyip kabul edin.
Gerekiyorsa programın sitesinde oturum açmayı tamamlayın.

Amazon ayrıca 365 günden uzun süredir yenilenmemiş ve bu sürede hiç API çağrısı yapılmamış yetkileri devre dışı bırakıyor. Manage Your Apps sayfasında devre dışı (Disabled) görünen bir uygulamayı Reactivate Authorization ile yeniden açabilirsiniz; bu işlem önceki yetkiyi geri getirir. Yenileme tarihini takviminize yazın: yetkisi biten program mağazanıza erişemez ve siparişler programa gelmez.

Sık görülen hata kodları ve anlamları

Hata kodu	Amazon'un açıklaması	Ne yapmalı
5461	Bu markada yeni ürün (ASIN) açma yetkiniz yok	Hata mesajındaki bağlantıdan marka için onay başvurusu yapın
5665	Girdiğiniz marka adı Amazon tarafından onaylanmamış	Marka onayı isteyin; kendi markanızsa marka kaydı sürecine başvurun
8541	Gönderdiğiniz bilgi, aynı barkodlu katalog ürününden farklı (ör. marka)	Doğru ürünse bilgilerinizi katalogla aynı yapın; değilse barkodu düzeltin
8572, 8566, 8567	Barkod ürünle eşleşmiyor ya da yeni ürün açmaya uygun değil	GS1'e kayıtlı barkod girin; barkodunuz yoksa barkod muafiyeti alın
8560	Ürün kimliği (barkod) eksik	Barkodu ekleyin; Excel'de baştaki sıfırların silinmediğini kontrol edin
6024, 6039	Bu kategoride ya da kısıtlı ürün grubunda satış yetkiniz yok	Kategori için onay başvurusu yapın
8571	Hesaptan olağan dışı sayıda listeleme yapıldığı için listeleme yetkisi geçici olarak kaldırıldı	Amazon'un ASIN oluşturma politikasını okuyun, Satış Ortağı Destek'e başvurun
SPDC8143 (yetkilendirmede)	Hesaba birincil kullanıcı olmayan biriyle girilmiş	Birincil kullanıcıyla girip yeniden deneyin
Unauthorized, Access Denied	Program istenen veriye erişemiyor; Amazon'un saydığı sebeplerden biri hesap durumu	Seller Central hesabınızın sağlıklı durumda olduğunu kontrol edin, sorun sürerse programın destek ekibine iletin

SPDC8143 dışındaki satırlar Amazon Türkiye'nin Sık Alınan Listeleme ve Entegrasyon Hataları Rehberi'nden, SPDC8143 SP-API'nin hata kodları sayfasından.

Güvenlik: yetkiyi kim verir, nasıl kaldırılır?

Şifre değil yetki. Programa Seller Central şifrenizi vermeniz gerekmez; yetki Login with Amazon ile verilir ve hangi verilere erişildiği izin ekranında yazar.
Yetkiyi yalnız siz kaldırırsınız. Amazon'a göre satıcının verdiği yetkiyi yalnız satıcı kaldırabilir. Adımlar: Seller Central > Apps and Services > Manage Your Apps, uygulamayı bulun, Disable authorization'ı seçin, onay penceresinde OK'a basın. Uygulama devre dışı kalır, ama listede görünmeye devam eder.
Bıraktığınız programın yetkisini kaldırın. Programı değiştirirken izlenecek sıra entegrasyon programı değiştirme yazısında. Amazon, satıcının kendi uygulamasını geliştirmeye karar verdiği durumu da önceki programa verilen yetkinin kaldırılması gerekebilecek durumlar arasında sayıyor.
Stok ve fiyatı tek programdan gönderin. İki program aynı ürüne farklı rakam gönderirse son gelen geçerli olur. Ayrıntısı stok senkronizasyonu maddesinde.

Webtegra'ya Amazon mağazası bağlamak

Webtegra'da kayıt olup firma ayarlarınızı yaptıktan sonra Amazon mağazanızı bağlarsınız. Bağlantı adımlarını kurulumda destek ekibimiz uzaktan sizinle birlikte yapar; yerinde kurulum yapılmaz. Ürünleriniz başka bir pazaryerinde zaten satıştaysa onları Excel, XML, bağlantı ya da pazaryeri kataloğundan topluca aktarır, kategori ve markayı eşleştirip ürün kartını Amazon'a bağlarsınız. Adımların videoları eğitim sayfasında, "Excel ile toplu ürün yükleme" ve "Pazaryeri aktarım ekranı" başlıklarıyla.

Bağlantıdan sonra Amazon 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). Amazon Lojistik'e gönderdiğiniz ürünler için mağazaya ayrı stok payı tanımlayabilirsiniz. Neler eşitlendiği Amazon entegrasyonu sayfasında. Kargo dahil fiyatın komisyondan sonra ne bıraktığını Amazon komisyon 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

Amazon entegrasyonu için API anahtarı nereden alınır?

Entegrasyon programı kullanıyorsanız API anahtarı almazsınız. Program, Login with Amazon üzerinden sizin verdiğiniz yetkiyle bağlanır: programın sitesinden ya da Selling Partner Appstore'dan başlayıp Seller Central'da izin verirsiniz. Kendi yazılımınızı yazıyorsanız Solution Provider Portal'da geliştirici profili açıp uygulamanızı kendiniz yetkilendirirsiniz.

Amazon'da programa verdiğim yetkiyi ne sıklıkla yenilemem gerekir?

Amazon'a göre 365 günde bir ya da program yeni bir rol eklediğinde. Seller Central'da Manage Your Apps sayfasında uygulamayı bulup Re-Authorize'ı seçer, istenen erişimi kabul edersiniz.

Amazon'da bir programın yetkisini nasıl kaldırırım?

Seller Central'da Apps and Services > Manage Your Apps sayfasında uygulamayı bulup Disable authorization'ı seçer, onay penceresinde OK'a basarsınız. Amazon'a göre bu yetkiyi yalnız satıcı kaldırabilir.

Programa Seller Central şifremi vermem gerekir mi?

Hayır. Yetki Login with Amazon ile verilir; program kendi erişim anahtarını Amazon'dan alır. Şifrenizi paylaşmanız gerekmez.

Amazon'a gönderdiğim fiyata kargo dahil mi olmalı?

Evet. Amazon'a göre ürünü kargo dahil fiyatla listelersiniz ve alıcıdan ek kargo ücreti alamazsınız. Komisyon da kargo dahil toplam tutardan hesaplanır.

Ürünüm "marka onaylanmadı" hatası alıyor. Ne yapmalıyım?

Amazon'da her satıcı her markayı satmaya yetkili değil. 5461 ve 5665 hatalarında hata mesajındaki bağlantıdan marka onayı başvurusu yaparsınız; marka sizinse Amazon'un marka kaydı sürecine başvurursunuz.

Bu yazı bilgilendirme amaçlıdır; mali ve hukuki görüş değildir. Adımlar 5 Kasım 2026 itibarıyla Amazon Türkiye'nin satıcı sitesinden ve Satış Ortağı API dokümanından derlendi; Seller Central menü adları ve dili değişebilir. Fatura ve e-arşiv ayarlarınız için mali müşavirinize danışın.

Amazon Entegrasyonu Nasıl Yapılır? SP-API Yetkilendirme, Yıllık Yenileme ve Sık Hatalar