VibeFox PayMongo for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 ile test edildi) veya 4.0.2 ve üzeri (4.1.0.3 ile test edildi).

PHP: 8.0 veya üzeri.

Para birimi: Filipin pesosu (PHP). PayMongo, yalnızca müşteri PHP ile ödeme yaptığında ve toplam en az 100,00 ₱ olduğunda ödeme sayfasında gösterilir. Mağazanızda yoksa para birimini System > Localisation > Currencies bölümünden ekleyin. Mağazanızın varsayılan para birimi PHP değilse, ayarlar sayfası sizi uyarır ve müşterilerin PayMongo'yu görebilmesi için PHP'ye geçmeleri gerekir.

PayMongo hesabı: PayMongo hesabınızın gizli API anahtarlarına ve her mod için bir webhook'a ihtiyacınız vardır (bkz. Yapılandırma). Yalnızca gizli anahtarlar (sk_test_..., sk_live_...) ve webhook imza gizli anahtarları (whsk_...) kullanılır. Ödeme sayfası PayMongo tarafından barındırıldığı için genel anahtarlara gerek yoktur. Sunduğunuz ödeme yöntemleri PayMongo hesabınız için etkinleştirilmiş olmalıdır.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar 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_paymongo_payment_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_paymongo_payment_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze ait paketi kurun. Lisans anahtarı iki sürüm için aynıdır.

OpenCart 3

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

2. Extensions > Extensions bölümüne gidin ve türü Payments olarak seçin. VibeFox PayMongo Payment Gateway eklentisini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın.

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

4. PayMongo gizli anahtarlarınızı yapıştırın, PayMongo'da webhook'ları oluşturun ve imza gizli anahtarlarını yapıştırın (bkz. Yapılandırma).

5. Ödeme yöntemlerini seçin, Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Test mode açıkken bir ödeme deneyin, ardından kapatın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_paymongo_payment_gateway.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 kurulu 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 PayMongo Payment Gateway eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını, PayMongo anahtarlarını, webhook'ları ve ödeme yöntemlerini OpenCart 3 için 3. ila 5. adımlardaki gibi girin. Ayarlar sayfası ve alanları iki sürümde 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 eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox PayMongo Payment Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa, mağazanın varsayılan para birimi PHP değilse, geçerli modda gizli anahtar yoksa (bu durumda PayMongo ödeme sayfasında gösterilmez) veya webhook gizli anahtarı yoksa (bu durumda ödemeler yalnızca müşteri mağazanıza döndüğünde onaylanır) sizi uyarır ve test modu açıkken Test mode is on: no real payments are made. mesajını gösterir.

Kaydederken Title boş olamaz (en fazla 128 karakter), Sort Order tam sayı olmalıdır (negatif sayılar kabul edilir), Total 0 veya daha büyük bir sayı olmalıdır ve seçilen coğrafi bölge ile sipariş durumları mevcut olmalıdır. Aksi takdirde hiçbir şey kaydedilmez ve sayfa alanı belirtir. Yanlış önek taşıyan bir anahtar kaydedilmez, ancak diğer alanlar kaydedilir (bkz. API anahtarları).

PayMongo

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

Title: müşterinin ödeme sırasında gördüğü ödeme yöntemi adı. Siparişte de ödeme yöntemi adı olarak saklanır. Varsayılan: PayMongo (Card, GCash, GrabPay, Maya). Zorunlu, en fazla 128 karakter.

Description: müşterinin Confirm Order adımında onay düğmesinin üzerinde gördüğü metin. Varsayılan: You will be redirected to PayMongo to pay securely with your card, GCash, GrabPay or Maya.

Payment methods: PayMongo ödeme sayfasında sunulan yöntemler. Yalnızca PayMongo hesabınız için etkinleştirilmiş yöntemleri seçin; aksi halde PayMongo ödemeyi reddeder. Hiçbiri seçilmezse varsayılanlar kullanılır. Varsayılan: Cards, GCash, GrabPay ve Maya.

