Otomatik Tedarikçi API Bağlantısı Olan E-Pin Yazılımı Kurulumu: Elle Kod Girmeye Son mu?

Bir e-pin sitesi işletiyorsanız şu sahneyi çok iyi bilirsiniz: Gece yarısı gelen bir sipariş bildirimi, yarım saat sonra "kodum hâlâ gelmedi" diyen bir müşteri mesajı ve tedarikçi panelinde tek tek kod arayan siz. Peki bu döngüyü tamamen ortadan kaldıran, siparişi saniyeler içinde otomatik teslim eden bir sistem gerçekten mümkün mü? Cevap evet — ve bunun anahtarı tedarikçi API bağlantısıdır.

Bu yazıda otomatik tedarikçi API'sinin ne işe yaradığını, Pinova'da bu bağlantının nasıl kurulduğunu ve manuel çalışan bir siteden otomatik teslimat yapan bir yapıya geçişin pratikte ne anlama geldiğini adım adım anlatıyoruz.

Manuel stok yönetimi sizi neden yoruyor, farkında mısınız?

E-pin ve dijital ürün satan neredeyse her site, belli bir noktada aynı duvara çarpar: sipariş sayısı arttıkça elle kod girme işi sürdürülebilir olmaktan çıkar. Bir çalışan (çoğu zaman site sahibinin kendisi) tedarikçi panelinden kod çekip müşteriye e-posta veya panel üzerinden iletmek zorunda kalır. Bu, hem yavaş hem de hataya son derece açık bir süreçtir.

• Gece saatlerinde gelen siparişler sabaha kadar bekletilir, müşteri iade talep eder.
• Yanlış kod kopyalanır, aynı kod iki farklı müşteriye gönderilir.
• Stok tükenmiş bir ürün sitede hâlâ "satışta" görünür, sipariş alınır ama teslim edilemez.
• Fiyat güncellemeleri elle takip edilemediği için tedarikçi zam yaptığında zararına satış devam eder.

Bu sorunların hepsi aslında tek bir kök nedene bağlanır: site ile tedarikçi arasında gerçek zamanlı, otomatik bir bağlantı yoktur. Tedarikçi API entegrasyonu tam olarak bu boşluğu kapatır.

Tedarikçi API'si arka planda gerçekte ne yapıyor?

API (Application Programming Interface), sizin siteniz ile tedarikçinin (örneğin Turkpin veya Pinabi) sistemi arasında kurulan, iki tarafın da anlayabileceği bir "konuşma dilidir". Müşteri sitenizde bir ürün satın aldığında, sipariş otomatik olarak tedarikçiye iletilir; tedarikçi kodu üretir veya stoktan çeker, yanıtı geri gönderir ve sistem bu kodu müşteriye anında teslim eder. Tüm bu döngü genellikle birkaç saniye içinde tamamlanır.

Pinova'da bu akış üç temel katmanda çalışır:

• Stok senkronizasyonu: Tedarikçideki ürün stoku ve fiyatı belirli aralıklarla otomatik çekilir, sitenizdeki ürün kartına yansır.
• Sipariş iletimi: Ödeme onaylandığı anda sipariş bilgisi API üzerinden tedarikçiye gönderilir.
• Otomatik teslimat: Tedarikçiden dönen kod, müşteri paneline ve isterseniz e-posta/SMS bildirimine otomatik işlenir.

Yani siz manuel olarak hiçbir kod kopyalamaz, hiçbir stok tablosu güncellemezsiniz — sistem bunu sizin adınıza, 7/24 yapar.

Turkpin ve Pinabi arasında hangi fark işinizi etkiler?

Türkiye pazarında e-pin tedarikçisi denince akla gelen iki büyük isim Turkpin ve Pinabi'dir. İkisi de geniş ürün yelpazesi sunar (oyun kodları, dijital hediye kartları, VP/UC gibi oyun içi para birimleri) ama entegrasyon mantıkları ve ürün çeşitliliği açısından farklılaşırlar.

• Turkpin, özellikle popüler oyun platformları ve geniş bir bayi ağı ile bilinir; API dokümantasyonu XML/JSON tabanlı standart isteklerle çalışır.
• Pinabi ise daha esnek stok sorgulama ve kategori bazlı filtreleme sunar, bazı niş ürünlerde Turkpin'e göre daha geniş kapsam sağlayabilir.
• Her iki tedarikçi de fiyat listesi güncellemesini API üzerinden anlık paylaşır — bu da sitenizde otomatik kâr marjı hesaplamasını mümkün kılar.

