Etsy entegrasyonu:
ürün, stok ve sipariş tek panelde.

Etsy entegrasyonu nedir, hangi işleri sizin yerinize üstlenir?

Etsy entegrasyonu, Etsy mağazası ile stok ve sipariş yazılımınız arasında, Etsy'nin resmî API'si üzerinden çalışan iki yönlü bir bağlantıdır. Etsy'de tek parça ya da az adetli ürünler ağırlıkta olduğu için aynı ürünün iki kanalda birden satılması pahalıya mal olur: iptal edilen sipariş hem alıcıyı kaybettirir hem mağaza göstergelerinize yansır. Yox İş Ortağım entegrasyonları Etsy'yi, Trendyol entegrasyonu gibi yurt içi kanallarla aynı ürün kartına bağlar.

Etsy panelinden elle yönetim ile Yox İş Ortağım karşılaştırması

Bağlantıdan sonra mevcut ilanlarınız panele okunur ve ürün kartlarınıza eşleştirilir; siz onay vermeden Etsy'deki hiçbir ilan değişmez.

Türkiye'den Etsy'de satış yapmak için hangi şartlar gerekir?

Türkiye, Etsy Payments'ın doğrudan desteklendiği ülkeler arasındadır; satış gelirinizi Türkiye'deki banka hesabınıza Türk lirası olarak alırsınız. Etsy'nin ödeme ülkeleri listesinde Türkiye yıldızsız yer alır; Payoneer hesabının zorunlu olduğu ülkeler (Brezilya, Mısır, Hindistan, Ukrayna gibi) listede ayrıca işaretlidir. İnternette hâlâ dolaşan “Türkiye'den Etsy'ye yalnız Payoneer ile satılır” bilgisi bu nedenle güncel değildir.

Mağaza açılışında Etsy'nin istedikleri

• Kimlik doğrulama: Etsy, Persona aracılığıyla süresi geçmemiş kimliğinizin fotoğrafını ve bir özçekim ister; kimlikteki ad banka hesabındaki adla aynı olmalıdır.
• Banka ve kart: Gelir için Türkiye'deki banka hesabınızı, Etsy ücretleri için bir kredi ya da banka kartını eklersiniz.
• Açılış ücreti: Tek seferlik, iade edilmeyen bir ücrettir; tutar konuma göre değişir.
• İki adımlı doğrulama: Hesap güvenliği için zorunludur.
• Ürün uygunluğu: Satılan her ürün sizin yaptığınız, tasarladığınız, seçtiğiniz (en az 20 yıllık vintage gibi) ya da alıcının yaratıcılığına hizmet eden bir ürün olmalıdır; seri üretim ürünün yeniden satışı yasaktır.

PayPal, mağaza dili ve banka ülkesi: sonradan değişmeyen kararlar

PayPal Türkiye'de faaliyet göstermediği için Türkiye'deki Etsy satıcıları mağazalarında PayPal kabul edemez; alıcılar Etsy Payments üzerinden kartla ve Etsy'nin sunduğu diğer yöntemlerle öder. Mağaza dili sonradan değiştirilemez, yalnız çeviri dili eklenebilir; banka ülkesi de Euro bölgesi içi taşınmalar dışında güncellenemez. Yurt dışına başka bir pazaryerinden de satıyorsanız kuralları eBay entegrasyonu sayfasıyla karşılaştırın.

Etsy ücretleri 2026: Türkiye'deki satıcıdan kesilen kalemler

Türkiye'de banka hesabı olan bir Etsy satıcısı her satışta işlem ücreti, ödeme işleme ücreti ve düzenleyici işletim ücretini birlikte öder. Tablo 13 Ekim 2026'da Etsy yardım merkezinden derlendi; Etsy oranları değiştirebilir, güncel tutarı Ödeme hesabı dökümünüzden doğrulayın.

Satışa bağlı ücretler ile anlık ücretler nasıl ayrışır?

