VibeFox Peach Payments for WooCommerce — Yardım

Gereksinimler

WordPress: 6.2 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin. Bu olmadan eklenti etkinleşmez.

PHP: 8.0 veya üzeri.

Currency: mağaza para birimi ZAR, KES veya MUR olmalıdır. Diğer para birimlerinde ödeme yöntemi gizlenir ve ayarlar sayfasında belirtilir.

Peach Payments account: Peach Payments hesabınızın Card API kimlik bilgileri gerekir: Entity ID ve Access Token. Test bilgileri Peach Payments test ortamı panelinden, canlı bilgiler Peach Payments panelinden alınır; birbirinden farklıdır. Webhook'lar için ayrıca Peach Payments'ın mağazanızda Card webhook'larını açarken gönderdiği şifre çözme anahtarı gerekir (bkz. Yapılandırma). Siteniz webhook alabilmek için internetten erişilebilir olmalıdır.

VibeFox license key: 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 açın, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. wcp_peach_pay klasörünü FTP ile /wp-content/plugins/ konumuna da yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Payments > Peach Payments > Manage veya Eklentiler sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Peach Payments test ortamı panelindeki test Entity ID ve Access Token bilgilerini girin; Peach Payments'tan ayarlarda gösterilen webhook URL'si için Card webhook'larını açmasını isteyin (bkz. Yapılandırma).

6. Enable/Disable seçeneğini açıp kaydedin. Test mode açık kalsın ve Peach Payments test ortamı kartıyla ödeme yapın. Sonra Test mode işaretini kaldırın, canlı kimlik bilgilerini ve canlı webhook anahtarını girip kaydedin.

1.0 sürümünün ayarları güncelleme sonrasında otomatik olarak yeni alanlara taşınır.

Yapılandırma

Tüm ayarlar tek sayfadadır: WooCommerce > Settings > Payments > Peach Payments. Alanların üzerinde bildirimler gösterilir: Test mode is on: payments go to the Peach Payments sandbox and no real money is charged.; geçerli modun Entity ID veya Access Token bilgisi eksikse bildirim (bu bilgiler girilene kadar yöntem ödeme sayfasında gösterilmez); geçerli modun webhook şifre çözme anahtarı eksikse bildirim (ödemeler yalnızca müşteri döndüğünde onaylanır); ve mağaza para birimi desteklenmiyorsa bildirim. Ödeme yöntemleri listesinde Peach Payments, geçerli modda Entity ID ve Access Token bulunana kadar kurulum gerektiriyor olarak işaretlenir. Kaydederken kimlik bilgilerindeki boşluklar kaldırılır; webhook anahtarı 64 karakterlik onaltılık değer değilse hata bildirilir.

Enable/Disable: Enable Peach Payments ödeme yöntemini açar veya kapatır. Varsayılan: kapalı.

Title: ödeme sayfasında müşteriye gösterilen yöntem adı. Varsayılan: Credit / Debit Card (Peach Payments).

Description: ödeme sayfasında yöntemin altında gösterilen metin. Varsayılan: Pay securely with your card. You will enter the card details in the Peach Payments form on the next page.

API kimlik bilgileri

Card API Access Token ve Entity ID bilgileri Peach Payments panelinde gösterilir (test bilgileri test ortamı panelindedir). Bölüm, her iki panele ve Peach Payments geliştirici belgelerine bağlantılar içerir.

Test mode: Enable test mode yeni ödemeleri test kimlik bilgileriyle Peach Payments test ortamına gönderir; gerçek para alınmaz. Canlı bilgilerle gerçek ödeme kabul etmek için işareti kaldırın. Bir modda başlatılan ödeme, mod değişse bile her zaman o modda kontrol edilir. Varsayılan: açık.

Test Entity ID: test ortamı hesabınızın Entity ID bilgisi (3-D Secure kanalı).

Test Access Token: test ortamı hesabınızın bearer erişim jetonu.

Test Webhook Decryption Key: test ortamının Card webhook'larını çözmek için 64 karakterlik onaltılık anahtar.

Live Entity ID: canlı hesabınızın Entity ID bilgisi (3-D Secure kanalı).

Live Access Token: canlı hesabınızın bearer erişim jetonu.

Live Webhook Decryption Key: canlı hesabın Card webhook'larını çözmek için 64 karakterlik onaltılık anahtar.

Webhook

Webhook'lar, müşteri mağazaya dönmeden tarayıcıyı kapatsa bile ödemeyi onaylar. Bölümde mağazanızın webhook URL'si gösterilir; https://your-site/wp-json/peach-pay/v1/webhook biçimindedir. URL'yi ayarlardakiyle birebir kopyalayın. Peach Payments'tan (support@peachpayments.com) hesabınız için bu URL ile Card webhook'larını açmasını isteyin; gelen şifre çözme anahtarını aynı modun Webhook Decryption Key alanına girin.

Peach Payments her webhook'u şifreler (AES-256-GCM). Test veya canlı anahtarla çözülemeyen webhook reddedilir; böylece siparişlerinizi yalnızca Peach Payments değiştirebilir. Bir modun anahtarıyla çözülen webhook yalnızca o modda başlatılan ödemelere uygulanır. Eklenti ödeme bildirimlerini kullanır:

Webhook etkinleştirilirken gönderilen test bildirimi gibi diğer bildirimlere OK yanıtı verilir ve bunlar yok sayılır. Webhook anahtarı yoksa sipariş yalnızca müşteri ödeme sonrası mağazaya döndüğünde onaylanır.

Ödeme formu

Card brands: Peach Payments formundaki markalar: Visa, Mastercard, American Express, Diners Club. Yalnızca Entity ID'niz için açık markaları seçin. Varsayılan: Visa ve Mastercard.

Gelişmiş

Logging: Log API requests and payment results hata ayıklama bilgilerini WooCommerce > Status > Logs bölümüne, wcp_peach_pay kaynağına yazar. Hatalar ve uyarılar her zaman kaydedilir. Günlükler kart verisi, anahtar veya müşteri verisi içermez. Varsayılan: kapalı.

Delete data on uninstall: Delete the plugin settings and logs when the plugin is deleted. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Siparişlerdeki Peach Payments verileri korunur. Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini (varsayılan Credit / Debit Card (Peach Payments)) seçip Continue to payment düğmesine tıklar. Mağazanızın Pay for order sayfasına yönlendirilir. Eklenti burada siparişin toplam tutarı ve para birimiyle bir Peach Payments ödeme oturumu oluşturur ve seçili markaları içeren Peach Payments kart formunu, Peach Payments destekliyorsa site dilinde gösterir. Test modunda sayfada Test mode: use a Peach Payments test card, no real payment will be made. görünür. Kart bilgileri Peach Payments formuna girilir; form betiği Subresource Integrity özetiyle yüklenir.

Ödeme sonrası müşteri mağazaya döner. Sipariş yalnızca Peach Payments onayından sonra ödenmiş sayılır: mağaza bu siparişin ödeme sonucunu Peach Payments API üzerinden, oturumun oluşturulduğu modda okur ve ödemenin bu siparişe ait olduğunu doğrular. Webhook da bağımsız olarak aynı işlemi yapar; önce gelen sonucu uygular, diğeri hiçbir şeyi değiştirmez. Ödeme yapan müşteri Order received sayfasını görür.

Ödeme tamamlanmazsa müşteri bir mesajla Pay for order sayfasına döner ve tekrar deneyebilir: Payment failed: ardından Peach Payments nedeni ve Please try again or use another card. veya The payment was not completed. Please try again.. Sonuç henüz doğrulanamıyorsa (Peach Payments yanıtlamadıysa veya webhook aynı siparişi işliyorsa) mesaj We could not confirm your payment yet. If you were charged, the order will be updated automatically; otherwise please try again. olur. Mod için webhook anahtarı yoksa müşteriden bunun yerine sipariş numarasıyla size ulaşması istenir.

Form hazırlanamazsa müşteri kısa bir mesaj ve Try again düğmesi görür: The payment form is not available right now (payment configuration error). Please contact us or choose another payment method. (yanlış kimlik bilgileri), bazı fatura bilgilerinin ödeme sağlayıcısı tarafından kabul edilmediği mesajı veya The payment form could not be loaded. Please try again in a moment.. Siparişe Peach Payments kodu ve açıklaması içeren not eklenir.

Yöntem klasik ödeme sayfasında, Ödeme bloğunda ve Pay for order sayfasında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklentide ödeme sayfasının kendisinde kart formu, kayıtlı kart, abonelik, ön provizyon ve sonradan tahsilat ile EFT, BNPL, QR veya kart dışı diğer yöntemler yoktur.

Siparişler

Sipariş durumları

Pending payment: müşteri henüz ödemedi veya ödeme tamamlanmadı. Aynı siparişi tekrar ödeyebilir.

Processing: ödeme onaylandı; tutar ve para birimi siparişle eşleşiyor. Sipariş notunda Peach Payments sonuç kodu, açıklaması ve ödeme kimliği görünür; ödeme kimliği siparişin işlem kimliğidir. Peach Payments manuel inceleme istediyse not, göndermeden önce Peach Payments panelinde kontrol etmenizi ister.

On hold: ödeme Peach Payments onayını bekliyor (webhook daha sonra tamamlar veya başarısız işaretler); ödenen tutar veya para birimi farklı (not amount/currency mismatch — manual review required); ya da ödeme sipariş iptalinden sonra geldi. Sipariş notu neyi kontrol edeceğinizi açıklar.

Failed: Peach Payments, Ödeme bekliyor durumundaki siparişin ödemesini veya Beklemede siparişin beklediği ödemeyi reddetti. Reddedilen deneme; ödenmiş, başka nedenle bekleyen veya iptal edilmiş siparişi asla değiştirmez. Müşteri tekrar ödeyebilir.

Ödenmiş bir siparişin ikinci ödemesi başarılı olursa sipariş değişmez. Not, yinelenen ödeme olduğunu belirtip Peach Payments panelinden iade etmenizi ister. İade edilmiş siparişe gelen ödeme yalnızca not edilir.