Sort Order: ödeme sırasında PayMongo'nun ödeme yöntemleri arasındaki konumu. Boş bırakın veya bir tam sayı girin.

Geo Zone: PayMongo'yu yalnızca seçilen coğrafi bölgedeki ödeme adresleri için sunar. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde tanımlanır.

Total: PayMongo'nun sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme toplamı; PayMongo'nun 100,00 ₱ minimumuna ek olarak. Ek bir minimum istemiyorsanız boş bırakın.

API anahtarları

Gizli anahtarları PayMongo Dashboard > Developers > API keys bölümünden kopyalayın (bölüme giden bağlantılar orada bulunur). Genel anahtarlara gerek yoktur. Her anahtar beklenen önekle başlamalıdır. Yanlış önek taşıyan bir değer, örneğin test alanına girilen canlı bir anahtar, kaydedilmez: sayfa alanın önekle başlaması gerektiğini ve The previous value was kept. mesajını gösterir.

Test mode: Enable test mode (no real payments). Yeni ödemeler test anahtarlarını kullanır. Daha önce yapılan ödemeler, yapıldıkları modu korur; böylece durum kontrolleri ve iadeler eşleşen anahtarı kullanır. Varsayılan: açık. Gerçek ödeme almak için kapatın. Açıkken müşteri Confirm Order adımında Test mode: no real payment will be made. mesajını görür.

Test secret key: test modunun gizli anahtarı. sk_test_ ile başlar.

Test webhook secret: test modu webhook'unun imza gizli anahtarı. whsk_ ile başlar.

Live secret key: canlı modun gizli anahtarı. sk_live_ ile başlar.

Live webhook secret: canlı mod webhook'unun imza gizli anahtarı. whsk_ ile başlar.

Kayıtlı anahtarlar ve gizli 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, müşteri ödeme yaptıktan sonra tarayıcıyı kapatsa bile mağazanıza bir ödemenin yapıldığını bildirir. PayMongo Dashboard'da (veya PayMongo API'si üzerinden) test ve canlı her mod için, bu bölümde Webhook URL altında gösterilen URL ile bir webhook oluşturun. OpenCart 3'te URL şöyle görünür: https://your-store/index.php?route=extension/payment/wcp_paymongo_payment_gateway/webhook, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_paymongo_payment_gateway/payment/wcp_paymongo_payment_gateway.webhook şeklindedir ve OpenCart kurulumunuzun mağaza adresinden oluşturulur. URL'yi ayarların gösterdiği biçimde birebir kopyalayın.

Bu olayları seçin (bu bölümde de listelenmişlerdir):

Her webhook'un imza gizli anahtarını (whsk_...) Test webhook secret veya Live webhook secret alanına kopyalayın. Geçerli imzası olmayan webhook'lar reddedilir. İmza, kendi modunun gizli anahtarıyla kontrol edilir ve olayın modu bununla eşleşmelidir; böylece bir test webhook'u asla canlı bir ödemeyi onaylamaz. Her olay, bir sipariş değiştirilmeden önce ödemenin modundaki gizli anahtarla PayMongo API'si üzerinden yeniden kontrol edilir. Bu mağazada başlatılmamış ödemelere ait olaylar yok sayılır. Webhook olmadan, bir sipariş yalnızca müşteri ödeme yaptıktan sonra mağazaya döndüğünde onaylanır.

Siparişler

OpenCart, siparişi Confirm Order adımında durum olmadan oluşturur (eksik bir sipariş). Sipariş, yalnızca PayMongo ödemeyi onayladıktan sonra bir duruma kavuşur. OpenCart'ta On hold durumu yoktur: varsayılan olarak bekleme durumu ve beklemede durumu ikisi de Pending'dir; PayMongo sekmesi ve sipariş notları bunları birbirinden ayırt eder. Kendi durumlarınızı System > Localisation > Order Statuses bölümünde oluşturabilir ve burada seçebilirsiniz. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Order status after payment: başarılı bir ödemeden sonra ayarlanan durum. Varsayılan: Processing. Complete, kargo gerektirmeyen sanal veya indirilebilir ürünler için uygundur.

