Yapı Kredi WooCommerce sanal POS (Posnet) entegrasyonu

Bir bakışta

Altyapı

Posnet (Yapı Kredi’nin XML servisi ve 3D Secure sayfası).

Ödeme akışı

Kart mağazanızın formunda girilir; Invum POS Posnet’ten şifreli bir ödeme paketi alır, müşteri Yapı Kredi’nin 3D ekranında doğrular, dönüşte doğrulama çözülür ve provizyon sunucudan alınır (3D Model).

Taksit

Var; World kartlar için ayrı oran tanımlanabilir.

Kapsam dışı

World puan kullanımı gibi Posnet’e özel ek ödeme seçenekleri eklentide yok.

Gereken plan

Pro (₺3.500/yıl, KDV dahil) ya da üstü.

Yapı Kredi’ye başvuru

Yapı Kredi’nin Üye İşyeri / POS Başvurusu sayfasında üye işyeri başvurularının Yapı Kredi Mobil ve Kurumsal İnternet Şubesi üzerinden online tamamlanabildiği anlatılıyor. Sanal POS için başvururken e-ticaret (Posnet) sanal POS istediğinizi, 3D Secure kullanacağınızı ve taksitli satış yapıp yapmayacağınızı belirtin. Sitenizin SSL ile yayında olması ve satılacak ürünlerin fiyatlarıyla hazır bulunması başvurunun değerlendirilmesinde beklenir.

Komisyon, blokaj ve ücretler sözleşmenize göre belirlenir; güncel koşulları bankanızdan öğrenin.

Yapı Kredi’den alacağınız bilgiler

Posnet’te ayrı bir API kullanıcı adı ve şifresi yoktur; üye işyeri ve terminal numarası ile anahtar birlikte kimliği oluşturur. Sunucunuzun çıkış IP’sinin bankada tanımlanması istenirse hosting firmanızdan IP adresini öğrenip bankaya iletin.

Invum POS’ta kurulum

1. Pro planını satın alın, eklentiyi Hesabım › İndirmeler’den kurup lisansı etkinleştirin.
2. Invum POS › POS Hesapları › Yeni POS Hesabı Ekle yolunu izleyin.
3. Sağlayıcı olarak Yapı Kredi (Posnet)‘i seçin, Hesap Etiketi yazın.
4. MID, TID, Posnet ID ve ENCKEY’i tablodaki alanlara girin.
5. Test bilgileriyle başlıyorsanız Test Modu açık kalsın.
6. “Etkin — ödeme sayfasında sunulsun” ve gerekiyorsa “Varsayılan hesap” bayraklarını açın, taksit oranlarını girin, POS Hesabını Kaydet‘e basın.
7. Bağlantıyı test et düğmesini kullanın. Posnet’in sorgu servisi olmadığı için test, var olmayan bir işleme geçersiz bir iptal isteği gönderir; banka önce MID ve TID’i kontrol ettiği için kimlik bilgileri gerçek bir işleme dokunmadan sınanır.

Test ortamı ve canlıya geçiş

Test Modu açıkken Invum POS, Yapı Kredi’nin Posnet test sunucusuna bağlanır. Test MID, TID, Posnet ID, anahtar ve test kartlarını Yapı Kredi’den isteyin. Test siparişinde Yapı Kredi’nin 3D ekranı açılmalı, doğrulamadan sonra sipariş onay sayfasına dönülmeli ve sipariş ödendi olarak işaretlenmeli.

Canlıya geçişte dört bilginin canlı karşılığını girip Test Modu’nu kapatın, ardından küçük tutarlı bir gerçek ödeme yapın ve Posnet üye işyeri ekranından kontrol edin.

World taksitleri ve BDDK sınırları

Yapı Kredi’nin kart programı World’dür. Invum POS’un Taksit Oranları tablosundaki World sekmesinde bu kartlara özel vade farkı girebilir, diğer kartlarda Genel oranları kullanabilirsiniz. Seçilen taksit sayısı Posnet’e ödeme paketiyle birlikte gider. Oranları sözleşmenizdeki komisyon tablosundan alın; müşteriye yansıyacak tutarı komisyon hesaplama aracında görün.

BDDK’nın ürün grubuna göre koyduğu azami taksit sayıları Taksit Uyumu ayarlarıyla otomatik uygulanır; bkz. BDDK taksit sınırları.

Posnet’te sık hatalar

• “Format hatası” ya da kimlik reddi: MID/TID yanlış girilmiş ya da Test Modu bilgilerle uyuşmuyor.
• 3D dönüşünde doğrulama hatası: ENCKEY (Store Key) ya da Posnet ID yanlış (ERR_3DS_CALLBACK_INVALID).
• 3D doğrulaması başarısız: Posnet doğrulama sonucunu mdStatus ile verir. Invum POS 1 (tam) ve 2–4 (kısmi) sonuçlarda provizyonu bankaya sorar; diğer sonuçlarda ödemeyi reddeder. Kodların anlamları POS ve banka hata kodları yazısında.
• Bankaya ulaşılamıyor: sunucunuzun IP adresi bankada tanımlı değil ya da dış bağlantı engelli (ERR_CHARGE_FAILED).

İade ve iptal

Eklentinin güncel sürümünde sipariş ekranındaki İade düğmesi iadeyi doğrudan Yapı Kredi’ye gönderir: ödemeyle aynı gün tutarın tamamı iptal (reverse), kısmi tutar ya da sonraki günler iade (return) olarak gider; banka iptali reddederse normal iadeye geçilir. Banka bir iadeyi reddederse nedeni sipariş notuna yazılır; o durumda iadeyi Yapı Kredi üye işyeri ekranından yapıp WooCommerce siparişinde kaydedin. Posnet’in durum sorgulama servisi olmadığı için yarım kalan ödemeler panelden kontrol edilmelidir.