Pinova, her iki tedarikçiyle de doğrudan konuşabilecek şekilde tasarlanmıştır; yani tek bir panelden hem Turkpin hem Pinabi ürünlerini aynı anda satabilir, hangi tedarikçinin hangi ürünü daha ucuza sattığını karşılaştırarak otomatik yönlendirme bile yapabilirsiniz.

Pinova'da API bağlantısı kurulurken sırasıyla ne yapılır?

Kurulum, teknik bilgi gerektiren karmaşık bir süreç gibi görünse de Pinova'da adımlar önceden tanımlanmış ve panel üzerinden yürütülebilir hale getirilmiştir. Genel akış şu şekildedir:

• 1. Tedarikçi hesabı ve API anahtarı: Turkpin veya Pinabi'de bayi hesabınız üzerinden API kullanıcı adı, şifre ve/veya token bilgisi alınır.
• 2. Panelde tedarikçi tanımlama: Pinova yönetim panelinden ilgili tedarikçi seçilir, API bilgileri girilir ve bağlantı test edilir.
• 3. Ürün eşleştirme: Tedarikçideki ürün kataloğu çekilir; hangi ürünlerin sitenizde satılacağı, hangi kategoriye gireceği seçilir.
• 4. Kâr marjı ve fiyat kuralı belirleme: Ürün bazlı veya kategori bazlı otomatik kâr marjı yüzdesi tanımlanır, tedarikçi fiyatı değiştikçe satış fiyatı da otomatik güncellenir.
• 5. Teslimat kuralı tanımlama: Kodun müşteriye nasıl iletileceği (panel, e-posta, her ikisi) belirlenir.
• 6. Test siparişi: Küçük tutarlı gerçek bir siparişle uçtan uca akış doğrulanır.

Bu adımların tamamı genellikle bir iş günü içinde tamamlanır; teknik ekibiniz yoksa Pinova kurulum desteğiyle süreç sizin adınıza yürütülebilir.

Otomatik teslimat sırasında hata veya iade olursa ne olur?

Otomasyona geçen site sahiplerinin en çok merak ettiği konu budur: "Sistem hata yaparsa kim sorumlu olacak, iade nasıl işleyecek?" Gerçek şu ki otomatik sistemler, doğru kurulduğunda manuel süreçten çok daha az hata üretir — ama sıfır risk yoktur, bu yüzden güvenlik katmanları önemlidir.

• Stok senkronizasyon gecikmesi: Tedarikçide stok bittiği anda site anlık olarak "tükendi" durumuna geçmeyebilir. Pinova bunun için kısa aralıklı otomatik kontrol ve sipariş öncesi son doğrulama yapar.
• API zaman aşımı: Tedarikçi sunucusu yanıt vermezse sipariş "beklemede" statüsüne alınır, otomatik yeniden deneme mekanizması devreye girer; müşteri mağdur edilmeden işlem tamamlanır.
• Geçersiz kod bildirimi: Müşteri kodun çalışmadığını bildirirse, admin panelinden tek tıkla tedarikçiye iade/değişim talebi açılabilir.
• Log ve izlenebilirlik: Her API isteği ve yanıtı kayıt altına alınır; hangi siparişte hangi kodun, hangi saatte gönderildiği geriye dönük sorgulanabilir.

Kısacası otomasyon, hataları yok etmez ama hataları görünür, izlenebilir ve hızlı çözülebilir hale getirir — manuel sistemde ise çoğu hata ancak müşteri şikayet ettikten sonra fark edilir.

Manuel siteden API'li sisteme geçiş gerçekten kaç günde biter?

Bu sorunun cevabı sitenizin büyüklüğüne ve mevcut altyapınıza göre değişir ama genel bir çerçeve vermek gerekirse geçiş süreci üç aşamada ilerler.

• Hazırlık (1-2 gün): Tedarikçi bayi hesabı ve API bilgilerinin temin edilmesi, ürün listesinin çıkarılması.
• Kurulum ve eşleştirme (1-3 gün): Pinova panelinde tedarikçi tanımlama, ürün eşleştirme, fiyat kuralı ayarları.
• Test ve canlıya alma (1 gün): Uçtan uca test siparişleri, teslimat akışının doğrulanması, canlıya geçiş.

Ortalama bir e-pin sitesi için bu süreç 3-6 iş günü içinde tamamlanabilir. Maliyet tarafında ise en büyük değişken tedarikçinin kendi bayi/API erişim koşullarıdır; Pinova tarafında entegrasyon kurulum desteği yazılım paketine dahildir, ayrıca bir "entegrasyon ücreti" ile karşılaşmazsınız.

Geçiş sonrası en çok konuşulan gözlem, personel bağımlılığının azalması ve gece/tatil satışlarının artık kayıpsız tahsil edilmesidir — çünkü artık kimsenin bilgisayar başında bekleme zorunluluğu yoktur.