Awaiting PayMongo payment: müşteri PayMongo sayfasında işlemi tamamladı, ancak ödeme hâlâ işleniyor (örneğin çevrim içi banka havalesi). Webhook veya bir sonraki kontrol siparişi tamamlar. Varsayılan: Pending.

PayMongo payment on hold: tutar veya para birimi uyuşmazlığı, canlı bir mağazada test ödemesi ya da sipariş iptal edildikten sonra gelen bir ödeme. Bir not nedenini açıklar. Varsayılan: Pending.

Failed status: beklemedeki bir ödeme daha sonra başarısız oldu (payment.failed). Durumu olmayan bir siparişte başarısız bir deneme, siparişi durumsuz bırakır ve müşteri yeniden ödeme yapabilir. Varsayılan: Failed.

Cancelled status: iptal edilen bir siparişe verdiğiniz durum. Daha sonra gelen bir ödeme, siparişi tamamlamak yerine beklemeye alır. Varsayılan: Canceled.

Refunded status: ödeme, sipariş sekmesinden tamamen iade edildikten sonra ayarlanır. Varsayılan: Refunded.

Gelişmiş

Debug log: PayMongo API çağrılarını ve webhook olaylarını OpenCart günlükler klasöründeki (storage/logs) paymongo_p_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Hatalar ve uyarılar, anahtar kapalıyken bile her zaman kaydedilir. Anahtarlar ve müşteri verileri asla kaydedilmez. Varsayılan: kapalı.

Log: günlüğün boyutunu ve en son girişlerini gösterir. Boşaltmak için Clear log düğmesine tıklayın.

Delete data on uninstall: açıkken eklentiyi kaldırmak, ağ geçidi ayarlarını ve günlüğü siler. Siparişler ve iadeler için saklanan PayMongo kimlikleri her zaman korunur, çünkü iadeler ve muhasebe için gereklidir. Varsayılan: kapalı.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. Gizli anahtarlar dışa aktarılmaz.

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

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak PayMongo (Card, GCash, GrabPay, Maya)). Confirm Order adımında müşteri sizin açıklamanızı ve After you confirm the order you will be redirected to PayMongo to complete the payment. notunu görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. 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.

Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş toplamı için PHP cinsinden bir PayMongo ödeme oturumu (Checkout Session) oluşturur; bunda Order # satırı ve sipariş numarası yer alır ve müşteriyi PayMongo ödeme sayfasına gönderir. Müşterinin adı, e-posta adresi, telefonu ve fatura adresi PayMongo'ya iletilir. Orada müşteri seçilen yöntemlerden birini seçer ve öder. Siparişteki bir not PayMongo ödeme oturumunu kaydeder.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş, yalnızca PayMongo onayladıktan sonra ödenmiş olarak işaretlenir: eklenti, müşteri geri döndüğünde ve webhook geldiğinde PayMongo API'sine ödeme hakkında sorgu yapar. Sipariş ardından OpenCart'ın standart yoluyla durumunu alır; normal sipariş e-postaları ve stok güncellemesiyle birlikte. Müşteri, OpenCart sipariş başarı sayfasında Your PayMongo payment has been received. mesajını görür. Müşteri geri döndüğünde PayMongo ödemeyi hâlâ işliyorsa, sipariş beklemede durumunu alır ve sayfa PayMongo is still processing your payment. Your order will be updated as soon as PayMongo confirms it — please do not pay again. mesajını gösterir. Beklemedeki bir sipariş için Your payment was received and is being reviewed. We will update your order shortly. mesajı gösterilir. Müşteri geri döndüğünde PayMongo'ya ulaşılamazsa, bir Payment confirmation sayfası şunu söyler: Your payment is being confirmed by PayMongo. You will receive an e-mail as soon as it is confirmed — please do not pay again. ve bir Check again düğmesi bulunur; webhook geldiği anda sipariş durumunu ayarlar. Bir sipariş beklemedeki durumdan ödenmiş duruma veya ödeme hatası durumuna geçtiğinde, müşteri olağan OpenCart sipariş durumu e-postasını alır.

