VibeFox Paymob for WooCommerce — Yardım

Gereksinimler

WordPress: 6.2 veya üzeri.

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

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ı, çevrim içi kart veya cüzdan entegrasyonunun entegrasyon kimliği, ödeme sayfasının iFrame kimliği ve HMAC gizli anahtarı.

Para birimi: mağaza para birimi, Paymob ülkenizin para birimi olmalıdır: Mısır için EGP, Birleşik Arap Emirlikleri için AED, Suudi Arabistan için SAR, Umman için OMR, Pakistan için PKR. Başka bir para birimiyle ödeme yöntemi ödeme sayfasında gizlenir.

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_paymob_pay 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 > Paymob > 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. Paymob country seçin ve API anahtarını, entegrasyon kimliğini, iFrame kimliğini ve HMAC gizli anahtarını girin (bkz. Yapılandırma).

6. Paymob panelinde, entegrasyonunuzun callback URL'lerini ayarlar sayfasında gösterilen URL olarak ayarlayın (bkz. Callbacks).

7. Enable/Disable seçeneğini açın. Bir Paymob test entegrasyonunun kimliğiyle bir ödeme deneyin, ardından canlı entegrasyonunuzun kimliğini girin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Paymob. Alanların üstünde sayfa, dört Paymob değerinden biri eksik olduğunda (o zamana kadar Paymob ödeme sayfasında gösterilmez) ve mağaza para birimi seçilen Paymob ülkesi tarafından kabul edilmediğinde sizi uyarır. Bir kutu, Copy düğmesiyle birlikte callback URL'sini ve seçilen ülkenin Paymob paneline bir bağlantıyı gösterir.

Genel

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ı. Varsayılan: Paymob.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely by card or mobile wallet on the Paymob payment page.

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 belirler; mağaza para birimi bu ülkenin para birimi olmalıdır. Varsayılan: Egypt.

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

Integration ID: Paymob panelinde, Developers > Payment Integrations altında: çevrim içi kart veya cüzdan 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. Zorunludur: siparişler yalnızca bu gizli anahtarla imzalanmış callback'lerle ödenmiş olarak işaretlenir.

Integration ID ve iFrame ID yalnızca rakam içermelidir. Boşluklar kaldırılır. Başka her değer, kaydederken must contain digits only — the previous value was kept alanının bu mesajıyla reddedilir.

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ı ayarlar sayfasında gösterilen URL olarak ayarlayın. URL şuna benzer: https://your-site/wc-api/paymob_pay/. Copy düğmesiyle kopyalayın. URL'leri test entegrasyonu dahil kullandığınız her entegrasyonda ayarlayın.

İşlem işlendi callback'i Paymob sunucusu tarafından gönderilir. İşlem yanıtı callback'i müşteriyi mağazanıza geri getirir. İkisi de HMAC gizli anahtarınızla imzalanır ve eklenti tarafından kontrol edilir. Geçerli imzası olmayan callback'ler reddedilir ve hiçbir şeyi değiştirmez. Sunucu callback'i gecikirse veya kaybolursa, imzalı müşteri dönüşü de ödemeyi onaylar.

Gelişmiş

Debug log: Log payment steps and callbacks, ödeme adımlarını ve callback'leri WooCommerce > Status > Logs bölümüne, kaynak wcp_paymob_pay olacak şekilde yazar. Hatalar ve reddedilen callback'ler her zaman kaydedilir. Anahtarlar, belirteçler ve müşteri verileri hiçbir zaman yazılmaz. Varsayılan: kapalı.

Clean uninstall: Delete the plugin settings and logs when the plugin is deleted. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Siparişlerde kayıtlı Paymob kimlikleri korunur. Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak Paymob) ve siparişi verir. Eklenti, sipariş para biriminde sipariş toplamı için yeni bir Paymob siparişi oluşturur, müşterinin adını, e-posta adresini, telefon numarasını ve fatura adresini Paymob'a iletir ve müşteriyi ülkenizin Paymob ödeme sayfasına gönderir. Orada müşteri, entegrasyonunuzdaki yöntemlerden biriyle, örneğin kartla veya mobil cüzdanla öder.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş, Paymob imzalı bir işlemle onaylamadan ödenmiş olarak işaretlenmez. Ödenmiş, bekleyen veya yetkilendirilmiş bir ödeme müşteriyi sipariş alındı sayfasına götürür.

Ödeme reddedildiyse müşteri, Your Paymob payment was not completed. Please try again or choose another payment method. mesajıyla ödeme sayfasına (ödeme orada başlatıldıysa Pay for order sayfasına) döner. Her yeni deneme kendi Paymob siparişini oluşturur, bu nedenle müşteri aynı siparişi yeniden deneyebilir. Paymob'dan gelen dönüş 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.

