DurumEN
BaşlarkenPayment OrchestratorCüzdanBanka HesaplarıSigortaFraud & Fraud AIIdentitySanctionAutomationSDKDemo
Entegrasyonlar
WordPress / WooCommerce

WordPress / WooCommerce

Lunixi for WordPress eklentisi WordPress sitenizi Lunixi'ye bağlar. WooCommerce için kartla ödeme yöntemi sunar; kart formu Lunixi Checkout tarafından gösterilir, kart verisi sunucunuza hiç gelmez.

  • WooCommerce ödeme yöntemi: 3D Secure ile kartla ödeme; klasik ve blok tabanlı ödeme sayfasıyla çalışır, HPOS (High-Performance Order Storage) uyumludur.
  • Ön provizyon (preauth): tutarı ödeme anında bloke edip siparişi tamamladığınızda çekebilir ya da siparişi iptal ederek serbest bırakabilirsiniz.
  • İade: WooCommerce yönetiminden tam ya da kısmi iade.
  • İmzalı webhook: sipariş durumunu tarayıcı dönüşü değil, imzası doğrulanan webhook belirler.
  • Şifreli saklama: özel anahtar ve webhook secret'ı veritabanında şifreli tutulur.
  • PCI SAQ-A: kart formu Lunixi tarafından gösterilir ve tokenize edilir.

Gereksinimler

WordPress6.4 ve üzeri
WooCommerce8.0 ve üzeri (ödeme yöntemi için)
PHP7.4 ve üzeri
ComposerKaynaktan kurulum için

Kaynak kod: GitHub (opens in a new tab) · Sürüm: v0.2.4 (opens in a new tab)

Kurulum

Eklentiyi kaynaktan kurun

Eklenti, GitHub'daki kaynak deposundan kurulur. Depo, WordPress yönetimindeki "Eklenti yükle" ekranına verilecek bir kurulum paketi değildir: eklenti PHP SDK'sını (lunixi/php-sdk) vendor/ klasöründen yükler, bu yüzden kaynaktan kurarken bağımlılıkları Composer ile kurmanız gerekir.

cd wp-content/plugins
git clone --branch v0.2.4 https://github.com/Lunixi-Payment/lunixi-wordpress.git lunixi
cd lunixi
composer install --no-dev

Sunucunuzda Composer yoksa bu adımları kendi bilgisayarınızda yapıp lunixi klasörünün tamamını sitenizin wp-content/plugins klasörüne yükleyin. Ardından Eklentiler ekranında Lunixi for WordPress'i etkinleştirin; yönetim menüsünde Lunixi başlığı görünür.

API bilgilerini girin

Lunixi → Settings ekranında şunları girin:

AlanDeğer
EnvironmentLive ya da Test
Key IDLunixi panelinde oluşturduğunuz API anahtarının kimliği
Private Key (PEM)Anahtarın özel anahtarı (-----BEGIN PRIVATE KEY----- ile başlar)
Webhook SecretWebhook endpoint'inizin secret'ı

Özel anahtar ve webhook secret'ı şifreli saklanır; kaydettikten sonra alanlar boş görünür, boş bırakırsanız kayıtlı değer korunur. Lunixi → Payments ekranındaki Test connection düğmesiyle bilgilerin çalıştığını doğrulayın.

Webhook adresini kaydedin

Lunixi → Settings ekranında gösterilen webhook adresini Lunixi panelinde webhook endpoint'i olarak kaydedin ve endpoint'in secret'ını Webhook Secret alanına girin. Adres şu biçimdedir:

https://siteniz.com/wp-json/lunixi/v1/webhook

→ Webhook Kurulumu

Ödeme yöntemini açın

WooCommerce → Settings → Payments altında Lunixi'yi etkinleştirin.

Ödeme yöntemi ayarları

AyarAçıklama
Enable/DisableÖdeme yöntemini açar ya da kapatır
TitleÖdeme sayfasında görünen ad (varsayılan: Credit / Debit Card)
DescriptionÖdeme sayfasında adın altında görünen metin
CaptureCapture immediately: tutar ödeme anında çekilir (önerilen). Pre-authorization (preauth): tutar bloke edilir, sonra çekilir.

API bilgileri tüm Lunixi modülleri için ortaktır ve yalnız Lunixi → Settings ekranında girilir.

Sipariş akışı

  1. Alıcı ödeme sayfasında Lunixi'yi seçer ve Lunixi Checkout formunda kart bilgilerini girer; gerekirse 3D Secure'u tamamlar.
  2. Siparişin ödendi ya da başarısız durumuna geçmesini imzası doğrulanan webhook belirler. Tarayıcının dönüşü tek başına siparişi ödendi yapmaz.
  3. Sipariş ekranındaki Lunixi payment kutusu ödeme kimliğini, 3D Secure durumunu ve taksit sayısını gösterir.

Ön provizyon

Capture ayarı Pre-authorization (preauth) ise tutar karttan çekilmez, bloke edilir:

  • Siparişi Tamamlandı (Completed) yaptığınızda bloke edilen tutar çekilir.
  • Siparişi İptal edildi (Cancelled) yaptığınızda bloke kaldırılır.

Her iki işlemin sonucu siparişe not olarak düşer.

İade

WooCommerce sipariş ekranındaki iade düğmesiyle tam ya da kısmi iade yapabilirsiniz; iade Lunixi'ye iletilir.

Kaçan webhook'lar

Lunixi bir teslimatı başarısız olduğunda yeniden dener. Siteniz uzun süre erişilemez kaldıysa, eklenti 15 dakikada bir çalışan bir zamanlanmış görevle 20 dakikadan uzun süredir bekleyen siparişlerin ödemesini Lunixi'den okur ve siparişi buna göre günceller. Görev WordPress cron'u ile çalışır; sitenizde WP-Cron'un çalıştığından emin olun.

Senetle ödeme gibi kart dışı yöntemler, form ayarlarınızda açtığınızda Lunixi Checkout'ta görünür; eklentide ayrı bir ayar gerekmez.

İlgili

LaravelOpenCart