Etsy işlem, ödeme işleme, düzenleyici ücret ve Offsite Ads kesintilerini o siparişin geliriyle birlikte bekleyen bakiyede tutar, net tutarı da birlikte serbest bırakır. İlan, yenileme, Etsy Ads ve Etsy üzerinden alınan kargo etiketi gibi ücretler ise oluştuğu anda güncel bakiyeden düşülür. Dolar cinsinden sabit ücretler, yansıdığı andaki piyasa kuruyla TL'ye çevrilir. Kanalları yan yana koymak için komisyon hesaplama aracını kullanabilirsiniz.

Etsy ücretlerine KDV eklenir mi?

Türkiye, Etsy'nin satıcı ücretleri üzerinden KDV tahsil ettiği ülkeler listesindedir. Etsy hesabınıza vergi kimlik numaranızı (VAT ID) girmediyseniz uygulanabilir KDV ücretlere eklenir; girdiyseniz Etsy KDV almaz ve her ayın ilk günü bunu belirten bir fatura düzenler. Yurt dışından alınan bu hizmetin Türkiye'de nasıl beyan edileceğini mali müşavirinizle netleştirin.

Örnek hesap: 70 dolarlık bir Etsy siparişinden elinize ne kalır?

Örnek senaryo: Türkiye'deki bir satıcı el yapımı bir seramik kupayı 55 USD'ye listeliyor ve alıcıdan 15 USD kargo alıyor; ilanlar USD, banka hesabı TL. Siparişte vergi tahsil edilmediğini, ilanın tek adetli olduğunu ve satıcının Etsy'ye vergi kimlik numarası bildirdiğini varsayıyoruz. Oranlar bir önceki bölümdeki resmî tablodan alınmıştır; sonuç yalnız örnektir.

Reklamsız senaryoda kesinti sipariş tutarının yaklaşık %17,5'i, Offsite Ads'ten gelen siparişte ise %32'nin üzerindedir; buna 14 TL sabit ücret ve kargo firmasına ödediğiniz gerçek gönderi bedeli eklenir. Etsy fiyatı yurt içi fiyatınızla aynıysa reklamlı siparişte zarar edebilirsiniz. Maliyet, gönderi bedeli ve kesintileri birlikte görmek için kâr hesaplama aracını deneyin.

Etsy ödemesi ne zaman yatar? Türkiye için ödeme kuralları

Etsy'de satış geliri önce mağazanın Ödeme hesabına düşer, kesintiler burada mahsup edilir ve kalan tutar seçtiğiniz takvimle Türkiye'deki banka hesabınıza gönderilir. Etsy'ye göre yeni bir mağazada gelir genellikle satıştan 14 gün sonra ödemeye uygun hâle gelir; köklü mağazalarda bu süre, mağazanın durumuna göre bir sonraki iş gününe inebilir.

Ödeme hesabı rezervi neden uygulanır, nasıl çözülür?

Etsy, mağaza yeniyse ya da işlemlerde risk görürse fiziksel ürün satışlarının belli bir yüzdesini rezervde tutabilir. Siparişe geçerli bir takip numarası eklediğinizde ve Etsy paketin yolda olduğunu doğrulayabildiğinde o siparişin rezervi hemen serbest kalır. Etsy'ye göre çoğu satıcıda rezerv 90 gün içinde kaldırılır; Star Seller rozetli mağazalara rezerv konmaz, dijital ürün satışları da rezerve alınmaz.

• Haftalık ya da iki haftalık takvim, 42 TL'lik ödeme ücretinden kaçınmanın en basit yoludur.
• Banka bilgisini yoğun sezonda değil sakin bir dönemde güncelleyin; 5 günlük bekleme nakit akışını geciktirir.
• Aylık ekstre CSV dosyası, hangi siparişin parasının rezervde beklediğini gösterir.

Etsy entegrasyonu nasıl kurulur? OAuth izni ve bağlantı adımları

Etsy, dış yazılımların mağaza verisine erişimini Open API v3 üzerinden ve yalnız satıcının OAuth 2.0 ile verdiği izin kapsamında açar. Başka satıcıların bağlanacağı uygulamalar için Etsy'nin ticari erişim (Commercial Access) dediği seviye manuel incelemeden geçer; ekran kazıma yasaktır. Bu yüzden bağlantı bir API anahtarını kopyalayıp yapıştırarak değil, Etsy'nin kendi giriş ve onay ekranıyla kurulur ve mağaza şifreniz hiçbir aşamada istenmez.

