VibeFox 2C2P for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 6.0 veya üzeri, kurulu ve etkin olmalı. WooCommerce olmadan eklenti yönetici alanında bir uyarı gösterir ve ödeme yöntemi yüklenmez.

PHP: 8.0 veya üzeri.

2C2P hesabı: 2C2P satıcı hesabınızın Merchant ID ve Secret Key değerlerine ihtiyacınız var. Bunları satıcı hesabınız açıldığında 2C2P verir. Test ortamı ve canlı ortam hesaplarının anahtarları farklıdır. Geliştirici belgeleri ve test kartları developer.2c2p.com adresinde bulunur.

Para birimi: mağaza para biriminin eklenti tarafından desteklenmesi ve 2C2P hesabınızda etkin olması gerekir. Desteklenen para birimleri arasında THB, SGD, MYR, PHP, IDR, VND, MMK, KHR, LAK, CNY, HKD, TWD, JPY, KRW, INR, AUD, NZD, USD, EUR ve GBP bulunur. Mağaza para birimi desteklenmiyorsa ödeme yöntemi ödeme sayfasında gizlenir.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar bir alan adında çalışır.

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklenti ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_2c2p_payment klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Payments > 2C2P > Manage yolunu izleyin veya Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bölümüne VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Test ortamı Merchant ID ve Secret Key değerlerinizi girin, Enable/Disable seçeneğini açın ve bir test siparişi verin.

6. Hazır olduğunuzda canlı ortam bilgilerini girin ve Sandbox Mode seçeneğinin işaretini kaldırın.

Dönüş ve bildirim adresleri her ödemeyle birlikte gönderilir. 2C2P portalında hiçbir şeyi yapılandırmanız gerekmez.

Yapılandırma

Tüm ayarlar tek bir sayfada: WooCommerce > Settings > Payments > 2C2P. Alanların üstünde, test modu açıkken sayfa Sandbox mode is active. No real transactions will be processed. uyarısını gösterir. Ağ geçidi etkinken geçerli modun Merchant ID veya Secret Key alanı boşsa ve mağaza para birimi desteklenmiyorsa da uyarır. Her iki durumda da ödeme yöntemi ödeme sayfasında gizlenir. Sandbox Mode kapalıyken kaydettiğinizde, canlı Merchant ID veya Secret Key boşsa eklenti bunları ister.

Genel

Enable/Disable: Enable 2C2P Payment Gateway ödeme yöntemini açar veya kapatır. Varsayılan: kapalı.

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Varsayılan: 2C2P Payment.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely via credit/debit card, e-wallet, or internet banking through 2C2P. Test ortamında metne (TEST MODE) eklenir.

Test modu (sandbox)

Sandbox Mode: Enable sandbox / test mode seçeneği ödemeleri, aşağıdaki test ortamı bilgileriyle 2C2P test ortamına (demo2.2c2p.com) gönderir. Varsayılan: açık. Gerçek ödeme almak için işaretini kaldırın.

Sandbox Merchant ID: test ortamı 2C2P Merchant ID'niz.

Sandbox Secret Key: test ortamı 2C2P Secret Key'iniz.

Canlı ortam API kimlik bilgileri

Sandbox Mode kapalıyken kullanılır.

Merchant ID: canlı 2C2P Merchant ID'niz. Sandbox Mode kapalıyken zorunludur.

Secret Key: canlı 2C2P Secret Key'iniz. Sandbox Mode kapalıyken zorunludur. Anahtar, tırnaklar ve ters eğik çizgiler dahil, girildiği gibi kaydedilir.

Ödeme sayfası

