VibeFox PayMongo for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin. Eklenti, WooCommerce olmadan etkinleştirilemez.

PHP: 8.0 veya üzeri.

Para birimi: Filipin pezosu (PHP). Mağaza para birimi veya Pay for order sayfasındaki sipariş para birimi PHP değilse ödeme yöntemi gizlenir.

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 anahtarlar gerekli değildir. Sunduğunuz ödeme yöntemleri PayMongo hesabınızda etkinleştirilmiş olmalıdır.

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

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_paymongo_payment_gateway klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Payments > PayMongo > Manage veya Plugins 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. PayMongo gizli API anahtarlarınızı yapıştırın, webhook'ları oluşturun ve imza gizli anahtarlarını yapıştırın (bkz. Yapılandırma).

6. Ödeme yöntemlerini seçin, Enable/Disable seçeneğini açın ve kaydedin. Test mode açıkken bir ödeme deneyin, ardından bu seçeneği kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > PayMongo. Alanların üstünde sayfa; mağaza 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 geri 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. Ödeme yöntemleri listesinde, geçerli modda gizli anahtar oluşana kadar PayMongo kurulum gerektiren olarak işaretlenir.

Genel

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yönteminin adı. Varsayılan: PayMongo (Card, GCash, GrabPay, Maya).

Description: ödeme sayfasında ödeme yönteminin altında gösterilen 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ızda etkinleştirilmiş yöntemleri seçin; aksi halde PayMongo ödemeyi reddeder. Varsayılan: Cards, GCash, GrabPay and Maya.

API anahtarları

Gizli anahtarları PayMongo Dashboard > Developers > API keys bölümünden kopyalayın. Genel anahtarlar gerekli değildir. Her anahtar beklenen önekle başlamalıdır. Yanlış önekli bir değer kaydedilmez: sayfa, must start with alanını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; bu nedenle durum kontrolleri ve iadeler eşleşen anahtarı kullanır. Varsayılan: açık. Gerçek ödemeleri kabul etmek için kapatın.

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.

Webhook

Webhook, ödeme yapıldığını mağazanıza bildirir; müşteri ödemeden sonra tarayıcıyı kapatsa bile. Test ve canlı her mod için PayMongo Panosu'nda (veya PayMongo API'si üzerinden) bu ayarlar bölümünde gösterilen URL ile bir webhook oluşturun. URL şuna benzer: https://your-site/?wc-api=paymongo_p_webhook.

Bu olayları seçin:

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 ve olayın modu imzanın moduyla eşleşmelidir. Sipariş değiştirilmeden önce her olay PayMongo API'si üzerinden yeniden kontrol edilir. PayMongo, tüm hesabın olaylarını her webhook'a gönderir; bu mağaza tarafından oluşturulmamış ödemelerin olayları yok sayılır. Webhook olmadan ödemeler yalnızca müşteri mağazanıza döndüğünde onaylanır.

Siparişler

Ödemeden sonra sipariş durumu: başarılı bir ödemeden sonra ayarlanan sipariş durumu. Durum hemen ayarlanır, ikinci bir durum değişikliği olmadan.

Gelişmiş

Debug log: Log API calls and webhook events bunları WooCommerce > Status > Logs bölümüne, kaynak wcp_paymongo_payment_gateway olarak yazar. Hatalar her zaman kaydedilir. Anahtarlar ve müşteri verileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

Delete data on uninstall: Delete the settings and logs when the plugin is deleted. Siparişlerde saklanan PayMongo kimlikleri, iadeler ve muhasebe için gerekli olduğundan korunur. Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak PayMongo (Card, GCash, GrabPay, Maya)) ve siparişi verir. Test modunda ödeme sayfası Test mode: no real payment will be made. gösterir. Eklenti, sipariş toplamı için PHP cinsinden bir PayMongo ödeme oturumu oluşturur; bir satırda Order # ve sipariş numarası bulunur 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çili yöntemlerden birini seçer ve öder.

Ödeme yöntemi yalnızca en az ₱100,00 tutarındaki siparişler için gösterilir. Bundan düşük bir toplam PayMongo ile ödenemez.

Ödemeden sonra müşteri, mağazanızın sipariş alındı sayfasına döner. Sipariş, yalnızca PayMongo ödemeyi onayladığında ödenmiş olarak işaretlenir: eklenti, müşteri döndüğünde ve webhook geldiğinde ödemeyi PayMongo API'sine sorar. PayMongo ödemeyi hâlâ işliyorsa veya ulaşılamıyorsa, müşteri yine de sipariş alındı sayfasına gelir ve siparişi sonra webhook tamamlar.

Müşteri PayMongo sayfasında iptal ederse veya ödemeyi tamamlamazsa, Pay for order sayfasına şu mesajla gelir: 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. Sipariş ödenmemiş kalır. Yeni bir deneme önce öncekini kontrol eder: bu arada ödenmişse, sipariş yeni bir ödeme olmadan tamamlanır; değilse, önceki PayMongo ödeme bağlantısının süresi dolar, böylece müşteri iki kez ödeme yapamaz. Önceki ödeme hâlâ işleniyorsa 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.

