VibeFox Peach Payments for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 sürümünde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 sürümünde test edildi).

PHP: OpenSSL uzantısı etkin olmak üzere 8.0 veya üzeri (webhook'ların şifresini çözmek için kullanılır).

Para birimi: müşterinin ödeme para birimi ZAR, KES veya MUR olmalıdır; bu nedenle mağazanızda System > Localisation > Currencies bölümünde bu para birimlerinden en az biri bulunmalıdır. Diğer para birimlerinde ödeme yapan müşteriler için ödeme yöntemi gizlenir. Mağazanın varsayılan para birimi bunlardan biri değilse ayarlar sayfası sizi uyarır.

Peach Payments hesabı: Peach Payments hesabınızın Card API kimlik bilgilerine ihtiyacınız vardır: Entity ID ve Access Token. Test kimlik bilgileri Peach Payments sandbox panelinden, canlı kimlik bilgileri Peach Payments panelinden alınır; bunlar birbirinden farklıdır. Webhook'lar için ayrıca, mağazanız için Card webhook'larını etkinleştirdiklerinde Peach Payments'ın size gönderdiği bir webhook şifre çözme anahtarına ihtiyacınız vardır (bkz. Yapılandırma). Webhook almak için mağazanızın internetten erişilebilir olması gerekir.

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

Kurulum

İndirme, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_peach_pay-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_peach_pay.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı her iki sürüm için de aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_peach_pay-oc3-(version).ocmod.zip dosyasını seçin. Uzantının OCMOD değişikliği yoktur, bu yüzden Extensions > Modifications bölümünün yenilenmesi gerekmez. Yükleyici yerine, bu paketin upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin ve türü Payments olarak seçin. VibeFox Peach Payments Pay Gateway uzantısını bulun ve Install düğmesine (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme uzantıları listesini değiştirme iznine sahip olması gerekir.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem düğmesi) tıklayın. VibeFox lisans anahtarınızı sayfanın üstündeki lisans bloğunda License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Peach Payments sandbox panelinden test Entity ID ve Access Token değerlerini girin; ayrıca Peach Payments'tan, ayarlar sayfasında gösterilen webhook URL'si için Card webhook'larını etkinleştirmesini isteyin (bkz. Yapılandırma).

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Test mode seçeneğini açık tutun ve ZAR, KES veya MUR cinsinden bir Peach Payments sandbox test kartıyla ödeme yapın. Ardından Test mode seçeneğini kapatın, canlı kimlik bilgilerini ve canlı webhook anahtarını girin ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_peach_pay.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış bir paket çalışmaz.

2. Paket, aynı sayfadaki yüklü eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions bölümüne gidin ve türü Payments olarak seçin. VibeFox Peach Payments Pay Gateway eklentisini bulun, Install düğmesine (yeşil + düğmesi), ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını, Peach Payments bilgilerini ve webhook'u OpenCart 3 için 3 ila 5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca webhook URL'si farklıdır (bkz. Webhook).

Yeni bir kurulum, ödeme yöntemi kapalı ve test modu açık olarak başlar.

Yapılandırma

Tüm ayarlar uzantı sayfasındadır: Extensions > Extensions > Payments > VibeFox Peach Payments Pay Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üzerinde sayfa bildirimler gösterir: Test mode is on: payments go to the Peach Payments sandbox and no real money is charged.; geçerli modun Entity ID'si veya Access Token'ı eksikse bir hata (o zamana kadar ödeme yöntemi ödeme sayfasında gösterilmez); geçerli modun webhook şifre çözme anahtarı eksikse bir uyarı (bu durumda ödemeler yalnızca müşteri mağazaya döndüğünde onaylanır); ve mağazanın varsayılan para birimi desteklenmiyorsa bir bildirim (ödeme yöntemi bu durumda yalnızca desteklenen bir para biriminde ödeme yapan müşterilere gösterilir). Uzantıyı değiştirme izni yoksa sayfa ayarları gösterir ama kaydedemez.

Kaydederken Title boş olamaz ve 128 karakterden uzun olamaz (sayfa Enter a title for the payment method (up to 128 characters). mesajını gösterir), Sort Order tam sayı olmalıdır (negatif değerlere izin verilir), Total 0 veya daha büyük bir sayı olmalıdır ve coğrafi bölge ile sipariş durumları mevcut olmalıdır. Aksi halde hiçbir şey kaydedilmez. Kimlik bilgilerinden boşluklar çıkarılır. 64 karakterlik onaltılık bir değer olmayan bir webhook anahtarı veya boş bir kart markası listesi, bir uyarıyla kaydedilir.

Peach Payments

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

Title: müşterinin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kayıtlı ödeme yöntemi adı da budur. Varsayılan: Credit / Debit Card (Peach Payments). Zorunlu, en fazla 128 karakter.

Description: müşteriye Confirm Order adımında, onay düğmesinin üstünde, bir kart simgesinin yanı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.

Sort Order: Peach Payments'ın ödeme sayfasındaki ödeme yöntemleri arasındaki konumu. Boş bırakın veya bir tam sayı girin.

Geo Zone: Peach Payments'ı yalnızca seçilen coğrafi bölgedeki ödeme adresleri için sunun. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones altında ayarlanır.

Total: Peach Payments'ın sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası toplamı. Her tutar için sunmak üzere boş bırakın.

API kimlik bilgileri

Card API'nin Access Token ve Entity ID değerleri Peach Payments panelinde gösterilir (test kimlik bilgileri sandbox panelindedir). Bölüm her iki panele ve Peach Payments geliştirici dokümantasyonuna bağlantı verir.

Test mode: yeni ödemeleri test kimlik bilgileriyle Peach Payments sandbox'ına gönderir ve gerçek para tahsil edilmez. Canlı kimlik bilgileriyle gerçek ödemeler kabul etmek için kapatın. Bir modda başlatılan ödeme, mod değiştirseniz bile her zaman o modda doğrulanır. Varsayılan: açık. Açıkken müşteri Confirm Order adımında Test mode: no real payment will be made. mesajını görür.

Test Entity ID: sandbox hesabınızın Entity ID'si (3-D Secure kanalı).

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

Test Webhook Decryption Key: sandbox Card webhook'larının şifresini çözmek için kullanılan 64 karakterlik onaltılık anahtar.

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

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

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

Kayıtlı erişim jetonları ve webhook anahtarları bir daha asla gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. mesajını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı bir değeri kaldırmak için alanın altındaki Clear the saved value on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Webhook

Webhook'lar, müşteri mağazaya dönmeden tarayıcıyı kapatsa bile ödemeleri onaylar. Webhook URL alanı mağazanızın webhook URL'sini gösterir. OpenCart 3'te URL şu biçimdedir: https://your-store/index.php?route=extension/payment/wcp_peach_pay/webhook, OpenCart 4'te https://your-store/index.php?route=extension/wcp_peach_pay/payment/wcp_peach_pay.webhook biçimindedir ve OpenCart kurulumunuzun vitrin adresinden oluşturulur. URL'yi ayarların gösterdiği gibi birebir kopyalayın. Peach Payments'tan (support@peachpayments.com) hesabınız için bu URL ile Card webhook'larını etkinleştirmesini isteyin, ardından aldığınız ş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 şifresi çözülemeyen bir webhook reddedilir; böylece siparişlerinizi yalnızca Peach Payments değiştirebilir. Bir modun anahtarıyla şifresi çözülen bir webhook yalnızca o modda başlatılan ödemelere uygulanır. Uzantı şu ödeme bildirimlerini kullanır:

Diğer bildirimler, örneğin webhook etkinleştirildiğinde gönderilen test bildirimi, ignored yanıtı alır. Webhook anahtarı yoksa bir sipariş, yalnızca müşteri ödeme yaptıktan sonra mağazaya döndüğünde durum alır.

Ödeme formu

Card brands: Peach Payments formunda gösterilen markalar: Visa, Mastercard, American Express, Diners Club. Yalnızca Entity ID'niz için etkinleştirilmiş markaları seçin. Varsayılan: Visa ve Mastercard. Hiçbir marka seçilmezse kaydetme bir uyarı gösterir ve form Visa ile Mastercard'ı gösterir.

Siparişler

Sipariş, Confirm Order adımında durumsuz (eksik bir sipariş) olarak oluşturulur ve yalnızca Peach Payments ödemeyi onayladıktan sonra bir durum alır. Reddedilen veya terk edilen bir ödeme siparişi durumsuz bırakır ve sepet korunur. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: Peach Payments ödemeyi onayladığında ve tutar ile para birimi eşleştiğinde ayarlanır. Varsayılan: İşleniyor.

Awaiting Payment Status: Peach Payments, bir onay bekleyen eşzamansız bir ödeme bildirdi; webhook bunu daha sonra onaylar. Varsayılan: Beklemede, çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturabilir ve burada seçebilirsiniz.

On Hold (Review) Status: manuel inceleme: ödenen tutar veya para birimi siparişle eşleşmiyor ya da bir ödeme sipariş iptal edildikten sonra geldi. Bir not nedeni açıklar. Varsayılan: Beklemede.

Payment Failed Status: siparişin beklediği eşzamansız ödeme reddedildiğinde ayarlanır. Sonraki başarılı bir ödeme yine de siparişi tamamlar. Varsayılan: Failed.

Canceled Status: uzantı bunu ayarlamaz. Bu durumdaki bir sipariş için yapılan ödeme, siparişi yeniden açmak yerine inceleme durumuna alır. Varsayılan: Canceled.

Refunded Status: uzantı bunu ayarlamaz. Bu durumdaki bir sipariş için alınan ödeme yalnızca not edilir ve sipariş değiştirilmez. Varsayılan: Refunded.

Gelişmiş

Logging: API isteklerini ve ödeme sonuçlarını OpenCart günlükleri klasöründeki (storage/logs) peach_p_debug.log.php dosyasına kaydeder. Dosya web üzerinden okunamaz; 5 MB'a ulaştığında peach_p_debug.old.log.php dosyasına taşınır. Hatalar ve uyarılar her zaman kaydedilir. Günlükler kart verisi, anahtar veya müşteri verisi içermez. Varsayılan: kapalı.

Log: günlüğün boyutunu ve en son girdilerini gösterir. Temizlemek için Clear log düğmesine tıklayın.

Delete data on uninstall: açıkken uzantının kaldırılması ağ geçidi ayarlarını ve günlüğü siler. Siparişlerin Peach Payments verileri (ödeme denemeleri ve ödeme kimlikleri) siparişlere ait oldukları için korunur. Varsayılan: kapalı.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. Erişim jetonları ve webhook anahtarları dışa aktarılmaz.

Import: daha önce dışa aktarılan JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın. Kayıtlı erişim jetonları ve webhook anahtarları korunur.

Ödeme

Müşteri Payment Method adımında ödeme yöntemini seçer (varsayılan olarak Credit / Debit Card (Peach Payments)). Confirm Order adımında müşteri bir kart simgesi ve açıklamanızı görür; OpenCart siparişi bu adımda, yine durumsuz olarak oluşturur. Müşteri Confirm Order düğmesine tıkladığında uzantı, sipariş tutarı için sipariş para biriminde bir Peach Payments ödemesi hazırlar ve mağazanızın Peach Payments payment sayfasını Please enter your card details to complete the payment: metniyle, Peach Payments kart formuyla ve seçilen kart markalarıyla açar; Peach Payments destekliyorsa müşterinin dilinde. Test modunda sayfa Test mode: use a Peach Payments test card, no real payment will be made. mesajını gösterir. Kart bilgileri Peach Payments formuna girilir ve form betiği bir Subresource Integrity hash'i ile yüklenir. Choose another payment method bağlantısı ödeme sayfasına geri götürür. Sayfayı yeniden yüklemek, sipariş tutarı değişmediği sürece aynı ödemeyi en fazla 25 dakika boyunca yeniden kullanır. OpenCart 4'te müşteri, ödeme yöntemini ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde seçer ve ödeme sayfasının altındaki Confirm Order düğmesine tıklar.

Ödemeden sonra müşteri mağazanıza döner. Sipariş, yalnızca Peach Payments onayladığında ödenmiş olarak işaretlenir: mağaza, bu siparişin ödemesinin sonucunu, ödeme oluşturulduğu moddaki Peach Payments API'sinden okur ve ödemenin bu siparişe ait olduğunu doğrular. Webhook bunu bağımsız olarak yapar; hangisi önce gelirse sipariş durumunu o belirler, diğeri bir şey değiştirmez. Ardından sipariş, olağan e-posta bildirimleri ve stok güncellemesiyle OpenCart'ın standart yoluyla durumunu alır ve müşteri OpenCart sipariş başarı sayfasını görür. OpenCart 4'te müşteri 3-D Secure banka sayfasından döndüğünde, kısa bir ara sayfa mağazanızın dönüş adresini yeniden açar; böylece sepet ve müşteri girişi korunur.

Ödeme tamamlanmazsa müşteri bir mesajla ödeme sayfasına döner ve yeniden deneyebilir: Payment failed: ile başlayan, Peach Payments'tan gelen neden ve Please try again or use another card. ya da The payment was not completed. Please try again. Sepet korunur. Sonuç henüz doğrulanamıyorsa (örneğin Peach Payments yanıt vermediyse veya webhook tam o anda aynı sepeti işliyorsa), mesaj şudur: We could not confirm your payment yet. If you were charged, the order will be updated automatically; otherwise please try again. Ödemenin modu için bir webhook anahtarı ayarlanmamışsa müşteriden bunun yerine sizinle iletişime geçmesi istenir. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir.

OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise siparişi günceller, ancak bir sepet yalnızca bir kez ödenir: aynı sepetteki başka bir sipariş zaten ödenmişse müşteri doğrudan başarı sayfasına gider. Sepette yapılan her değişiklik, yeni adet dahil, kendi ödemesini gerektiren yeni bir sepet sayılır.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme adımında tutar. Ödenmeyen bir denemeden sonra müşteri aynı siparişi yeni bir Peach Payments ödemesi ile yeniden öder. Bu sipariş ödeme yapılmadan kapatılmışsa (örneğin beklenen ödemesi başarısız olduysa ya da siz iptal ettiyseniz), müşteri Önceki siparişiniz kapatıldı veya ödendi. Lütfen siparişi yeniden onaylayın: sepet yeni bir siparişle ödenecek. mesajıyla ödeme adımına geri döner. Bir sonraki Confirm Order yeni bir sipariş için ödeme yapar. Sipariş ödendikten sonra siz iptal edip iade ettiyseniz mesaj: Bu sipariş mağaza tarafından iptal edildi veya iade edildi. Ödemesi için mağazayla iletişime geçin ya da siparişi yeniden onaylayın: sepet yeni bir siparişle ödenecek. Kapatılmış bir sipariş asla ödenmiş gibi gösterilmez.

Ödeme formu hazırlanamazsa müşteri kısa bir mesajla Confirm Order adımında kalır: The payment form is not available right now (payment configuration error). Please contact us or choose another payment method. (kimlik bilgileri eksik veya hatalıysa), bazı fatura bilgilerinin ödeme sağlayıcısı tarafından kabul edilmediğini belirten bir mesaj veya The payment form could not be loaded. Please try again in a moment. Teknik neden günlüğe yazılır.

Webhook, mağaza bakım modundayken de çalışır, çünkü OpenCart ödeme uzantılarının isteklerine izin verir. OpenCart 4'te uzantı bunun için kendi başlangıç eylemini ekler; bu eylem müşterinin dönüşüne de izin verir.

Uzantının ödeme adımının kendisinde bir kart formu, kayıtlı kart, abonelik, ön provizyon ve sonradan tahsilat ya da EFT, BNPL, QR gibi kart dışı yöntemler yoktur.

Siparişler

Sipariş durumları

Durum yok (eksik sipariş): müşteri ödeme yapmadı, ödeme reddedildi veya tamamlanmadı ya da Peach Payments henüz onaylamadı. Müşteri yeniden ödeme yapabilir. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir. OpenCart 4.1'de bu tür bir siparişe, OpenCart'ın onay adımı yeniden gösterildiğinde atadığı Voided durumu da verilebilir; eklenti bunu durumsuz bir sipariş olarak sayar.

Order Status After Payment (default Processing): ödeme onaylandı ve tutar ile para birimi siparişle eşleşiyor. Bir not, Peach Payments sonuç kodunu, açıklamasını ve ödeme kimliğini gösterir. Peach Payments ödemeyi manuel inceleme için işaretlediyse not, göndermeden önce Peach Payments panelinde kontrol etmenizi ister.

Awaiting Payment Status (default Pending): Peach Payments, bir onay bekleyen bir ödeme bildirdi. Webhook daha sonra siparişi Order Status After Payment veya Payment Failed Status durumuna taşır.

On Hold (Review) Status (default Pending): ödenen tutar veya para birimi siparişle eşleşmiyor (not: amount/currency mismatch — manual review required) ya da ödeme sipariş iptal edildikten sonra geldi. Ödemeyi Peach Payments panelinde kontrol edin, ardından siparişi işleyin veya ödemeyi iade edin.

Payment Failed Status (default Failed): Peach Payments, bekleyen siparişin beklediği ödemeyi reddetti. Reddedilen bir deneme, ödenmiş veya incelemedeki bir siparişi asla değiştirmez.

Zaten ödenmiş bir siparişe ait ikinci bir ödeme başarılı olursa ya da zaten ödenmiş bir sepetin başka bir siparişine ait bir ödeme gelirse, ödenmiş sipariş değiştirilmez. Bir not, bunun mükerrer bir ödeme olduğunu belirtir ve Peach Payments panelinde iade edilmesini ister. İade edilmiş bir siparişe gelen ödeme yalnızca siparişte not edilir.

Notlar, müşterinin görmediği sipariş History kayıtlarıdır.

VibeFox Peach Payments Pay Gateway sekmesi

Sales > Orders bölümünde Peach Payments ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan uzantı sekmesi; test ödemeleri için Test mode etiketiyle birlikte Payment ID, Checkout ID, Merchant transaction ID, Amount sent to Peach Payments, sonuç kodlu Result ve siparişin Peach Payments notes kayıtlarını gösterir. Sekme, uzantıya erişimi olan kullanıcılara gösterilir.

İadeler

OpenCart üzerinden iade yapılamaz. Ödemeyi Peach Payments panelinde iade edin ve gerekirse OpenCart'ta kaydedin. Webhook kuruluysa Peach Payments'ta yapılan iadeler, geri almalar ve chargeback'ler tutar ve kimlikle birlikte sipariş notlarına eklenir; sipariş durumu değişmez. Sales > Returns bölümündeki ürün iadeleri Peach Payments üzerinden para geri göndermez.

Lisans anahtarı

Uzantı, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Peach Payments Pay Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Peach Payments Pay Gateway > Edit sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve şu düğmeleri gösterir: durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: opencart-payment-peach satırı ve hesabınızda vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca uzantı için Modify iznine sahip yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir; örneğin Key not found, This key belongs to another product, Domain limit reached veya License expired on ve bir tarih. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvası boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa uzantı son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak alan adı yuvasını boşaltmaz. Yuvayı vibefox.net hesabınızda boşaltın.

Etkin bir anahtar olmadan Peach Payments müşterilere ödeme sayfasında gösterilmez. Yine de bir ödeme başlatılırsa müşteri This payment method is not available. Please choose another one. mesajını görür. Yönetim paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada hâlâ (unlicensed — visible to admins only) işaretiyle görür; böylece anahtar satın almadan önce uzantıyı kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetim panelinin Dashboard bölümünde bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: başlatılmış ödemeler müşterinin geri dönüşü ve webhook ile onaylanmaya devam eder.

Bir lisansın süresi dolduğunda uzantı çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetim panelinde Dashboard veya Edit sayfasını açtığınızda durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün günde bir kez, ardından haftada bir kez. Cron işi gerekmez. Uzantının kaldırılması her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Peach Payments ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modun Entity ID ve Access Token değerlerinin girildiğini (test modunda Test Entity ID ve Test Access Token, canlı modda Live Entity ID ve Live Access Token) ve müşterinin ZAR, KES veya MUR cinsinden ödeme yaptığını kontrol edin. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlardaki Total tutarına ulaştığını kontrol edin. Ayarların üstündeki bildirimler sorunu belirtir.

Ödeme geçti ama sipariş durumsuz kaldı: müşteri mağazaya dönmedi ve webhook gelmedi. Peach Payments'ın Card webhook'larını tam olarak ayarlarda gösterilen URL için etkinleştirdiğini, ödemenin yapıldığı modun Webhook Decryption Key değerinin girildiğini ve bir güvenlik duvarı ya da parola korumasının URL'yi engellemediğini kontrol edin. Logging seçeneğini açın ve reddedilen webhook'ları görmek için Log alanına bakın.

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

Webhook Webhook key not configured yanıtı veriyor: ne bir webhook anahtarı ayarlanmış ne de geçerli. 64 karakterlik anahtarı girin. Peach Payments webhook'u daha sonra yeniden gönderecek.

Webhook Busy, retry later yanıtı veriyor: sepet, müşterinin geri dönüşü tarafından aynı anda işleniyordu. Hiçbir şey değişmedi ve Peach Payments webhook'u yeniden gönderecek. Günlük nedeni gösterir.

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

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

Webhook URL'si tarayıcıda Method not allowed gösteriyor: bu normaldir. URL yalnızca Peach Payments'tan gelen istekleri kabul eder.

Müşteri The payment form is not available right now mesajını görüyor: geçerli modun Access Token'ı veya Entity ID'si yanlış. Kimlik bilgilerini ve modu kontrol edin, Peach Payments kodunu görmek için günlüğü okuyun.

Müşteri The payment session was not found. Please confirm the order again. mesajını görüyor: ödeme sayfası artık müşterinin geçerli siparişi olmayan bir sipariş için açıldı veya bu sırada ödeme yöntemi kapatıldı. Müşteri siparişi yeniden onaylamalıdır.

Ödemeden sonra sipariş inceleme durumunda: uzantı sekmesindeki notları okuyun. Ödenen tutar veya para birimi siparişten farklıydı ya da ödeme siparişin iptal edilmesinden sonra geldi. Ödemeyi Peach Payments panelinde kontrol edin, ardından siparişi işleyin veya ödemeyi iade edin.

Kaydederken webhook anahtarının 64 karakterlik onaltılık anahtar olması gerektiği görünüyor: değer Peach Payments'ın anahtarı değil. Düzeltilene kadar webhook'ların şifresi çözülemez.

Kaldırma

Extensions > Extensions bölümüne gidin, türü Payments olarak seçin ve VibeFox Peach Payments Pay Gateway yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu uzantının lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, uzantının kendi ayarlarını her zaman kaldırır: Enable/Disable, Sort Order, Geo Zone, Total ve Orders bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılan değerlerine döner. Delete data on uninstall açıksa diğer ağ geçidi ayarları (başlık, açıklama, test modu, kimlik bilgileri, webhook anahtarları, kart markaları, günlükleme) ve günlük silinir. Kapalıysa ileride yeniden kurulum için saklanır. Ödeme denemeleri ve ödeme kimlikleri her zaman korunur. OpenCart 4'te uzantının olayları ve bakım modunda webhook ile müşteri dönüşüne izin veren başlangıç eylemi her zaman kaldırılır. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te uzantının dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer bölümüne gidin, yüklü eklentiler listesinde VibeFox Peach Payments Pay Gateway yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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