Bu bölüm, bilgi amaçlı olarak ön yüz dönüş adresini (https://your-site/?wc-api=tc2p_p) ve arka yüz bildirim adresini (https://your-site/?wc-api=tc2p_p&tc2p_p_s2s=1) gösterir. Bunlar her ödemeyle otomatik olarak gönderilir.

Payment Page Language: 2C2P ödeme sayfasının dili. Varsayılan: English.

Redirect API version: 2C2P hesabınızın hâlâ eski 7.0 sürümünü (SHA-1 imzaları) kullandığını söylemedikçe 8.5 olarak bırakın. Geçişten önce başlatılmış ödemelerin sonuçları yine doğrulanır.

Order ID prefix: isteğe bağlı, yalnızca harf ve rakam (en fazla 10 karakter), örneğin SHOP1. 2C2P, daha önce gördüğü bir sipariş kimliğini kabul etmez. Birden fazla mağaza aynı 2C2P hesabını paylaştığında ve test ortamında, test satıcı hesapları paylaşıldığı için benzersiz bir önek ayarlayın. Diğer karakterler kaydederken uyarıyla birlikte silinir.

Gelişmiş ayarlar

Enable Logging: Log 2C2P events seçeneği WooCommerce > Status > Logs bölümüne, kaynak wcp_2c2p_payment olarak yazar. Hiçbir kart verisi veya gizli anahtar günlüğe yazılmaz. Varsayılan: kapalı.

Delete Data on Uninstall: Delete the gateway settings, 2C2P order meta and log files when the plugin is deleted. Varsayılan: kapalı.

Ödeme süreci

Müşteri ödeme yöntemini seçer (varsayılan olarak 2C2P Payment) ve siparişi verir. Sonraki sayfada Thank you for your order. You will be redirected to 2C2P to complete your payment. mesajı gösterilir ve kısa bir süre sonra müşteri 2C2P ödeme sayfasına yönlendirilir. Bu olmazsa müşteri Pay via 2C2P düğmesine tıklar. Sayfada ayrıca bir Cancel order düğmesi bulunur.

2C2P sayfasında müşteri, 2C2P hesabınızda etkin olan herhangi bir yöntemle öder; örneğin kartlar, e-cüzdanlar, QR ödemeleri, internet bankacılığı veya nakit ödemeler. Eklenti, sipariş toplamını sipariş para biriminde, müşterinin fatura e-posta adresini ve sipariş edilen ürünlerin adlarını iletir. Ödeme 24 saat içinde tamamlanabilir.

2C2P sonucu iki kez bildirir: müşterinin tarayıcısı mağazaya geri döner ve 2C2P sunucudan sunucuya bir bildirim gönderir. Her ikisi de aynı şekilde işlenir. Sipariş, yalnızca 2C2P geçerli bir imzayla onayladığında ödenmiş olarak işaretlenir. Sonuç ayrıca siparişe ait olmalıdır: Merchant ID, sipariş anahtarı, sipariş kimliği ve ödeme yöntemi kontrol edilir. Geçersiz imzalı sonuçlar reddedilir.

Başarılı veya bekleyen bir ödemeden sonra müşteri sipariş alındı sayfasına gelir ve sepet boşaltılır. Ödeme tamamlanmadıysa müşteri, Payment was not completed. Please try again or choose a different payment method. mesajıyla ödeme sayfasına döner. Sipariş iptal edilir, sepet korunur ve müşteri yeni bir sipariş verir. Sonuç doğrulanamazsa müşteri We could not confirm the payment result. If your account was charged, please contact us before paying again. mesajını görür.

Ödeme yöntemi klasik ödeme sayfasında ve Ödeme bloğunda çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklenti, WooCommerce'ten iade, kayıtlı kart, yinelenen ödeme veya WooCommerce Subscriptions desteği sunmaz; sitenizde kart alanı içermez ve 2C2P PGW 4.x API desteğini içermez.

Siparişler

Sipariş durumları

Pending payment: müşteri 2C2P'ye yönlendirildi ve henüz bir sonuç gelmedi.

Processing or Completed: 2C2P başarılı bir ödeme bildirdi (durum 000). WooCommerce durumu İşleniyor olarak ayarlar; yalnızca sanal ve indirilebilir ürünlerden oluşan siparişlerde Tamamlandı olarak ayarlar. Sipariş notunda 2C2P işlemi, onay kodu, tarih ve ödeme kanalı gösterilir. İşlem kimliği, 2C2P işlem referansıdır.

On hold: ödeme 2C2P'de beklemede (durum 001), örneğin müşterinin henüz ödemediği bir nakit ödeme. 2C2P ödemeyi bildirdiğinde sipariş ödenmiş olur. 2C2P, sipariş toplamından farklı bir tutar veya para birimi bildirdiğinde de sipariş beklemeye alınır. Sipariş notunda alınan ve beklenen değerler gösterilir. Siparişi ve işlemi 2C2P portalında kontrol edin.

Cancelled: ödeme reddedildi, müşteri tarafından iptal edildi veya başarısız oldu (durum 002, 003, 999). Sipariş notunda durum ve neden gösterilir.

Ödenmiş veya iade edilmiş bir sipariş, sonradan gelen bir sonuçla hiçbir zaman değiştirilmez. Eski bir sonucun tekrarı da sizin iptal ettiğiniz bir siparişi yeniden açmaz.

İadeler

WooCommerce'ten iade desteklenmez. Ödemeyi 2C2P satıcı portalından iade edin, ardından WooCommerce'te manuel bir iade oluşturun.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Payments > 2C2P sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bölüm durumu gösterir; örneğin lisansın hangi tarihe kadar etkin olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar bir alan adında çalışır. Anahtarı bir siteden kaldırmak alan adı hakkını serbest bırakmaz; bu hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa 2C2P, ödeme sayfasında müşterilere gösterilmez. Ödeme yine de başlatılırsa müşteri This payment method is not available. Please choose another one. mesajını görür. Oturum açmış mağaza yöneticileri ödeme yöntemini yine görür; yöntem (unlicensed — visible to admins only) etiketiyle işaretlenir. Böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Plugins sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır.

Lisans süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

2C2P ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve geçerli modun Merchant ID ile Secret Key alanlarının dolu olduğunu kontrol edin: test modunda test ortamı alanlarını, canlı modda canlı alanları. Mağaza para biriminin desteklendiğini kontrol edin. Ayarlar sayfası her iki durumda da bir uyarı gösterir.

Ödeme yapıldı, ancak sipariş hâlâ Pending payment durumunda: mağazanıza geçerli bir sonuç ulaşmadı. Geçerli modun Merchant ID ve Secret Key değerlerinin, ödemenin yapıldığı 2C2P hesabıyla eşleştiğini ve Redirect API version değerinin hesabınızla uyumlu olduğunu kontrol edin. Yanlış imzalı veya başka bir Merchant ID'ye ait sonuçlar reddedilir. Enable Logging seçeneğini açın ve WooCommerce > Status > Logs bölümünde hash veya merchant ID mesajlarına bakın. Ayrıca sunucunuzun, 2C2P'nin arka yüz bildirim adresine gönderdiği istekleri kabul ettiğini kontrol edin.

2C2P, sipariş kimliğinin zaten var olduğunu söylüyor: 2C2P aynı sipariş kimliğini iki kez kabul etmez. Bu durum, birden fazla mağaza aynı 2C2P hesabını paylaştığında veya birçok geliştiricinin demo satıcı hesaplarını paylaştığı test ortamında olur. Benzersiz bir Order ID prefix ayarlayın.

Ödeme yapıldı, ancak sipariş On hold durumunda: ya ödeme 2C2P'de hâlâ beklemededir (örneğin müşterinin henüz ödemediği bir nakit ödeme) ya da ödenen tutar veya para birimi siparişle eşleşmedi. Sipariş notlarını ve işlemi 2C2P portalında kontrol edin.

Müşteri şu mesajı görüyor: This payment method is currently unavailable for this order: sipariş para birimi desteklenmiyor ya da geçerli modun Merchant ID veya Secret Key değeri boş.

Please enter your live Merchant ID or Please enter your live Secret Key on save: Sandbox Mode kapalı ve canlı alanlardan biri boş. Canlı bilgileri girin veya Sandbox Mode seçeneğini açık tutun.

Lisans bölümü bir hata gösteriyor: bölümdeki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa, vibefox.net hesabınızda bir alan adı hakkını serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse, anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Tamamen kaldırmak için Plugins sayfasında devre dışı bırakıp silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları, siparişlerde saklanan 2C2P verileri ve günlük dosyaları yalnızca Delete Data on Uninstall açıksa kaldırılır. Aksi halde yeniden kurulum için saklanır. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

2C2P, ilgili sahibinin ticari markasıdır. Bu eklenti 2C2P ile bağlantılı değildir ve 2C2P tarafından onaylanmamıştır.