Geri

VibeFox Paymob for OpenCart — Yardım

Gereksinimler

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

PHP: 8.0 veya üzeri.

Paymob hesabı: desteklenen ülkelerden birinde bir satıcı hesabı: Mısır, Birleşik Arap Emirlikleri, Suudi Arabistan, Umman veya Pakistan. Paymob panelinden dört değere ihtiyacınız vardır: API anahtarı, çevrimiçi ödeme entegrasyonunun entegrasyon kimliği, ödeme sayfasının iFrame kimliği ve HMAC gizli anahtarı.

Para birimi: ödeme sayfasının para birimi, Paymob ülkenizin para birimi olmalıdır: Mısır için EGP, BAE için AED, Suudi Arabistan için SAR, Umman için OMR, Pakistan için PKR. Mağazanızda yoksa System > Localisation > Currencies bölümünden ekleyin. Farklı bir para biriminde ödeme yöntemi ödeme sayfasında gizlenir. Çoklu para birimli Paymob hesapları desteklenmez.

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

Kurulum

Dosya, 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_paymob_pay-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_paymob_pay.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze ait 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_paymob_pay-oc3-(version).ocmod.zip dosyasını seçin. Uzantının OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications bölümünü yenilemeniz gerekmez. Kurulum aracı yerine, bu paketin upload klasöründeki içeriği 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 Paymob Pay satırını bulun ve Install düğmesine (yeşil +) 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 kısmındaki lisans bloğunda License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Paymob country seçeneğini belirleyin ve API anahtarını, entegrasyon kimliğini, iFrame kimliğini ve HMAC gizli anahtarını girin (bkz. Yapılandırma).

5. Paymob panelinde, entegrasyonunuzun geri çağrı URL'lerini Callbacks bölümünde gösterilen URL olarak ayarlayın (bkz. Callbacks).

6. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Bir Paymob test entegrasyonunun kimliğiyle bir ödeme deneyin, ardından canlı entegrasyonunuzun kimliğini girin.

OpenCart 4

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_paymob_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ı sayfada kurulu eklentilerin listesinde görünür. Yanındaki Install düğmesine (yeşil +) tıklayın.

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

4. Lisans anahtarını, Paymob anahtarlarını ve kimliklerini ile geri çağrı URL'lerini OpenCart 3 için 3 ila 6. adımlardaki gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca geri çağrı URL'si farklıdır (bkz. Callbacks).

Yeni bir kurulum, ödeme yöntemi kapalı olarak başlar.

Yapılandırma

Tüm ayarlar uzantının sayfasındadır: Extensions > Extensions > Payments > VibeFox Paymob Pay > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üzerinde sayfa, dört Paymob değerinden biri eksik olduğunda (o zamana kadar Paymob ödeme sayfasında gizlenir) ve mağazanın varsayılan para birimi seçilen Paymob ülkesi tarafından kabul edilmediğinde sizi uyarır.

Kaydederken Title 128 karakterden uzun olamaz, Sort Order tam sayı olmalıdır (negatif sayılara izin verilir), Total 0 veya daha büyük bir sayı olmalıdır ve seçilen geo zone ile sipariş durumları mevcut olmalıdır. Aksi halde hiçbir şey kaydedilmez ve sayfa alanı belirtir.

Paymob

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yönteminin adı. Siparişte kaydedilen ödeme yöntemi adı da budur; en fazla 128 karakter. Boşsa müşteriler Paymob görür. Varsayılan: Paymob.

Description: Confirm Order adımında onay düğmesinin üzerinde müşteriye gösterilen metin. Varsayılan: Pay securely by card or mobile wallet on the Paymob payment page. Hiçbir metin göstermemek için boş bırakın.

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

Geo Zone: Paymob'u yalnızca seçilen geo zone içindeki ödeme adresleri için sunar. Varsayılan: All zones. Geo zone'lar System > Localisation > Geo Zones bölümünde ayarlanır. OpenCart 4'te mağaza ödeme adresi istemediğinde teslimat adresi kullanılır.

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

Paymob hesabı

Tüm değerler Paymob satıcı panelinizdedir. Ayrı bir test modu yoktur: test ödemeleri için test modundaki bir entegrasyonun entegrasyon kimliğini girin. Başka hiçbir ayar değişmez.

Paymob country: Paymob hesabınızın ülkesi. API ve ödeme sayfası sunucusunu seçer; ödeme sayfasının para birimi bu ülkenin para birimi olmalıdır. Varsayılan: Egypt.