Adım adım Etsy bağlantısı

1. Etsy mağazanızın açık, Etsy Payments kaydının ve kimlik doğrulamasının tamamlanmış olduğunu kontrol edin.
2. Yox İş Ortağım panelinde Etsy kanalını seçin; Etsy'nin giriş sayfasına yönlendirilirsiniz.
3. Etsy hesabınızla giriş yapın, onay ekranında uygulamanın istediği izinleri okuyun ve izin verin.
4. Mevcut ilanlarınız panele gelir ve barkod ya da stok koduyla ürün kartlarınıza eşleştirilir; isterseniz bu adımı birlikte yaparız.
5. Eşleşmeyi onayladıktan sonra stok, fiyat ve siparişler diğer kanallarınızla birlikte yönetilmeye başlar.

Etsy'nin izin kapsamları ve istek sınırları ne anlama gelir?

Etsy'nin geliştirici belgesinde izinler kapsamlara ayrılır: ilanları okuma ve düzenleme, satış verisini okuma ve güncelleme, mağaza bilgisini görüntüleme gibi. Etsy ayrıca her uygulamaya saniyelik ve günlük istek sınırı koyar; yüzlerce ilanın fiyatını aynı anda değiştirdiğinizde güncellemelerin Etsy'ye sırayla yansıması bundandır. Bağlı uygulamayı Etsy'de Hesap ayarları, Uygulamalar, Bağlı uygulamalar sekmesinden kaldırdığınızda erişim o andan itibaren kesilir.

Etsy stok entegrasyonunda varyasyon ve SKU eşleştirme

Etsy'de bir ilanın stoğu tek bir sayı değil, varyasyon kombinasyonlarından oluşan bir ürün listesidir. Renk ve beden içeren bir ilanda her kombinasyonun kendi fiyatı, adedi ve stok kodu (SKU) olabilir; hangi özelliğin fiyatı, adedi ya da SKU'yu belirlediğini ilan düzeyinde siz seçersiniz. Etsy stok entegrasyonunda eşleşme sorunlarının çoğu bu yapıdan doğar.

Tek bir bedenin adedi değişince ne olur?

Etsy API'sinde stok güncellemesi, ilanın bütün ürün kombinasyonlarını tek seferde yeniden göndererek yapılır; bir bedenin adedini değiştirmek, ilanın tüm ürün listesini yeniden yazmak anlamına gelir. Kombinasyonlardan biri ürün kartınızla eşleşmemişse o kombinasyonun adedi güncel kalmaz. Aynı SKU'yu paylaşan kombinasyonlarda adet de aynı olmak zorundadır; ortak SKU kullanıyorsanız bu kombinasyonların adetlerini ayrı ayrı yönetemeyeceğinizi baştan bilin.

İlan neden taslakta kalır?

Etsy, API ile oluşturulan ilanı önce taslak olarak kaydeder. Taslak için başlık, açıklama, fiyat, adet, kategori ile ürünü kimin ve ne zaman yaptığı bilgisi gerekir. Yayına almak için en az bir görsel, fiziksel üründe ayrıca kargo profili ve işlem (hazırlık) süresi profili şarttır. Bunlardan biri eksikse ilan taslakta bekler; bu profilleri Etsy panelinizde önceden tanımlayın.

Etsy siparişi, takip numarası ve yurt dışı gönderi belgeleri

Etsy'de sipariş, bir gönderim tarihi seçilip tamamlanarak kapanır ve alıcı kargo bildirimini bu tarihte alır. Gönderim tarihi en fazla 3 gün ileriye ayarlanabilir ve ABD Doğu saatine göre işler; paketi kargoya vermeden önceki bir tarih seçmek zamanında teslim oranınızı düşürebilir.

Takip numarası neden yalnız müşteri hizmeti konusu değil?

Etsy takip numarasını yalnız ABD'deki satıcılar için zorunlu tutar; ancak fiziksel ürün siparişlerinde Star Seller rozeti ve Etsy Purchase Protection için geçerli takip şartı aranır, rezervdeki paranın erken serbest kalması da takip numarasına bağlıdır. Yox İş Ortağım'da etiket basıldığında takip numarası Etsy siparişine işlenir. Yurt dışı gönderi için bağlanabilen kargo platformlarından ShipEntegra pilot aşamasındadır; kurulumu birlikte yapıp ilk gönderiyi birlikte doğruluyoruz. Paket ölçüsü için desi hesaplama aracını kullanabilirsiniz.

