Turkpin API entegrasyonu, e-pin satış scriptinizin Turkpin tedarikçisine doğrudan bağlanmasını sağlar. Müşteri ürünü satın aldığında, Pinova otomatik olarak Turkpin'den kodu çeker ve saniyeler içinde teslim eder.
Böylece stok takibi, manuel kod girişi ve gece nöbeti biter. Bu sayfada Turkpin entegrasyonunun ne işe yaradığını, nasıl çalıştığını ve Pinova'da nasıl kurulduğunu anlatıyoruz.
- Pinova, Turkpin API'sine bağlanarak e-pin stoklarını ve fiyatlarını otomatik olarak çeker.
- Sipariş geldiğinde kod tedarikçiden anlık alınır ve müşteriye saniyeler içinde teslim edilir; manuel işlem gerekmez.
- Turkpin'in yanı sıra Pinabi gibi ek tedarikçi konnektörleri de hazır gelir.
- API bilgileri yönetim panelinden girilir, teknik kod bilgisi gerektirmez.
- Stok tükendiğinde ürün otomatik pasife alınır, böylece boş sipariş oluşmaz.
Yeni: Turkpin Mağazası (v2.6.6+)
Turkpin Mağazası, Turkpin bayi hesabınızdaki tüm kataloğu tek tıkla sitenize kurar. Pinova ve Pazarova'da dahili gelir; ek ücret yoktur.
- Tek tıkla katalog: Turkpin bayi hesabınızı bağlayın; 870+ oyunun ürünleri “Turkpin'deki Tüm Ürünleri Ekle” ile tek tıkla ya da seçerek aktarılır. Kategori, ürün ve Turkpin oyun görselleri otomatik oluşur. Gerçek testte 870 oyun / 5.295 ürün yaklaşık 6 dakikada aktarıldı.
- Anında otomatik teslim: satılan ürünün kodu Turkpin'den anında çekilip müşteriye teslim edilir.
- Otomatik fiyat: satış fiyatı = Turkpin maliyeti + kâr kuralı. Kural genel, kategori ya da oyun bazında yüzde, sabit tutar ve yuvarlama ile tanımlanır; istediğiniz üründe fiyat kilidi kullanılır. Turkpin'de fiyat veya stok değişince site kendiliğinden güncellenir.
- Bakiye bekçisi: Turkpin bakiyeniz belirlediğiniz eşiğin altına inince uyarı alırsınız; bakiye yüklendiğinde bekleyen siparişler otomatik teslim edilir. Ön sipariş takibi ve sipariş başına kâr raporu da panelde.
- Eşleştirme ve geri alma: mevcut ürünlerinizi Turkpin ürünleriyle tek tıkla eşleştirebilir, “Tümünü Sil” ile aktarılan ürünleri geri alabilirsiniz.
- Pazarova'da: Turkpin yalnız site ürünlerinde çalışır; satıcı ilanları etkilenmez.
Turkpin entegrasyonu ne işe yarar?
- Otomatik tedarik: sipariş anında kod Turkpin'den çekilir.
- Sıfır stok derdi: ürünü önceden yüklemenize gerek kalmaz.
- Anlık fiyat senkronu: tedarikçi fiyatı güncel kalır, kâr marjınızı siz belirlersiniz.
- 7/24 satış: siz uyurken bile teslimat otomatik akar.
Manuel stok vs Turkpin API (karşılaştırma)
| Manuel stok | Turkpin API (Pinova) | |
|---|---|---|
| Kod yükleme | Elle, tek tek | Otomatik, sipariş anında |
| Stok tükenmesi | Sık, satış kaçar | Neredeyse hiç |
| Gece satışı | Bekler | Anında teslim |
| Fiyat güncelleme | Elle | Senkron |
| İş yükü | Yüksek | Sıfıra yakın |
Nasıl çalışır? (akış)
- Müşteri üründen sipariş verir ve ödemeyi yapar.
- Pinova, Turkpin API'sine istek gönderir.
- Turkpin kodu döner, Pinova müşteriye anında teslim eder.
- Stok, sipariş ve fatura kaydı otomatik oluşur.
Sadece Turkpin değil
Pinova, Turkpin'in yanı sıra Pinabi ve diğer tedarikçi API'leriyle de çalışır. Birden fazla tedarikçiyi bağlayıp en uygun fiyatlıdan otomatik tedarik edecek şekilde kurgulayabilirsiniz. Genişletilebilir konnektör yapısı sayesinde yeni tedarikçiler de eklenebilir.
Not: Turkpin bayilik başvurusu ve API anahtarını aldıktan sonra, entegrasyonu Pinova panelinden birkaç dakikada bağlarsınız. İstenirse kurulumu biz yaparız.
Turkpin API entegrasyonu nasıl çalışır?
API entegrasyonunun temel fikri şudur: ürünü kendi katalogunuzda tutarsınız, ama kodu satış anında tedarikçiden çekersiniz. Müşteri ödemeyi tamamladığında Pinova, Turkpin API'sine o ürün için sipariş isteği gönderir; API kodu döndürür ve sistem bunu müşteriye teslim eder. Böylece elinizde fiziksel kod stoğu bulundurmadan, tedarikçinin stoğu üzerinden satış yaparsınız.
Bu model, kod tükenme riskini azaltır çünkü stok tedarikçi tarafında yönetilir. Buna karşılık, tedarikçi geçici olarak yanıt vermezse siparişin bekleyen durumda tutulması ve daha sonra tekrar denenmesi gibi bir hata yönetimi gerekir.
Stok ve fiyat senkronu
API entegrasyonlarında iki bilgi sürekli güncel tutulmalıdır: hangi ürün stokta var ve maliyeti ne. Pinova, Turkpin katalogundaki stok/fiyat bilgisini periyodik olarak eşitleyerek, tükenen ürünü otomatik "stokta yok" gösterir ve maliyet değiştiğinde kâr marjınızı korumanıza yardımcı olur. Fiyatı sabit tutmak yerine tedarikçi maliyeti üzerine yüzdesel marj tanımlamak, ani maliyet değişimlerinde manuel güncelleme yükünü azaltır.
Hata yönetimi ve kurulum adımları
Sağlam bir API entegrasyonunda ele alınması gereken durumlar genellikle şunlardır: tedarikçi yanıt gecikmesi, geçici stok tükenmesi, geçersiz istek ve bakiye yetersizliği. Bu senaryolarda ödeme alınmış ama kod gelmemişse, sistemin siparişi otomatik iade veya bekleyen teslimat olarak işaretlemesi önemlidir. Kurulum tarafında ise akış tipik olarak şu adımları izler:
- Turkpin bayi hesabı ve API anahtarının alınması,
- API bilgilerinin Pinova paneline girilmesi,
- Ürün eşleştirme (Turkpin ürünü ↔ sitenizdeki ürün),
- Test siparişiyle uçtan uca doğrulama.
Bu kurulumu biz yaparız. Katalogu hazır bir paket isterseniz Turkpin entegreli hazır script, alternatif tedarikçi için Pinabi API entegrasyonu sayfalarına bakabilirsiniz. Genel yapı için e-pin satış scripti sayfası yardımcı olur.
API mi, manuel kod havuzu mu? Ne zaman hangisi?
Turkpin API entegrasyonu her işletme için tek doğru cevap değildir; seçim, katalog büyüklüğü ve tedarik tercihinize bağlıdır. Manuel kod havuzu, elinizde toptan aldığınız kodlar varsa ve marjı kendiniz belirlemek istiyorsanız mantıklıdır; stok sizde olduğu için tedarikçiye bağımlılık olmaz. API ise geniş katalog ve sürekli stok isteyenler için avantajlıdır; kodu satış anında çektiği için tükenme riskini azaltır.
Çoğu büyüyen işletme ikisini birlikte kullanır: çok satan ürünlerde kendi kod havuzu, uzun kuyruktaki çeşitlilik için API. Pinova her iki modeli aynı katalogda desteklediği için, ürün bazında hangi yöntemin kullanılacağını seçebilirsiniz.
Performans ve süreklilik
API tabanlı satışta teslimat hızı, tedarikçinin yanıt süresine bağlıdır; bu genellikle saniyeler içindedir. Yine de tedarikçi tarafında anlık bir kesinti olabileceğinden, ikinci bir kaynak (örneğin Pinabi) tanımlamak süreklilik açısından önerilir. Pinova, öncelikli tedarikçi yanıt vermediğinde alternatife düşme kurgusuyla bu riski azaltır.
Sıkça Sorulan Sorular
Turkpin API entegrasyonu nedir?
E-pin scriptinizin Turkpin'e bağlanıp sipariş anında kodu otomatik tedarik edip teslim etmesidir.
Pinova'da Turkpin hazır mı geliyor?
Evet, Turkpin API konnektörü hazır gelir; sadece kendi API anahtarınızı girmeniz yeterli.
Birden fazla tedarikçi bağlayabilir miyim?
Evet, Turkpin + Pinabi ve diğer tedarikçileri aynı anda bağlayabilirsiniz.
Stok yüklemem gerekiyor mu?
API'li ürünlerde hayır; sipariş anında otomatik tedarik edilir. Dilerseniz manuel stok da yükleyebilirsiniz.
Turkpin bayiliği nasıl alınır?
Turkpin'e bayilik başvurusu yapıp API bilgilerinizi alırsınız; ardından Pinova paneline girersiniz.
Fiyat farkını nasıl belirlerim?
Tedarikçi fiyatının üzerine kendi kâr marjınızı ekleyerek satış fiyatını panelden ayarlarsınız.
Turkpin'deki tüm ürünleri siteme tek seferde aktarabilir miyim?
Evet. v2.6.6 ve sonrasında gelen Turkpin Mağazası ile “Turkpin'deki Tüm Ürünleri Ekle” düğmesi kataloğun tamamını (870+ oyun) kategori, ürün ve görselleriyle aktarır; dilerseniz yalnız seçtiğiniz oyunları ekleyebilirsiniz. Gerçek testte 5.295 ürün yaklaşık 6 dakikada aktarıldı.
Turkpin fiyatı değişince sitemdeki fiyatlar güncellenir mi?
Evet. Satış fiyatı Turkpin maliyeti üzerine tanımladığınız kâr kuralıyla (yüzde, sabit tutar, yuvarlama) hesaplanır ve Turkpin'de fiyat ya da stok değişince site kendiliğinden güncellenir. Fiyat kilidi koyduğunuz ürünler değişmez.