Egypt — accept.paymob.com (EGP)
United Arab Emirates — uae.paymob.com (AED)
Saudi Arabia — ksa.paymob.com (SAR)
Oman — oman.paymob.com (OMR)
Pakistan — pakistan.paymob.com (PKR)

API key: Paymob panelinde Settings > Account info > API Key altında.

Integration ID: Paymob panelinde Developers > Payment Integrations altında: kart veya cüzdan çevrimiçi entegrasyonunun sayısal kimliği. Paymob sayfasında sunulan ödeme yöntemleri bu entegrasyonunkilerdir.

iFrame ID: Paymob panelinde Developers > iframes altında: ödeme iFrame'inin sayısal kimliği.

HMAC secret: Paymob panelinde Settings > Account info > HMAC altında. Zorunlu: siparişler yalnızca bu gizli anahtarla imzalanmış geri çağrılarla ödenmiş olarak işaretlenir.

Integration ID ve iFrame ID yalnızca rakam içermelidir. Boşluklar kaldırılır. Başka herhangi bir değer kaydedilirken, alanın must contain digits only — the previous value was kept olması gerektiğini bildiren mesajla reddedilir. Diğer alanlar kaydedilir.

Kayıtlı API anahtarı ve HMAC gizli anahtarı bir daha asla gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. ifadesini 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 API key on save veya Clear the saved HMAC secret on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Callbacks

Paymob, her işlemi mağazanıza bildirir. Paymob panelinde Developers > Payment Integrations bölümünü açın, entegrasyonunuzu seçin, Edit düğmesine tıklayın ve hem Transaction processed callback hem de Transaction response callback alanlarını bu bölümde gösterilen Callback URL adresine ayarlayın. OpenCart 3'te şuna benzer: https://your-store/index.php?route=extension/payment/wcp_paymob_pay/callback, OpenCart 4'te: https://your-store/index.php?route=extension/wcp_paymob_pay/payment/wcp_paymob_pay.callback. OpenCart kurulumunuzun mağaza adresinden oluşturulur. Copy düğmesiyle kopyalayın. Bölüm, seçilen ülkenin Paymob paneline de bağlantı verir. URL'leri, test entegrasyonu dahil, kullandığınız her entegrasyonda ayarlayın.

Transaction processed callback, Paymob sunucusu tarafından gönderilir. Transaction response callback, müşteriyi mağazanıza geri getirir. İkisi de HMAC gizli anahtarınızla imzalanır ve uzantı tarafından kontrol edilir. Geçerli imzası olmayan geri çağrılar reddedilir ve hiçbir şeyi değiştirmez. Sunucu geri çağrısı gecikirse ya da kaybolursa, imzalı müşteri dönüşü de ödemeyi onaylar. Geri çağrı URL'si mağaza bakım modundayken de çalışır: OpenCart 3 ödeme uzantılarının isteklerini geçirir, OpenCart 4'te ise uzantı, geri çağrıları ve müşteri dönüşünü geçiren bir başlangıç eylemi (startup) ekler.

Siparişler

OpenCart siparişi Confirm Order adımında durum olmadan oluşturur (eksik sipariş). Yalnızca Paymob doğru imzalı bir işlem bildirdikten sonra bir durum alır. Reddedilen bir ödeme siparişi durumsuz bırakır; müşteri sepeti korunmuş olarak ödeme sayfasına döner. Aşağıdaki her alan, OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: Paymob işlemi beklenen tutar ve para birimiyle ödenmiştir. Varsayılan: İşleniyor.

Awaiting Paymob Payment Status: işlem beklemededir, örneğin nakit veya kiosk ödemesi. Paymob onayladığında sipariş ödeme sonrası durumunu alır. Varsayılan: Beklemede.

Paymob Payment On Hold Status: Paymob yalnızca tutarı yetkilendirmiştir (Paymob panelinde tahsil edin), ödenen tutar veya para birimi siparişle eşleşmiyor ya da ödeme iptal edilmiş bir sipariş için gelmiştir. Bir not nedenini açıklar. 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.

Sonraki üç alan, uzantıya mağazanızın hangi durumları kullandığını söyler. Uzantı bunları asla ayarlamaz.

Payment Error Status: mağazanızın ödeme hatası olan siparişler için kullandığı durum. Beklemedeki bir işlem böyle bir siparişi bekleme durumuna taşıyabilir. Varsayılan: Başarısız.