Paymob ödemeyi başlatamazsa müşteri kısa bir mesaj görür ve başka bir ödeme yöntemi seçebilir; ö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.

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

Eklenti, Paymob sayfasında tek seferlik ödemeleri kabul eder. Kayıtlı kart, abonelik, sitenizde gömülü kart formu veya WooCommerce'ten iade yoktur.

Siparişler

Sipariş durumları

Pending payment: müşteri Paymob'a yönlendirildi ve henüz ödeme yapmadı ya da Paymob ödemeyi henüz onaylamadı.

Processing: Paymob ödemeyi onayladı. Yalnızca sanal, indirilebilir ürün içeren siparişler, WooCommerce varsayılanı olan Tamamlandı durumuna geçer. Sipariş notunda Paymob işlemi, tutar ve kartın türü ile son dört hanesi gösterilir. İşlem kimliği, Paymob işlem kimliğidir.

On hold: ödeme Paymob'da beklemededir, örneğin nakit veya kiosk ödemesi; ya da Paymob tutarı yalnızca yetkilendirmiş ve tahsil etmemiştir (Paymob panelinde tahsil edin; tahsilat callback'i geldiğinde sipariş tamamlanır); ya da ödenen tutar veya para birimi siparişten farklıdır; ya da iptal edilmiş bir sipariş için ödeme gelmiştir. Nedeni sipariş notu açıklar.

Failed: Paymob, bekleyen bir siparişin ödemesini reddetti. Müşteri yeniden ödeme yapabilir.

Zaten ödenmiş bir sipariş için ikinci bir başarılı ödeme gelirse sipariş değişmez. Bir not, kopyayı Paymob panelinden iade etmenizi ister. Daha önce ödenmiş iptal edilmiş bir sipariş veya iade edilmiş bir sipariş için gelen ödeme yalnızca bir not ekler: sipariş yeniden açılmaz.

İadeler

WooCommerce'ten yapılan iadeler desteklenmez. Ödemeyi Paymob panelinde iade edin veya iptal edin. Paymob bir iade veya iptal bildirdiğinde siparişe bir not eklenir ve sipariş durumu değişmez. Siparişi manuel olarak güncelleyin, örneğin WooCommerce'te manuel iade oluşturarak.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Paymob 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 Paymob, 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.

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

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 key, Integration ID, iFrame ID, HMAC secret) girildiğini ve mağaza para biriminin seçilen Paymob country para birimi olduğunu kontrol edin. Ayarlar sayfası eksik bir şey olduğunda uyarı gösterir. Çok para birimli bir Paymob hesabı olan geliştiriciler, kabul edilen para birimlerini paymob_p_supported_currencies filtresiyle genişletebilir.

Ödeme başarılı oldu ama sipariş Pending payment durumunda kalıyor: callback'ler mağazanıza ulaşmıyor. Kullandığınız entegrasyonun Transaction processed callback ve Transaction response callback alanlarının ayarlar sayfasındaki URL ile tam olarak aynı olduğunu ve HMAC secret değerinin aynı Paymob hesabına ait olduğunu kontrol edin. Reddedilen callback'ler, hata ayıklama günlüğü kapalı olsa bile WooCommerce > Status > Logs bölümünde, kaynak wcp_paymob_pay olarak uyarı şeklinde kaydedilir.

Callback 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.

Callback Not configured yanıtı veriyor: HMAC gizli anahtarı boş. Gizli anahtarı girin; Paymob callback'i yeniden dener.

Callback locked yanıtı veriyor: sipariş aynı anda başka bir istek tarafından güncelleniyordu, örneğin müşterinin dönüşü. Paymob callback'i yeniden dener.

Müşteri sipariş verirken bir hata görüyor: Debug log seçeneğini açın ve günlüğü inceleyin. 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 veya eksik fatura bilgileri nedeniyle. This order cannot be paid with Paymob, sipariş toplamının sıfır olduğu anlamına gelir.

Sipariş ödemeden sonra On hold durumunda: sipariş notunu okuyun. Ödeme beklemededir (nakit veya kiosk), işlem yalnızca yetkilendirilmiştir (Paymob panelinde tahsil edin), tutar veya para birimi eşleşmemiştir ya da ödeme, sipariş iptal edildikten sonra gelmiştir. Nedeni sipariş notu açıklar.

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

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ı ve günlükler yalnızca Clean 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 Paymob kimliklerini korur.

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