=== Invum POS Entegratör ===
Contributors: invumhq
Tags: woocommerce, payment-gateway, iyzico, paytr, sanal-pos
Requires at least: 6.6
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Türkiye için WooCommerce sanal POS / ödeme entegrasyonu — ücretsiz iyzico ve PayTR; banka sanal POS'ları ve agregatörler Pro eklentisiyle.

== Description ==

**Invum POS Entegratör**, Türkiye'deki e-ticaret işletmelerinin ülkede yaygın kullanılan ödeme kuruluşlarını (PSP), banka sanal POS sistemlerini ve ödeme agregatörlerini WooCommerce mağazalarına en az kurulumla bağlamasını sağlayan kapsamlı bir ödeme entegrasyon eklentisidir.

= Desteklenen ödeme yöntemleri =

Bu ücretsiz Lite sürümü, tam çalışan iki geçidi — **iyzico** ve **PayTR** (iframe + Direkt API) — kayıtlı kart kasası, 3D Secure, çoklu hesap desteği ve kontrol paneliyle birlikte sunar. Lisans gerekmez.

Aşağıda *(Pro)*, *(Studio)* ve *(Agency)* olarak işaretli sağlayıcılar, ayrı bir eklenti olan **Invum POS Pro** paketine dahildir ve [invum.com.tr](https://invum.com.tr/pos) üzerinden edinilir. Bu sağlayıcıların kodu bu ücretsiz eklentide **bulunmaz**; Pro eklentisini Lite ile birlikte kurduğunuzda eklenirler.

**Ödeme kuruluşları — PSP (3):**

* iyzico — Checkout Form + Direkt API + kayıtlı kart kasası *(Lite)*
* PayTR — iframe + Direkt API + kayıtlı kart kasası *(Lite)*
* Param — TurkPos SOAP + kayıtlı kart *(Pro)*

**Banka sanal POS (15):**

* Yapı Kredi (Posnet) *(Studio)*
* Garanti BBVA (VPServlet XML / gt3dengine 3DS) *(Studio)*
* VakıfBank (PayFlex VPOS / GET 7/24 MPI 3DS) *(Studio)*
* NestPay platformundaki 12 banka *(Pro)* — Akbank, Halkbank, İş Bankası, Şekerbank, TEB, Türkiye Finans, Ziraat, Anadolubank, Alternatifbank, Cardplus, ING, QNB Finansbank

**Agregatörler (2):**

* Craftgate *(Studio)*
* Moka *(Agency)*

= Öne çıkan özellikler =

* **Çoklu hesap desteği** — Tek bir PSP altında birden fazla mağaza/şube hesabı
* **3D Secure** — Tüm sağlayıcılarda çalışır; geri-çağrı (callback) hash/imza doğrulamasıyla
* **Kayıtlı kart kasası** — iyzico ve PayTR için tek tıkla ödeme (Param, Pro eklentisiyle)
* **WooCommerce Subscriptions desteği** — iyzico ve PayTR Direkt için cron tabanlı yinelenen yenilemeler (Param, Pro eklentisiyle); iptal, askıya alma ve ödeme yöntemi değiştirme akışları
* **Akıllı taksit motoru** (Pro) — Kategori, sepet ve banka bazlı taksit kuralları
* **Otomatik sipariş durumu mutabakatı** — 30 dakikalık bekleyen-sipariş cron'u terk edilmiş ödemeleri önler
* **Test / üretim geçişi** — Ortamları tek tıkla değiştirin
* **Şifreli kimlik bilgisi saklama** — AES-256-CBC; API anahtarları asla düz metin olarak saklanmaz
* **Hassas veri maskeleme** — Kart numarası, CVV ve API anahtarları loglara asla düşmez
* **PCI'ye duyarlı akışlar** — Barındırılan/iframe ödeme, kart verisini sunucunuzdan uzak tutar (SAQ A); isteğe bağlı doğrudan kart formu ise kart verisini sitenizde toplar (SAQ A-EP)

= Geliştirici notları =

* Modüler PSR-4 mimarisi (`Invum\Pos` ad alanı)
* Sağlayıcı Tanım Kayıt Defteri (Provider Definition Registry) — çalışma zamanı geçit sevk tablosu
* WordPress Coding Standards (PHPCS) uyumlu
* 1700+ PHPUnit testi
* Sürümlenmiş migration'larla özel veritabanı tablosu `wp_invum_pos_transactions`

= Lite ile Pro farkı =

Bu, ücretsiz Lite sürümüdür. **iyzico** ve **PayTR** geçitleri, kayıtlı kart kasası, 3D Secure, çoklu hesap desteği, bekleyen-sipariş mutabakat cron'u ve kontrol paneliyle kullanıma hazır gelir — lisans gerekmez.

Aşağıdaki ek geçitler ve özellikler, ayrı bir eklenti olan **Invum POS Pro** paketiyle (bununla birlikte kurulan bağımsız bir eklenti) sunulur ve katmanlara göre gruplanır:

* **Pro** — Param + 12 NestPay bankası, Akıllı Kural Motoru (temel taksit kuralları), bağlantı testi, beyaz-etiket markalama.
* **Studio** — Garanti BBVA, Yapı Kredi Posnet, VakıfBank (PayFlex), Craftgate, gelişmiş taksit kuralları, Paid Memberships Pro / GiveWP köprüleri.
* **Agency** — Moka, çoklu hesap sevki, kural içe/dışa aktarma, tam beyaz-etiket, Easy Digital Downloads / LearnPress / Events Calendar köprüleri.

Pro eklentisi ve katmanları [invum.com.tr/pos](https://invum.com.tr/pos) adresinde mevcuttur.

= Ticari markalar =

iyzico, PayTR, Param, Garanti BBVA, Yapı Kredi, Posnet, VakıfBank, PayFlex, NestPay, Craftgate, Moka ve yukarıda listelenen banka adları, ilgili sahiplerinin ticari markalarıdır. Invum bağımsız bir üründür; bu şirketlerin hiçbiriyle bağlantılı değildir, onlar tarafından onaylanmamış veya desteklenmemiştir. Adlar yalnızca bu eklentinin bağlandığı ödeme hizmetlerini tanımlamak için kullanılmıştır.

== External services ==

Bu eklenti, aşağıda belgelenen üçüncü taraf hizmetlerine dayanır. Ödeme geçitleri ve lisans API'si yalnızca siz etkinleştirip yapılandırdığınızda iletişime geçilir; otomatik olarak yenilenen tek hizmet TCMB döviz kuru beslemesidir (ayrıntılar aşağıda).

**Ödeme geçitleri (Lite sürümünde iyzico ve PayTR; ek sağlayıcılar ayrı Invum POS Pro eklentisiyle eklenir).** Bir müşteri, etkinleştirdiğiniz bir geçitle ödeme yaptığında eklenti, o ödemeyi işlemek için gereken verileri — sipariş tutarı ve para birimi, sipariş/işlem kimlikleri ve müşterinin girdiği kart ya da 3-D Secure bilgilerini — yapılandırdığınız üye işyeri kimlik bilgileriyle ilgili sağlayıcının API'sine gönderir. Bu, ödeme (checkout) sırasında ve sağlayıcı 3-D Secure / ödeme sonucunu geri gönderdiğinde gerçekleşir. Kart verisi asla düz metin olarak saklanmaz veya loglara yazılmaz. Her sağlayıcı bağımsız olarak işletilir; lütfen kullanım koşullarını ve gizlilik politikasını inceleyin:

* iyzico — Koşullar: https://www.iyzico.com/kendim-icin/kullanici-sozlesmesi — Gizlilik: https://www.iyzico.com/gizlilik-politikasi
* PayTR — Koşullar: https://www.paytr.com/kosullar — Gizlilik: https://www.paytr.com/gizlilik

**TCMB döviz kuru beslemesi (www.tcmb.gov.tr).** Zamanlanmış bir görev günde bir kez, Türkiye Cumhuriyet Merkez Bankası'nın yayımladığı resmî günlük döviz kurlarını `https://www.tcmb.gov.tr/kurlar/today.xml` adresinden çeker ve eklentinin yönetim panelindeki kur kartında gösterir. Bu, herkese açık bir XML belgesi için düz bir GET isteğidir — hiçbir kişisel veri, sipariş verisi veya site bilgisi iletilmez. Koşullar/kullanım: https://www.tcmb.gov.tr/

**Invum Lisans API'si (panel.invum.com.tr).** Bir Pro, Studio veya Agency lisans anahtarı girerseniz eklenti, o anahtarı etkinleştirmek, doğrulamak veya devre dışı bırakmak ve Pro modül güncellemelerini almak için Invum paneliyle iletişime geçer. Lisans anahtarınızı ve site adresinizi (URL) iletir. Ücretsiz Lite sürümü lisans gerektirmez ve bir anahtar girmediğiniz sürece bu hizmete hiçbir çağrı yapmaz. Koşullar: https://invum.com.tr/ — Gizlilik: https://invum.com.tr/gizlilik-politikasi/

== Installation ==

= Otomatik kurulum (önerilen) =

1. WordPress yönetim panelinde **Eklentiler → Yeni Ekle** bölümüne gidin
2. **Invum POS Entegratör** aratın
3. **Şimdi Kur**'a tıklayın
4. **Etkinleştir**'e tıklayın
5. **WooCommerce → Ayarlar → Ödemeler** altından istediğiniz sağlayıcıları etkinleştirin

= Elle kurulum =

1. Eklenti zip'ini [WordPress.org eklenti sayfasından](https://wordpress.org/plugins/invum-pos/) indirin
2. WordPress yönetiminde **Eklentiler → Yeni Ekle → Eklenti Yükle** bölümüne gidip zip'i yükleyin
3. **Etkinleştir**'e tıklayın

= Kurulumdan sonra =

WooCommerce ayarlarında bir ödeme yöntemi etkinleştirildiğinde, her sağlayıcı kendi sekmesinde üye işyeri kimlik bilgilerini ister. Test ortamı için sağlayıcıdan bir sandbox hesabı talep edin — [invum.com.tr/docs](https://invum.com.tr/docs/) adresindeki kılavuzlara bakın.

== Frequently Asked Questions ==

= Hangi PHP ve WordPress sürümleri destekleniyor? =

PHP 8.1+, WordPress 6.6+, WooCommerce 9.0+. 3D Secure geri-çağrıları için geçerli bir SSL/HTTPS sertifikası gereklidir.

= Ödeme verilerim güvende mi? =

Evet. API anahtarları AES-256-CBC ile şifrelenip `wp_options` tablosunda saklanır; isteğe bağlı olarak `wp-config.php` üzerinden geçersiz kılınabilir. Kart numarası, CVV ve API anahtarları asla düz loglara yazılmaz.

= 3D Secure çalışıyor mu? =

3D Secure tüm sağlayıcılarda desteklenir. Geri-çağrı hash/imza doğrulaması her sağlayıcı için uygulanmıştır.

= WooCommerce Subscriptions ile çalışıyor mu? =

Evet. Ücretsiz Lite sürümünde, iyzico ve PayTR Direkt için kayıtlı kart non-3DS yetkilendirme yolu kullanılarak cron tabanlı yinelenen yenilemeler etkindir (Param, Pro eklentisiyle desteklenir). İptal, askıya alma, yeniden etkinleştirme ve ödeme yöntemi değişiklikleri desteklenir.

= İhtiyacım olan bir geçidi ekler misiniz? =

[Eklentinin destek forumunda](https://wordpress.org/support/plugin/invum-pos/) bir talep açabilirsiniz. Modüler mimari, yeni geçitler eklemeyi kolaylaştırır.

= Bu eklenti GPL uyumlu mu? =

Evet — GPL-2.0-or-later altında lisanslanmıştır. Kaynak kodunu inceleyip değiştirebilirsiniz. Pro modüllerinin resmî paketi ve otomatik güncelleme kanalı Invum Lisans API'si üzerinden sunulur.

== Screenshots ==

1. POS hesabı ekleme — 21 desteklenen sağlayıcı arasından seçim (PSP, banka sanal POS, agregatör)
2. iyzico hesap ayarları — Sandbox/Üretim geçişi, çoklu hesap
3. Hub Panosu — bu hafta ile geçen haftanın karşılaştırması ve en çok kullanılan geçitler
4. Kayıtlı kart kasası yönetimi (kullanıcı hesabında)
5. WooCommerce Blocks Ödeme — canlı önizlemeli markalı kart formu ve 3D Secure
6. Pro: Akıllı Kural Motoru — kategori/sepet/banka bazlı taksit kuralları
7. İşlem geçmişi tablosu
8. Bağlantı testi yönetici satır eylemi

== Changelog ==

= 1.0.0 =
* Ücretsiz Lite sürümünün ilk herkese açık yayını.
* iyzico ve PayTR geçitleri (PayTR hem iframe hem Direkt API sunar); 3D Secure ve kayıtlı kart kasası.
* iyzico ve PayTR Direkt için WooCommerce Subscriptions desteği.
* Çoklu hesap desteği, bekleyen-sipariş mutabakat cron'u, pano bileşenleri.
* WooCommerce HPOS ve Sepet/Ödeme Blokları uyumlu.
* Banka sanal POS'ları, agregatörler ve Param, ayrı Invum POS Pro eklentisiyle sunulur.

== Upgrade Notice ==

= 1.0.0 =
İlk herkese açık yayın.
