Yerli Kart Özelleştirme – TR.O.Y. Desteği

Troy (Türkiye’nin yerli kart şeması) kart kullanıcılarına özel olarak sadece kredi kartı ile ödeme yapılmasını sağlar. Visa ve Mastercard gibi diğer kartlar ile ödeme yöntemini engeller.
Yönetim panelinden Troy kartlara özel indirim tanımlayabilir veya ödemeleri sadece Troy kartlarla sınırlandırabilirsiniz.
Eklenti, Yüksek Performanslı Sipariş Depolama (HPOS) ile tam uyumludur.

Özellikler:

• HPOS Uyumlu: En modern WooCommerce altyapılarıyla sorunsuz çalışır.
• Kolay Kurulum: Kuralları uygulamak istediğiniz ödeme yöntemini listeden seçmeniz yeterli. Koda müdahale gerekmez.
• Esnek Modlar: Sadece indirim, sadece kısıtlama veya her ikisini birden seçme.
• Dinamik İndirim: Yüzdesel (%) veya Sabit Tutar (₺) olarak indirim tanımlama.
• Tam Entegre: Tüm ayarlar WooCommerce > Ayarlar > Ödemeler > Troy’a Özel Ayarlar paneline entegredir.
• Özelleştirilebilir Mesajlar: Hata ve indirim metinlerini kendiniz belirleyin.

1. Eklenti dosyalarını wp-content/plugins/troy-odeme-indirimi klasörüne yükleyin veya WordPress eklenti panelinden zip dosyasını yükleyin.
2. Eklentiyi ‘Eklentiler’ menüsünden etkinleştirin.
3. Ayarları yapılandırmak için WooCommerce > Ayarlar > Ödemeler > Troy’a Özel Ayarlar sekmesine gidin.
4. “Hedef Ödeme Yöntemi” listesinden GPOS sanal posunuzu seçin ve diğer ayarları yapılandırıp kaydedin.

YARDIM DOKÜMANI: “Ödeme Öncesi Kontrol Kancası (Hook)” Ayarı
Bu Ayar Nedir ve Neden Gerekli?
WordPress ve WooCommerce, eklentilerin birbiriyle konuşmasını ve belirli olaylar gerçekleştiğinde birbirlerini haberdar etmesini sağlayan “kanca” (hook) adı verilen bir sistem kullanır.
Bizim eklentimiz, bir müşterinin ödeme yapmasını engellemek için, sanal pos eklentinizin tam olarak şu anda bir sinyal göndermesine ihtiyaç duyar: “Müşteri ‘Ödeme Yap’ butonuna bastı, kart bilgilerini aldım ama henüz bankaya göndermedim.”
İşte bu kritik andaki sinyale “Ödeme Öncesi Kontrol Kancası” diyoruz.
Sorun şudur: Her sanal pos (GPOS, Iyzico, PayTR, vb.) eklentisi, bu sinyali farklı bir isimle yayınlar.
Bizim eklentimizin kısıtlama özelliğinin çalışabilmesi için, sizin kullandığınız sanal pos eklentisinin yayınladığı doğru sinyal adını bilmesi gerekir.
Bu ayar, eklentimize doğru “frekansı” ayarlama imkanı verir.

Kısacası: Bu alana yanlış bir isim girilirse, indirim özelliği çalışmaya devam eder ancak “Sadece Troy Kartlara İzin Ver” özelliği çalışmaz.
Doğru Hook Adını Nasıl Bulurum?
Doğru kanca adını bulmak için aşağıdaki yöntemleri, en kolaydan en teknik olana doğru deneyebilirsiniz.
Yöntem 1: Eklenti Dokümantasyonunu Kontrol Etmek (En Kolay Yöntem)
Kullandığınız sanal pos eklentisinin resmi web sitesine, yardım veya dokümantasyon sayfalarına gidin.
“Geliştirici”, “Developer”, “API”, “Action Hooks” veya “Kancalar” gibi başlıklar altında arama yapın.
Geliştiriciler genellikle diğer eklentilerin kendi eklentileriyle entegre olabilmesi için bu kanca adlarını listelerler.
Yöntem 2: Sanal Pos Eklentisinin Destek Ekibine Sormak (Önerilen Yöntem)
Sanal pos sağlayıcınızın destek ekibiyle iletişime geçerek aşağıdaki gibi bir e-posta gönderebilirsiniz.
Bu, genellikle en hızlı ve en doğru sonucu verir.

Örnek Destek Mesajı:

Konu: WooCommerce Eklentisi için Action Hook Bilgisi

Merhaba,

Sitenizde kullandığımız [Buraya Sanal Pos Eklentinizin Adını Yazın] WooCommerce eklentinizle entegre olacak özel bir eklenti geliştiriyoruz.
Ödeme işlemi başlamadan hemen önce, ancak kart bilgileri alındıktan sonra tetiklenen “action hook” adını öğrenebilir miyim?
Örneğin, gpos_before_process_payment veya [eklenti_adi]_before_payment gibi bir isim arıyorum.

Yardımlarınız için teşekkür ederim.
Yöntem 3: Eklenti Kodlarını İncelemek (Teknik Kullanıcılar İçin)
Eğer kod okumaya aşinaysanız, doğru kanca adını kendiniz bulabilirsiniz:

WordPress Admin panelinizden Eklentiler > Eklenti Dosya Düzenleyicisi’ne gidin.
Sağ üstteki “Düzenlenecek eklentiyi seçin:” açılır menüsünden sanal pos eklentinizi seçin ve “Seç” butonuna tıklayın.
Eklenti dosyaları listelendiğinde, klavyenizden Ctrl + F (veya Mac’te Cmd + F) tuşlarına basarak arama kutusunu açın.
Arama kutusuna do_action( yazarak aratın.

Arama sonuçlarında, ödeme süreciyle ilgili dosyalarda (process-payment.php, class-gateway.php vb.) bulunan do_action(‘….’) satırlarını inceleyin. Genellikle aradığınız kanca adı, before_process, before_payment, pre_payment gibi ifadeler içerir.

Örnek Kod:

PHP

// Sanal pos eklentisinin kodunda şöyle bir satır görebilirsiniz:
do_action( ‘paytr_before_payment_request’, $order_id, $request_params );
Bu durumda, bizim eklentimizdeki ayar alanına girmeniz gereken doğru ad: paytr_before_payment_request olacaktır.

Popüler Türk Sanal Pos Eklentileri için Olası Hook Adları
Aşağıda, bazı popüler sağlayıcılar için olası kanca adları listelenmiştir. Bu adlar eklenti sürümüne göre değişebilir ve garanti edilmez, ancak denemek için iyi bir başlangıç noktasıdır.

Genel GPOS / iPara:

gpos_before_process_payment (Bu, eklentinin varsayılan değeridir)

PayTR:

paytr_before_payment_request

paytr_before_process_payment

Iyzico:

Iyzico genellikle kendi formunu kullandığı için standart bir “before process” kancası
olmayabilir. Destek ekibine sormanız en sağlıklısıdır. Olası bir format iyzipay_before_checkout_form veya iyzipay_process_payment_request olabilir.
Weepay:

weepay_before_payment

Shopier:

Shopier harici bir ödeme sayfasına yönlendirdiği için, ödeme öncesi kart markasını kontrol eden bir kancası bulunmayabilir.
Unutmayın: En doğru sonucu her zaman sanal pos eklentisinin geliştiricisinden veya dokümantasyonundan alırsınız.
YARDIM: “Troy Kart Marka Tanımlayıcısı (Slug)” Ayarı
Bu Ayar Nedir?
Bu ayar, sanal pos eklentinizin bir Troy kartı hangi metin (slug) ile tanıdığını belirtmenizi sağlar.
Çoğu sanal pos eklentisi, bir Troy kart ile ödeme yapıldığında kart markasını troy olarak raporlar.
Ancak bazı eklentiler farklı bir metin kullanabilir (örneğin troy-kart). Eklentimizin kısıtlama özelliğinin doğru çalışması için, arayacağı kart markası metninin sanal posunuzun raporladığı metinle tam olarak eşleşmesi gerekir.
Bu alan, bu eşleşmeyi sağlamanıza olanak tanır.

Varsayılan değer troy olarak ayarlanmıştır ve büyük/küçük harf duyarlı değildir.
Doğru Değeri Nasıl Bulurum?
Eğer varsayılan troy değeri ile kısıtlama özelliği çalışmazsa, doğru değeri bulmak için şu adımları izleyebilirsiniz:

Test Siparişi Oluşturun: Eklentimizin “Çalışma Modu” ayarını geçici olarak “Sadece İndirim Uygula” olarak değiştirin.
Bu, kısıtlamayı devre dışı bırakacaktır.

Sitenizden bir Troy kart kullanarak bir test siparişi verin.
Sipariş Detaylarını İnceleyin: WooCommerce > Siparişler menüsünden oluşturduğunuz test siparişini açın.
Sağ tarafta bulunan “Sipariş Notları” (Order Notes) bölümünü veya işlem detaylarını inceleyin.
Birçok sanal pos eklentisi, ödeme başarılı olduğunda işlem detaylarını ve kullanılan kart markasını (card brand) bu bölüme not olarak ekler.
Doğru Değeri Girin: Sipariş notlarında Troy kart için hangi metnin kullanıldığını (örn: Card Brand: troy-kart) bulduktan sonra, bu değeri eklentimizdeki “Troy Kart Marka Tanımlayıcısı (Slug)” alanına girin ve ayarları kaydedin.
Son olarak, “Çalışma Modu”nu tekrar istediğiniz kısıtlama moduna getirin.

Eğer sipariş notlarında bu bilgiyi bulamazsanız, sanal pos sağlayıcınızın destek ekibine danışmanız en doğru yöntem olacaktır.

1.2.2

• GELİŞTİRME: Türkçe dil dosyaları güncellendi.
• GELİŞTİRME: Kod performans optimizasyonları yapıldı.

1.2.1

• DÜZELTME: Teknik eksiklikler giderildi.

1.2.0

• DÜZELTME: WordPress ve WooCommerce kodlama standartlarına uyumluluk için güvenlik (escaping) ve uluslararasılaştırma (i18n) hataları düzeltildi.
• DÜZELTME: Eklenti ve Readme dosyalarındaki sürüm (Version/Stable tag) ve başlık hataları giderildi.
• YENİ: HPOS uyumluluğunu programatik olarak bildirildi.

1.1.0

• YENİ: Yüksek Performanslı Sipariş Depolama (HPOS) uyumluluğu eklendi.
• YENİ: Ayar paneline hedef ödeme yöntemini seçmek için dinamik bir açılır menü eklendi. Artık kod düzenlemeye gerek yok.
• GELİŞTİRME: Kod kalitesi modern PHP standartlarına yükseltildi ve yeniden yapılandırıldı.
• GELİŞTİRME: Eklentiler sayfasına “Ayarlar” kısayolu eklendi.
• GELİŞTİRME: Eklenti etkinleştirildiğinde varsayılan ayarların yüklenmesi sağlandı.

1.0.0

• İlk sürüm.