Mikro ihracat, ETGB ve fatura

Türkiye'den Etsy alıcısına giden paketler çoğunlukla posta ya da hızlı kargo yoluyla mikro ihracat olarak çıkar. 3 Ocak 2026 tarihli Resmî Gazete'de yayımlanan tebliğle, posta ve hızlı kargo yoluyla ihraç edilen eşyada beyanın posta idaresi ya da hızlı kargo şirketi tarafından yapılabildiği sınır brüt 600 kg ve 30.000 avroya çıkarıldı (önceki sınır 300 kg ve 15.000 avro). Siparişin belgesi bağlı muhasebe programınızdan kesilir; ayrıntıyı mali müşavirinizle şu sorularla netleştirin:

• Yurt dışındaki bireysel alıcıya hangi belge düzenlenecek?
• Faturada USD mi TL mi kullanılacak, hangi tarihin kuru esas alınacak?
• Etsy'nin kestiği ücretler ve varsa bu ücretlere eklenen KDV muhasebede nasıl kaydedilecek?
• Kargo firmanız elektronik ticaret gümrük beyannamesini (ETGB) sizin adınıza düzenliyor mu?

Etsy entegrasyonu hangi Yox İş Ortağım paketinde yer alır?

Etsy, Yox İş Ortağım'ın Başlangıç paketinde yer almaz; Büyüme paketinden itibaren seçilebilir. Başlangıç paketi yalnız yedi yurt içi pazaryerinden birini (Trendyol, Hepsiburada, n11, Çiçeksepeti, Pazarama, PttAVM, idefix) kapsar. Panelde 80 satış kanalı tanımlıdır ve bunların 48'i kullanıma hazırdır; Etsy hazır kanallardan biridir. Bütün limitlerin karşılaştırması paketler ve fiyatlar bölümünde.

Yıllık ödemede %20 indirim uygulanır. Etsy siparişinin belgesini bağlı muhasebe programından kesmek istiyorsanız e-Fatura bağlantısının Profesyonel paketle başladığını hesaba katın. Etsy'nin ilan, işlem ve ödeme ücretleri bu paket ücretinden ayrıdır ve Etsy tarafından kesilir.

Etsy entegrasyonunu canlıya almadan önce kontrol listesi ve sık hatalar

Bağlantıyı açmadan önce yapılacak birkaç kontrol, ilk haftalardaki iptal ve eşleşme sorunlarının çoğunu önler. Listeyi Etsy paneliniz açıkken gözden geçirin:

• Her varyasyon kombinasyonunda SKU dolu mu, aynı kod yanlışlıkla iki farklı ürüne verilmiş mi?
• Tek parça ve vintage ürünlerin adedi 1 mi, ürün kartına bağlı mı?
• Etsy fiyatı, %17'yi aşan kesinti ve olası Offsite Ads payı hesaba katılarak kanal bazında ayrı bir kurala bağlandı mı?
• İşlem süresi profili gerçek hazırlık sürenizle uyumlu mu?
• Ödeme takvimi 42 TL'lik ödeme ücretine takılmayacak biçimde seçildi mi?
• Vergi kimlik numarası Etsy'ye girildi mi, mali müşaviriniz yurt dışı satış belgesi konusunda bilgilendirildi mi?

En sık yapılan hata, yurt içi kanaldaki fiyatı Etsy'ye aynen taşımaktır; Türkiye'ye özgü ödeme işleme ve düzenleyici ücretler hesaba katılmazsa kâr kâğıt üzerinde kalır. Kendi ürünlerinizle eşleşmeyi görmek için Yox İş Ortağım'a başvurun; 3 günlük ücretsiz denemede ilanlarınız panele okunur ve siz onaylamadan Etsy'de hiçbir şey değişmez. Ön görüşme ya da kurulum desteği için iletişim sayfasından bize ulaşabilirsiniz.