Müşteri PayMongo sayfasında iptal ederse ya da ödemeyi tamamlamazsa, You cancelled the PayMongo payment. You can try again or choose another payment method. veya Your PayMongo payment was not completed. You can try again or choose another payment method. mesajıyla ödeme adımına döner. Sepet korunur. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir. Yeni bir deneme (OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ödemenin siparişini günceller) önce öncekini kontrol eder: bu arada ödenmişse, yeni bir ödeme alınmadan ödeme onaylanır; değilse önceki PayMongo ödeme bağlantısı süresi dolar, böylece sepet iki kez ödenemez. Önceki ödeme hâlâ işlenirken müşteri Your previous PayMongo payment for this order is still being processed. Please wait a few minutes before trying again. mesajını görür. Aynı sepetteki başka bir sipariş zaten ödenmişse ya da ödeme bekliyorsa, müşteri başarı sayfasına yönlendirilir. Sepette yapılan bir değişiklik, yeni bir miktar dahil, kendi ödemesini gerektiren yeni bir sepet sayılır.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme sayfasında tutar. Bu sipariş bu arada kapatıldıysa (örneğin siz iptal ettiyseniz) ya da farklı bir sepet için ödendiyse, müşteri Your previous order is already closed. Please confirm the order again: the cart will be paid with a new order. mesajıyla ödeme sayfasına geri gönderilir. Bir sonraki Confirm Order yeni bir siparişi öder. Ödenmiş bir sipariş, farklı bir sepet için asla ödenmiş gibi gösterilmez.

PayMongo ödemeyi başlatamazsa, müşteri Confirm Order adımında düğmenin üstünde kısa bir mesajla kalır; örneğin The payment could not be started. Please try again or choose another payment method. veya PayMongo could not be reached. Please try again in a moment. Teknik neden günlüğe yazılır.

Mağaza bakım modundayken de webhook çalışır, çünkü OpenCart ödeme eklentisi isteklerine izin verir (OpenCart 4'te eklenti bunun için kendi başlangıç eylemini ekler; bu eylem müşterinin PayMongo'dan dönüşüne de izin verir).

Eklenti, PayMongo sayfasında tek seferlik ödemeleri kabul eder. Kendi ödeme sayfanızda kart alanı, kayıtlı kart, abonelik veya yinelenen ödeme, taksit ve ayrı yetkilendirme ve tahsilat işlemleri yoktur.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri PayMongo'ya yönlendirildi ve ödeme yapmadı ya da PayMongo ödemeyi henüz onaylamadı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Ödemeden sonraki sipariş durumu (varsayılan Processing): ödeme onaylandı. Bir not; PayMongo ödemesini, tutarı, yöntemi, modu ve nasıl onaylandığını (webhook, geri dönüş ya da ödeme yeniden denemesi) gösterir.

PayMongo ödemesi beklemede (varsayılan Pending): müşteri, PayMongo ödemeyi hâlâ işlerken geri döndü. PayMongo onayladığında sipariş ödenmiş duruma geçer.

PayMongo ödemesi beklemede (varsayılan Pending): ödenen tutar veya para birimi sipariş toplamından farklı; ya da mağaza canlı modda iken test modunda bir ödeme yapıldı, bu nedenle para alınmadı; ya da ödeme, sipariş iptal edildikten sonra geldi. Not nedenini açıklar. Siparişi kontrol edin ve işleyin veya ödemeyi iade edin.

Failed durumu (varsayılan Failed): imzalı bir payment.failed webhook'u, beklemedeki bir siparişin son ödeme denemesinin başarısız olduğunu bildirdi. Not, PayMongo'nun hata kodunu ve mesajını gösterir. Aynı ödeme daha sonra başarılı olursa sipariş ödenmiş duruma geçer.

Refunded durumu (varsayılan Refunded): ödeme, eklenti üzerinden tamamen iade edildi.