Cancelled Order Status: mağazanızın iptal edilmiş siparişler için kullandığı durum. Böyle bir sipariş için alınan bir ödeme siparişi beklemeye alır veya siparişin daha önce ödenmiş olması durumunda yalnızca bir not ekler. Varsayılan: İptal Edildi.

Refunded Order Status: mağazanızın iade edilmiş siparişler için kullandığı durum. Böyle bir sipariş için alınan bir ödeme yalnızca bir not ekler. Varsayılan: İade Edildi.

Gelişmiş

Debug log: ödeme adımlarını ve geri çağrıları OpenCart günlük klasöründe (storage/logs) paymob_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar ve reddedilen geri çağrılar, kapalı olsa bile her zaman kaydedilir. Anahtarlar, jetonlar ve müşteri verileri asla yazılmaz. Varsayılan: kapalı.

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

Clean uninstall: açıksa uzantı kaldırıldığında ağ geçidi ayarları ve günlük silinir. Siparişler için kaydedilmiş Paymob kimlikleri (ödeme denemeleri) her zaman korunur. Varsayılan: kapalı.

İçe / Dışa aktarma

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. API anahtarı ve HMAC gizli anahtarı 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 sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Paymob). Confirm Order adımında müşteri açıklamanızı ve You will be redirected to the secure Paymob payment page to pay by card or mobile wallet. notunu görür. OpenCart siparişi bu adımda, henüz durum olmadan oluşturur. OpenCart 4'te müşteri ödeme yöntemini, Payment method options penceresindeki yöntem bloğunda bulunan Choose düğmesiyle seçer ve sayfanın altındaki Confirm Order düğmesine tıklar. Müşteri Confirm Order düğmesine tıkladığında uzantı, sipariş tutarı için sipariş para biriminde yeni bir Paymob siparişi kaydeder, müşterinin adını, e-postasını, telefonunu ve fatura adresini Paymob'a iletir (OpenCart 4'te mağaza ödeme adresi istemediğinde teslimat adresi) ve müşteriyi ülkenizin Paymob ödeme sayfasına gönderir. Orada müşteri entegrasyonunuzdaki yöntemlerden biriyle öder; örneğin kartla veya mobil cüzdanla.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş, Paymob onu imzalı bir işlemle onaylayana kadar ödenmiş olarak işaretlenmez. Ardından sipariş, olağan sipariş e-postaları ve stok güncellemesiyle OpenCart'ın standart yöntemiyle bir durum alır ve müşteri OpenCart sipariş başarı sayfasını görür. Bekleyen bir ödeme (örneğin nakit veya kiosk) ya da yetkilendirilmiş bir ödeme de siparişe bir durum verir: bekleme ya da beklemede (on hold) durumu; ve başarı sayfasına yönlendirir.

Müşteri geri döndüğünde sipariş hâlâ onaylanıyorsa, bir Payment confirmation sayfası Paymob accepted your payment and we are confirming it. You will receive an e-mail as soon as your order is confirmed — there is no need to pay again. mesajını gösterir. Beklemedeki bir ödeme için metin şudur: Your Paymob payment is pending (for example a cash or kiosk payment). Complete it as Paymob instructed you: your order is confirmed as soon as Paymob reports the payment. Sayfada bir Check again ve bir Back to checkout düğmesi bulunur.

Ödeme reddedildiyse müşteri aynı sepetle ödeme sayfasına döner ve Your Paymob payment was not completed. Please try again or choose another payment method. mesajını görür. Her yeni deneme kendi Paymob siparişini kaydeder; bu nedenle müşteri sepeti yeniden ödeyebilir. OpenCart 3 Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ödeme için tek bir sipariş tutar ve onu günceller, böylece müşteri aynı siparişi yeni bir denemeyle öder. Paymob'un yanıtı doğrulanamazsa müşteri We could not verify the response from Paymob. If you were charged, your order will be updated as soon as Paymob confirms the payment. mesajını görür. Aynı sepetin başka bir siparişi zaten ödenmişse ya da ödeme bekliyorsa (örneğin ikinci bir tarayıcı sekmesinde), müşteri yeniden ödeme yapmak yerine başarı sayfasına yönlendirilir. OpenCart 4'te Paymob'dan dönüşten sonraki mesajlar ödeme sayfasının üstünde gösterilir.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme sayfasında tutar. Bu sipariş bu arada ödeme yapılmadan kapatıldıysa (örneğin siz iptal ettiyseniz), müşteri Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. mesajıyla ödeme sayfasına geri gönderilir ve bir sonraki Confirm Order yeni bir siparişi öder. Bu siparişin zaten bir durumu varsa ve sepette artık başka ürünler ya da miktarlar varsa, müşteri yine ödeme sayfasına geri gönderilir ve yeni sepet yeni bir sipariş alır.

Paymob ödemeyi başlatamazsa müşteri Confirm Order adımında kalır ve düğmenin üzerinde kısa bir mesaj görür, örneğin Paymob could not start the payment. Please check your billing details and try again, or choose another payment method. veya Could not connect to Paymob. Please try again in a moment. Teknik neden günlüğe yazılır.

Uzantı, Paymob sayfasında yalnızca tek seferlik ödemeleri kabul eder. Kayıtlı kart, abonelik, sitenize gömülü kart formu ve yönetim panelinden iade desteklenmez.

Siparişler

Sipariş durumları

No status (missing order): müşteri Paymob'a yönlendirildi ve ödeme yapmadı, ödeme reddedildi ya da Paymob henüz ödemeyi onaylamadı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında görünür.

OpenCart 4'te ödenmemiş bir ödeme sayfası siparişi Voided durumunu alabilir; bu durum, müşteri Confirm Order adımına döndüğünde OpenCart 4 tarafından ayarlanır. Uzantı böyle bir siparişi durumsuz sipariş olarak değerlendirir ve sonraki bir ödeme yine de onu onaylar.

Order Status After Payment (default Processing): Paymob ödemeyi onayladı. Bir not işlemi, tutarı ve kart türünü son dört hanesiyle gösterir.

Awaiting Paymob Payment Status (default Pending): ödeme Paymob'da beklemededir, örneğin nakit veya kiosk ödemesi. Paymob ödemeyi onayladığında sipariş ödeme sonrası durumuna geçer.

Paymob Payment On Hold Status (default Pending): Paymob yalnızca tutarı yetkilendirmiştir ve tahsil etmemiştir (Paymob panelinde tahsil edin; tahsilat geri çağrısı geldiğinde sipariş ödeme sonrası durumuna geçer); ya da ödenen tutar veya para birimi siparişle eşleşmiyordur; ya da iptal edilmiş bir sipariş için ödeme gelmiştir. Not nedenini açıklar. Siparişi kontrol edin, ardından siparişi yerine getirin veya Paymob panelinde ödemeyi iade edin.

Zaten bir durumu olan bir sipariş değiştiğinde OpenCart müşteriyi bilgilendirir. Zaten ödenmiş bir sipariş için ikinci bir başarılı ödeme gelirse ya da zaten ödenmiş bir sepetin ikinci siparişi için ödeme gelirse, ödenmiş sipariş değişmez ve bir not kopyayı Paymob panelinde iade etmenizi ister. Daha önce ödenmiş bir iptal edilmiş siparişe ya da bir iade edilmiş siparişe yapılan ödeme yalnızca bir not ekler: sipariş yeniden açılmaz. Zaten bir durumu olan bir sipariş için reddedilen ödeme yalnızca bir not ekler.

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

VibeFox Paymob Pay sekmesi

Sales > Orders bölümünde Paymob ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanındaki VibeFox Paymob Pay sekmesi, siparişin her Paymob denemesini gösterir: merchant sipariş kimliği ve ülkeyle Paymob order, Paymob transaction ID, Status, Requested tutarı, kartla birlikte Amount reported by Paymob ve Paymob message. Altında, bu sipariş için uzantının Notes kayıtları bulunur. Sekme, uzantıya erişimi olan kullanıcılara gösterilir.

İadeler

Yönetim panelinden iadeler desteklenmez. Ödemeyi Paymob panelinde iade edin veya iptal edin. Paymob bir iade ya da iptal bildirdiğinde siparişe bir not eklenir ve sipariş durumu değişmez. Siparişi elle güncelleyin.

Lisans anahtarı

Uzantı, vibefox.net üzerinden alınmış bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Paymob Pay lisans bloğu, Extensions > Extensions > Payments > VibeFox Paymob Pay > Edit sayfasındaki ilk bloktur ve ayarların üzerindedir. 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 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 düğmelerini gösterir. Bunların altında Product: opencart-payment-paymob satırı ve 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 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ı serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa uzantı son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir lisans anahtarı olmadan Paymob ödeme sayfası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 yine 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, dolayısıyla etkin anahtar olmadan ödeme yöntemi herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard ekranında bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder.

Bir lisans sona erdiğinde uzantı çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici Dashboard 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. Uzantıyı kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Paymob ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, dört değerin (API anahtarı, entegrasyon kimliği, iFrame kimliği, HMAC gizli anahtarı) hepsinin doldurulduğunu ve ödeme sayfası para biriminin seçilen Paymob country ülkesinin para birimi olduğunu kontrol edin. Ayarlar sayfası eksik bir şey olduğunda uyarı gösterir. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda tanımlı Total değerine ulaştığını kontrol edin.

Ödeme gerçekleşti ama sipariş durumsuz kaldı: geri çağrılar mağazanıza ulaşmıyor. Kullandığınız entegrasyonun Transaction processed callback ve Transaction response callback alanlarının Callbacks bölümünde gösterilen URL ile tam olarak aynı olduğunu ve HMAC secret değerinin aynı Paymob hesabına ait olduğunu kontrol edin. Reddedilen geri çağrılar, Debug log kapalı olsa bile uyarı olarak günlüğe yazılır. Uzantı sayfasındaki Log alanına bakın.

Geri çağrı Invalid signature yanıtı veriyor: ayarlardaki HMAC gizli anahtarı Paymob hesabıyla eşleşmiyor ya da başka bir ülkenin hesabı seçili. HMAC gizli anahtarını yeniden kopyalayın.

Geri çağrı Not configured yanıtı veriyor: HMAC gizli anahtarı boş. Gizli anahtarı girin; Paymob geri çağrıyı yeniden dener.

Geri çağrı locked veya retry yanıtı veriyor: sipariş aynı anda başka bir istek tarafından güncelleniyordu, örneğin müşteri dönüşü, ya da sipariş durumu ayarlanamadı. Paymob geri çağrıyı yeniden dener. Neden günlüğe yazılır.

Geri çağrı URL'sini tarayıcıda açmak, doğrulanamadı mesajıyla ödeme sayfasına götürüyor: bu normaldir. URL yalnızca Paymob'dan gelen imzalı istekleri kabul eder.

Müşteri Confirm Order sonrası bir hata görüyor: Debug log seçeneğini açın ve günlüğe bakın. Paymob payments are temporarily unavailable yanlış bir API anahtarı ya da eksik bir değer anlamına gelir. Paymob could not start the payment Paymob'un isteği reddettiği anlamına gelir; örneğin yanlış bir entegrasyon kimliği ya da eksik fatura verileri nedeniyle. This order cannot be paid with Paymob sipariş toplamının sıfır olduğu anlamına gelir. Paymob does not accept payments in ve ardından gelen bir para birimi, sipariş para biriminin seçilen Paymob ülkesinin para birimi olmadığı anlamına gelir. This payment method is not available. ödeme oturumunun artık siparişle eşleşmediği ya da ödeme yönteminin bu arada kapatıldığı anlamına gelir: müşteri ödeme sayfasını yeniden yükler.

Sipariş ödeme sonrası beklemede ya da bekleme durumunda: VibeFox Paymob Pay sekmesindeki notları okuyun. Ödeme beklemede (nakit veya kiosk), işlem yalnızca yetkilendirildi (Paymob panelinde tahsil edin), tutar ya da para birimi eşleşmedi veya ödeme siparişin iptalinden sonra geldi.

Test ödemeleri: bir Paymob test entegrasyonunun kimliğini Integration ID alanına girin ve geri çağrı URL'lerini o entegrasyonda ayarlayın. Gerçek ödemeler için canlı entegrasyonunuzun kimliğini yeniden girin.

Kaldırma

Extensions > Extensions bölümüne gidin, türü Payments olarak seçin ve VibeFox Paymob Pay satırının yanındaki Uninstall düğmesine (kırmızı −) tıklayın. Lisans anahtarı ve lisans durumu bu uzantıya ait olduğundan 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. OpenCart 4'te uzantının OpenCart olayı ve bakım modunda geri çağrıları ve müşteri dönüşünü geçiren başlangıç eylemi de kaldırılır. Clean uninstall açıksa diğer ağ geçidi ayarları (başlık, açıklama, ülke, anahtarlar ve kimlikler, günlükleme) ve günlük silinir. Kapalıysa sonraki bir yeniden kurulum için saklanır. Siparişlerin Paymob ödeme denemeleri her zaman korunur. Mevcut siparişler ödeme notlarını ve Paymob kimliklerini 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, kurulu eklentiler listesinde VibeFox Paymob Pay yanındaki Uninstall düğmesine (turuncu −) ve ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu) tıklayın.

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