PayMongo ödemeyi başlatamazsa müşteri kısa bir mesaj görü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 sipariş notlarına eklenir.

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

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 ile tahsilat yoktur.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri PayMongo'ya yönlendirildi ve henüz ödeme yapmadı ya da PayMongo ödemeyi henüz onaylamadı. Bir not, sipariş için oluşturulan her PayMongo ödeme oturumunu kaydeder. PayMongo bir ödemeyi işlerken bir not bunu belirtir.

Processing veya Completed: ödeme onaylandı. Durum, Order status after payment ayarını izler. Sipariş notunda PayMongo ödemesi, tutar, yöntem ve mod gösterilir. İşlem kimliği PayMongo ödeme kimliğidir (pay_...). Sipariş ekranında, fatura adresinin altında PayMongo ödeme oturumu, ödeme niyeti ve modu gösterilir.

On hold: ödenen tutar veya para birimi siparişle eşleşmiyor (amount/currency mismatch notu); ya da mağaza canlıyken bir ödeme test modunda yapıldı, bu nedenle hiçbir para alınmadı; ya da ödeme, sipariş iptal edildikten sonra geldi (örneğin stok ayırma süresinin dolması nedeniyle). Sipariş notu nedenini açıklar. Siparişi kontrol edin ve işleyin ya da ödemeyi iade edin.

Failed: imzalı bir payment.failed webhook'u, beklemedeki bir siparişin son ödeme denemesinin başarısız olduğunu bildirdi. Not, PayMongo hata kodunu ve mesajını gösterir. Müşteri yeniden ödeme yapabilir.

Zaten ödenmiş bir sipariş için, örneğin eski bir ödeme bağlantısı üzerinden ikinci bir ödeme gelirse, sipariş değişmez. Bir not, PayMongo Panosu'nda yinelenen ödemeyi iade etmenizi ister. Daha önce ödenmiş iptal edilmiş veya iade edilmiş bir sipariş asla yeniden açılmaz.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via PayMongo (Card, GCash, GrabPay, Maya) düğmesine tıklayın (düğmede ödeme yönteminizin başlığı görünür). Tam ve kısmi iadeler desteklenir. İade, ödemenin yapıldığı modun (test veya canlı) gizli anahtarıyla gönderilir; bu nedenle o anahtar ayarlanmış olmalıdır. PayMongo iadeyi kabul etmezse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, PayMongo iade kimliği ve durumuyla birlikte sipariş notlarına eklenir.

PayMongo Panosu'nda yapılan iadeler WooCommerce'e kopyalanmaz. WooCommerce siparişinden iade yapın veya WooCommerce'te manuel bir iade oluşturun.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > PayMongo sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blokta durum gösterilir; örneğin lisansın hangi tarihe kadar etkin olduğu 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 düğmesini kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar tek bir alan adında çalışır. Anahtarı bir siteden kaldırmak, o alan adının yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan PayMongo, 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. Oturum açmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler 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 ve iadeler çalışır.

Bir lisansın 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

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), mağaza para biriminin PHP olduğunu ve sipariş toplamının en az ₱100,00 olduğunu kontrol edin. Geliştiriciler minimum tutarı paymongo_p_minimum_amount filtresiyle değiştirebilir.

Ödeme başarılı oldu ama sipariş Pending payment durumunda kalıyor: webhook çalışmıyor ve müşteri mağazaya geri dönmedi. PayMongo Panosu'nda kullandığınız modda bir webhook olduğunu, URL'sinin ayarlarda gösterilenle birebir aynı olduğunu ve üç olayın da seçili olduğunu kontrol edin. İmza gizli anahtarının ilgili alanda (Test webhook secret veya Live webhook secret) olduğunu doğrulayın.

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

Webhook Mode mismatch yanıtı veriyor: bir test olayı canlı olarak veya 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 veya sipariş aynı anda başka bir istek tarafından işleniyordu. PayMongo webhook'u otomatik olarak yeniden dener.

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 sipariş verirken bir hata görüyor: sipariş notlarını açın veya WooCommerce > Status > Logs bölümüne bakın, kaynak wcp_paymongo_payment_gateway. Yanlış bir gizli anahtar, ödeme yönteminin geçici olarak kullanılamadığı mesajına yol açar. PayMongo hesabınızda etkinleştirilmemiş bir ödeme yöntemi, PayMongo'nun ödemeyi reddetmesine neden olur; bunu Payment methods listesinden kaldırın.

Canlı bir mağazada test ödemeleri: mağaza canlı moddayken gelen bir test ödemesi, siparişi hiçbir paranın alınmadığını belirten bir notla beklemeye alır. Gerçek ödemeler, test moduna geçildikten sonra bile her zaman tanınır ve canlı anahtarla iade edilir.

Ödeme sonrası sipariş On hold durumunda: sipariş notunu okuyun. Ödenen tutar veya para birimi siparişle eşleşmiyordu, ödeme bir test ödemesiydi veya sipariş iptal edildikten sonra geldi. Siparişi işleyin veya ödemeyi iade edin.

İade mod hakkında bir mesajla başarısız oluyor: ödeme test veya canlı modda yapıldı ve o modun gizli anahtarı ayarlanmamış. Anahtarı girin ve yeniden deneyin.

Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa, vibefox.net hesabınızda bir yuva 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şılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları, geçici veriler ve günlükler yalnızca Delete data on uninstall açıksa kaldırılır. Aksi halde, sonraki yeniden kurulum için kalırlar. Mevcut siparişler ödeme notlarını, işlem kimliklerini ve PayMongo kimliklerini korur.

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