Zaten ödenmiş bir sipariş ya da zaten ödenmiş bir sepetin başka bir siparişi için ikinci bir ödeme gelirse, ödenmiş sipariş değiştirilmez. Bir not, mükerrer ödemeyi PayMongo Dashboard'da iade etmenizi ister. Ödenmiş ve sonra iptal edilmiş ya da iade edilmiş bir sipariş asla yeniden açılmaz.

Notlar, müşterinin görmediği siparişin History bölümündeki kayıtlardır.

VibeFox PayMongo Payment Gateway sekmesi

Sales > Orders bölümünde PayMongo ile ödenmiş bir sipariş açın. Sipariş sayfasının altında, History ve Additional yanında, VibeFox PayMongo Payment Gateway sekmesi PayMongo payment, PayMongo payment intent, PayMongo checkout, test ödemeleri için Test mode etiketiyle birlikte PayMongo mode, Status, Paid / refunded tutarları, iade formu, iade geçmişi ve siparişin Notes bölümünü gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox PayMongo Payment Gateway sekmesinde Amount girin (henüz iade edilmemiş tutar otomatik doldurulur), isterseniz bir Reason (optional) ekleyin ve Refund via PayMongo düğmesine tıklayın. Refund this amount through PayMongo? This cannot be undone. sorusunu onaylayın. En fazla iki ondalık basamaklı tam ve kısmi iadeler desteklenir. Eklentiyi değiştirme yetkisine ihtiyacınız vardır (System > Users > User Groups bölümünde ayarlanır). İadeler, PayMongo'nun gerçekten tahsil ettiği tutarla sınırlıdır; bu nedenle bir tutar uyuşmazlığından sonra, sipariş toplamına değil, müşterinin ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı modun (test veya canlı) gizli anahtarıyla gönderilir, bu nedenle o anahtarın ayarlı olması gerekir. PayMongo iadeyi kabul etmezse sekme hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, PayMongo iade kimliği ve durumuyla birlikte iade geçmişine ve notlara eklenir. Tam bir iade, siparişi müşteriye bildirmeden ve ürünleri stoğa geri eklemeden Refunded status durumuna alır; tıpkı manuel bir durum değişikliği gibi. Kısmi bir iade durumu değiştirmez.

Sales > Returns bölümündeki ürün iadeleri PayMongo üzerinden para geri göndermez. PayMongo Dashboard'da yapılan iadeler OpenCart'a bildirilmez. Bunun yerine sipariş sekmesinden iade yapın ya da siparişi manuel olarak güncelleyin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınmış bir VibeFox lisans anahtarıyla çalışır. License — VibeFox PayMongo Payment Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox PayMongo Payment Gateway > Edit sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin 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-paymongo satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca eklenti için Modify izni olan 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 tarihli License expired on. Mağaza adresi değiştikten sonra ya da hesabınızda bir alan adı yuvasını boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

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

Etkin bir anahtar olmadan PayMongo, ödeme sırasında müşterilere 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önetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada (unlicensed — visible to admins only) işaretiyle hâlâ görür; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu yüzden etkin bir anahtar olmadan ödeme yöntemi herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra, yönetici Dashboard sayfasında bir hatırlatma belirir. × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır ve iadeler çalışmaya devam eder.

Bir lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici Dashboard sayfasını ya da Edit sayfasını açtığınızda durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Eklentiyi kaldırmak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

PayMongo ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modda gizli anahtar bulunduğunu (test modunda Test secret key, canlı modda Live secret key), müşterinin PHP ile ödeme yaptığını ve toplamın en az 100,00 ₱ olduğunu kontrol edin. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlardaki Total değerine ulaştığını kontrol edin.

Ödeme geçti ama sipariş durumsuz kaldı: webhook çalışmıyor ve müşteri mağazaya geri dönmedi. PayMongo Dashboard'da kullandığınız modda bir webhook olduğunu, URL'sinin tam olarak Webhook URL altında gösterilen URL olduğunu ve üç olayın seçili olduğunu kontrol edin. İmza gizli anahtarının ilgili alanda (Test webhook secret veya Live webhook secret) olduğunu kontrol edin.