İadeler

WooCommerce sipariş ekranından iade yapılamaz. Peach Payments panelinden iade edip WooCommerce'te manuel iade kaydedin. Webhook yapılandırılmışsa Peach Payments'taki iadeler, iptaller ve ters ibrazlar tutar ve kimlik içeren notlar olarak eklenir; sipariş durumu değişmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Peach Payments sayfasının üstündedir. Anahtarı License key alanına yapıştırıp Activate düğmesine tıklayın. Blokta lisansın geçerlilik tarihi ve alan adınız gibi durum bilgileri görünür. Yeniden kontrol için Check now, başka anahtar girmek için Change key, 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ı siteden kaldırmak alan adı yuvasını boşaltmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

Etkin anahtar yoksa Peach Payments ödeme sayfasında müşterilere gösterilmez. Yine de ödeme başlatılırsa müşteri This payment method is not available. Please choose another one. görür. Oturum açmış mağaza yöneticileri yöntemi (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece anahtar almadan önce eklentiyi kurup deneyebilirsiniz. Eklentiler ve WooCommerce sayfalarında hatırlatma görünür. Mevcut siparişler etkilenmez: başlatılmış ödemeler müşteri dönüşü ve webhook ile onaylanır.

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

Sorun giderme

Peach Payments ödeme sayfasında görünmüyor: lisansın etkin, Enable/Disable açık, geçerli modun Entity ID ve Access Token bilgilerinin girilmiş (Test Entity ID ve Test Access Token testte, Live Entity ID ve Live Access Token canlıda) ve para biriminin ZAR, KES veya MUR olduğunu kontrol edin. Ayarların üstündeki bildirimler sorunu belirtir. Geliştiriciler peach_p_supported_currencies filtresiyle para birimlerini değiştirebilir; yalnızca Peach Payments hesabınızın işlediği para birimlerini ekleyin.

Ödeme yapıldı ancak sipariş Pending payment olarak kaldı: müşteri dönmedi ve webhook gelmedi. Peach Payments'ın ayarlardaki tam URL için Card webhook'larını açtığını, ödeme modunun Webhook Decryption Key bilgisinin girildiğini ve bakım modu, güvenlik duvarı veya parolanın URL'yi engellemediğini kontrol edin. Reddedilen webhook'lar için WooCommerce > Status > Logs, wcp_peach_pay kaynağına bakın.

Webhook Decryption failed yanıtını veriyor: test veya canlı anahtarla çözülemedi. Anahtar yanlış ya da başka hesaba veya moda ait. Bu URL için Peach Payments'ın gönderdiği anahtarı girin.

Webhook Webhook key not configured yanıtını veriyor: iki anahtar da ayarlı veya geçerli değil. 64 karakterlik anahtarı girin. Peach Payments webhook'u daha sonra tekrar gönderir.

Webhook Order busy, retry later yanıtını veriyor: aynı anda müşteri dönüşü siparişi güncelliyordu. Hiçbir şey değişmedi; Peach Payments webhook'u tekrar gönderir.

Webhook Missing or malformed data yanıtını veriyor: istekte şifreli gövde veya X-Initialization-Vector / X-Authentication-Tag başlıkları yoktu; örneğin proxy değiştirmiş olabilir. Hiçbir şey değişmedi.

Webhook ignored yanıtını veriyor: bildirim gerçek ancak bu mağazanın ödeme oturumuna ait değil (aynı Entity ID'yi kullanan başka mağaza, silinmiş sipariş) veya ödemeden farklı moddan geldi. Hiçbir şey değişmedi.

Müşteri The payment form is not available right now görüyor: geçerli modun Access Token veya Entity ID bilgisi yanlış. Kimlik bilgilerini ve modu kontrol edip sipariş notundaki Peach Payments kodunu okuyun.

Ödeme sonrası sipariş On hold durumunda: sipariş notunu okuyun. Tutar veya para birimi farklıydı, ödeme iptalden sonra geldi veya Peach Payments hâlâ onay bekliyor. Peach Payments panelinden ödemeyi kontrol edip siparişi işleyin veya iade edin.

Kaydederken 64 karakterlik onaltılık webhook anahtarı isteniyor: değer Peach Payments anahtarı değil. Düzeltilene kadar webhook'lar çözülemez.

Lisans bloğu hata gösteriyor: mesajı izleyin. Anahtar başka alan adında kullanılıyorsa vibefox.net hesabınızda yuva boşaltıp Check now düğmesine tıklayın. Site adresi değiştiyse yeni alan adı için Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışır.

Kaldırma

Devre dışı bırakmak tüm verileri korur. Kaldırmak için Plugins sayfasında devre dışı bırakıp silin. Eklentinin lisans anahtarı ve lisans durumu her zaman silinir. Ayarlar ve günlükler (wcp_peach_pay kaynağının günlük dosyaları ve veritabanı kayıtları) yalnızca Delete data on uninstall açıksa silinir. Aksi halde yeniden kurulum için kalır. Mevcut siparişlerde ödeme notları, işlem kimlikleri ve Peach Payments ödeme oturumu verileri korunur.

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