Pazaryeri Entegrasyonu ve Sanal POS API Mimarisi Rehberi

Pazaryeri entegrasyonu ve sanal POS mimarisi; Trendyol, Hepsiburada, Amazon gibi satış kanalları ile işletmenizin ana veritabanı ve banka ödeme geçitleri arasındaki veri transferini çift yönlü, anlık ve asenkron yürüten dağıtık yazılım katmanıdır. Temel işlevi; stok sapmalarını (overselling), mükerrer tahsilatları ve manuel sipariş işleme gecikmelerini sıfırlayarak operasyonel verimliliği milisaniyeler seviyesinde güvenceye almaktır.

Çok kanallı e-ticarette yüksek trafikli kampanya dönemlerinde sistemlerin ayakta kalabilmesi, geleneksel monolitik cron işleriyle mümkün değildir. Sipariş çekme, stok rezervasyonu ve faturalandırma adımlarının her biri; API hız limitlerine (rate limiting), ağ kesintilerine ve eşzamanlı (concurrency) veri yarışlarına duyarlıdır.

1. 1Webhook Dinleyicileri ve HMAC-SHA256 İmza Doğrulama: Geleneksel polling yerine modern sistemler durum değişikliklerini webhook ile anında bildirir. timingSafeEqual fonksiyonu ile zamanlama saldırılarına karşı korunan HMAC-SHA256 doğrulaması yapılır ve anında Fast-ACK (HTTP 200) dönülür.
2. 2API Hız Limitleri ve Exponential Backoff: Trendyol veya Amazon API limitleri aşıldığında (HTTP 429), işçiler Token Bucket algoritması ve rastgele zaman farkı eklenmiş üstel geri çekilme (Exponential Backoff with Jitter) ile yeniden dener.
3. 3Dağıtık Kuyruk Sistemleri (BullMQ / Redis): Sipariş çekme, stok eşitleme, e-fatura ve kargo barkodu adımları bağımsız kuyruklara bölünür. 3 denemeden sonra çözülemeyen işler Dead Letter Queue (DLQ) katmanına aktarılır.
4. 4Idempotency ve Satır Kilitleme (SELECT FOR UPDATE): Mükerrer ödeme bildirimlerinde çift çekim veya çift sipariş oluşmasını önlemek için benzersiz Idempotency-Key ve veritabanı seviyesinde row-level lock uygulanır.

1. 1API Kimlik Doğrulaması ve TLS 1.3: Pazaryeri sağlayıcılarının OAuth2 veya API Key/Secret protokolleri test edilir ve IP whitelisting ile güvenceye alınır.
2. 2Diferansiyel Stok Senkronizasyonu (Delta Sync): Tüm kataloğu göndermek yerine yalnızca stoğu değişen ürünlerin anlık delta paketleri kanallara iletilir.
3. 3Sipariş Çekme ve Normalizasyon: Farklı pazaryerlerinden gelen ham JSON verileri standart bir OrderDTO formatına dönüştürülerek depoya aktarılır.
4. 43D Secure ve Sanal POS Entegrasyonu: PayTR, iyzico veya banka API'leri üzerinden güvenli ödeme oturumu ve hash doğrulamalı IPN callback süreci tamamlanır.
5. 5Kargo ve E-Fatura API Tetikleme: Sipariş onaylandığında Gelir İdaresi Başkanlığı UBL-TR formatında e-fatura ve kargo barkodu otomatik basılır.
6. 6Telemetri ve Hata Alarmları: Correlation ID ile tüm akışlar Sentry ve merkezi log sunucusuna bağlanır.

Sanal POS entegrasyonunda 3D Secure nasıl çalışır?

Kullanıcı kart bilgilerini girdikten sonra bankanın SMS onay sayfasına yönlendirilir. Banka işlemi onayladığında işletmenizin callback URL'ine HMAC imzalı bir bildirim gönderir. Yazılım bu imzayı doğrulayarak siparişi kesinleştirir.

Pazaryerlerinde stok senkronizasyonu kaç saniyede tamamlanmalıdır?

Kritik stok seviyesindeki ürünlerde stok güncellemesi 2 ila 5 saniye arasında pazaryerine iletilmelidir. 10 dakikayı aşan cron tabanlı güncellemeler kampanya dönemlerinde çift siparişe (overselling) yol açar.

Flash sale dönemlerinde sistemin çökmesi nasıl engellenir?

Sipariş kayıt işlemleri doğrudan veritabanına yazılmak yerine Redis tabanlı kuyruklara (BullMQ) alınır. Kuyruk işçileri veritabanının kaldırabileceği kontrollü eşzamanlılıkla (concurrency) verileri işler.