Webhook Invalid signature yanıtı veriyor: bu modun imza gizli anahtarı eksik ya da başka bir webhook'a ait. Webhook'un imza gizli anahtarını kendi modunun alanına yapıştırın.

Webhook Mode mismatch yanıtı veriyor: bir test olayı canlı olarak ya da tersi şekilde imzalanmış. Her webhook'un doğru moda ait olduğunu kontrol edin.

Webhook Temporary error yanıtı veriyor: ödeme PayMongo API'si üzerinden kontrol edilemedi; örneğin ödemenin modundaki gizli anahtar eksik olduğu için. PayMongo webhook'u otomatik olarak yeniden dener.

Webhook Busy, retry yanıtı veriyor: sipariş aynı anda başka bir istek tarafından onaylanıyordu ya da sipariş durumu ayarlanamadı. PayMongo webhook'u otomatik olarak yeniden dener. Neden Log içinde yazar.

Webhook Ignored yanıtı veriyor: olay, bu mağazada başlatılmamış bir ödemeye ya da başka bir moda ait. Hiçbir şey değiştirilmez.

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

Değer kaydedilmedi: bir anahtar yanlış alana yapıştırılmış. Gizli anahtarlar sk_test_ veya sk_live_ ile, webhook gizli anahtarları whsk_ ile başlar.

Müşteri Confirm Order sonrasında bir hata görüyor: eklenti sayfasındaki Log alanına bakın. Yanlış bir gizli anahtar, ödeme yönteminin geçici olarak kullanılamadığı mesajını verir. PayMongo hesabınız için etkinleştirilmemiş bir ödeme yöntemi, PayMongo'nun ödemeyi reddetmesine neden olur; bu yöntemi Payment methods bölümünden kaldırın. This payment method is not available. Please reload the checkout page. mesajı, ödeme oturumunun artık siparişle eşleşmediği ya da bu arada ödeme yönteminin kapatıldığı anlamına gelir.

Canlı bir mağazada test ödemeleri: mağaza canlı moddayken gelen bir test ödemesi, siparişi para alınmadığını belirten bir notla beklemede durumuna alır. Gerçek ödemeler, test moduna geri dönülse bile her zaman tanınır ve canlı anahtarla iade edilir.

Sipariş ödemeden sonra beklemede durumunda: VibeFox PayMongo Payment Gateway sekmesindeki notları okuyun (bkz. Sipariş durumları), ardından siparişi işleyin veya ödemeyi iade edin.

Sekmede iade formu yok: ödeme henüz onaylanmadı, tamamen iade edildi ya da kullanıcı grubunuzun eklentiyi değiştirme yetkisi yok.

İade, mod ile ilgili bir mesajla başarısız oluyor: ödeme test ya da canlı modda yapıldı ve o modun gizli anahtarı ayarlanmamış. Anahtarı girin ve yeniden deneyin.

Geliştiriciler için: Ödeme oturumu oluşturulmadan önce eklenti, oturum verileri ve siparişle birlikte OpenCart olayı paymongo_p_checkout_session_data'yı tetikler.

Kaldırma

Extensions > Extensions bölümüne gidin, türü Payments olarak seçin ve VibeFox PayMongo Payment Gateway yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, eklentinin 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ılanlarına döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te olayları ve bakım modunda webhook ile müşterinin dönüşüne izin veren başlangıç eylemi). Delete data on uninstall açıksa, diğer ağ geçidi ayarları (başlık, açıklama, ödeme yöntemleri, test modu, anahtarlar, webhook gizli anahtarları, günlükleme) ve günlük silinir. Kapalıysa, sonraki bir yeniden kurulum için korunurlar. Siparişlerin ve iadelerin PayMongo kimlikleri her zaman korunur; bu nedenle önceden ödenmiş siparişler, yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.

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

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