VibeFox DPO for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

PHP: SimpleXML uzantısı etkin 8.0 veya üzeri. Modül bunlar olmadan kurulmayı reddeder.

DPO Pay hesabı: DPO satıcı hesabınızın Company Token ve Service Type ID bilgilerine ihtiyacınız vardır. DPO bunları hesabınız açıldığında verir; DPO hesap yöneticinizden veya dpogroup.com üzerinden alın. DPO kendi token'ı ve service type'ı ile bir test hesabı da sağlayabilir. Ayrı bir test sunucusu yoktur: DPO test ve canlı hesaplar için aynı API adresini kullanır ve hesap token ile seçilir.

Para birimi: mağaza para birimi DPO hesabınız tarafından desteklenmelidir. DPO en fazla 2 ondalık basamağı kabul eder; bu nedenle 3 ondalıklı sepet toplamları (örneğin KWD 12.345) ödenemez.

Sunucu cron'u: modülün yeniden kontrol URL'sini her 15 dakikada bir çağıran bir cron işi (bkz. Configuration).

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

Kurulum

1. Yönetim panelinde Modules > Module Manager bölümüne gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme bittiğinde Configure düğmesine tıklayın veya VibeFox DPO Pay Gateway modülünü daha sonra modül listesinde bulup Configure düğmesine tıklayın.

3. VibeFox lisans anahtarınızı Configure sayfasını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. Test ve/veya canlı Company Token ve Service Type bilgilerini girin (bkz. Configuration).

5. Configure sayfasında gösterilen push bildirim URL'sini DPO desteğine gönderin ve hesabınız için ayarlamalarını isteyin. Cron URL'sini sunucunuzun cron işlerine ekleyin.

6. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Test modunda deneme siparişi verin, ardından gerçek ödemeleri kabul etmek için Test mode seçeneğini kapatın.

Kurulum sırasında modül DPO payment on hold sipariş durumunu oluşturur. PrestaShop tüm para birimleri, ülkeler ve müşteri grupları için yeni bir ödeme modülü sunar. Bunları Payment > Preferences bölümünden sınırlandırabilirsiniz.

Configuration

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox DPO Pay Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Modül etkin ama seçili modun Company Token veya Service Type alanı boşsa, sayfa ödeme yönteminin ödeme adımında gizlendiği konusunda sizi uyarır ve kaydetme sırasında aynı uyarı görünür. Test modu açıkken sayfa Test mode is on: payments are created with the test account credentials. ifadesini gösterir.

DPO Pay

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

Title: müşterilerin ödeme adımında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: DPO Pay. Zorunlu.

Description: ödeme adımında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely by card or mobile money on the DPO Pay payment page.

API kimlik bilgileri

DPO, satıcı hesabınız için bir Company Token ve Service Type ID verir; test hesabı için ayrı değerler verir. DPO hesap yöneticinizden veya dpogroup.com üzerinden alın.

Test mode: açıkken yeni ödemeler test Company Token ve Service Type ile oluşturulur. Varsayılan: açık. Gerçek ödemeleri canlı kimlik bilgileriyle kabul etmek için kapatın. Mevcut ödemelerin durum kontrolleri ve iptalleri her zaman ödemenin oluşturulduğu hesabı kullanır.

Test Company Token: DPO test hesabınızın Company Token'ı.

Test Service Type: DPO test hesabınızın sayısal Service Type ID'si.

Live Company Token: DPO canlı satıcı hesabınızın Company Token'ı.

Live Service Type: DPO canlı satıcı hesabınızın sayısal Service Type ID'si.

Kaydedilmiş Company Token'lar 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. Service Type bir sayı olmalıdır. Diğer değerler kaydedilmez: sayfa bir uyarı gösterir ve önceki değeri korur.

Clear saved Company Tokens: bir token'ı işaretleyin ve kaldırmak için Save düğmesine tıklayın. Boş bir alan kayıtlı değeri korur.

Ödeme bildirimleri

Push notification URL: push bildirimi, müşteri ödemeden sonra tarayıcıyı kapatsa bile bir ödemenin yapıldığını mağazanıza hemen bildirir. URL bir panelde ayarlanmaz: bu URL'yi hesabınız için ayarlamasını DPO desteğinden isteyin. Dostça URL'ler kullanıldığında şu biçimde görünür: https://your-shop/module/wcp_dpo_pay/notify, isteğe bağlı olarak bir dil koduyla birlikte. Sayfada gösterildiği gibi tam olarak kopyalayın. İnternetten erişilebilir olmalıdır; önünde bakım modu, güvenlik duvarı veya temel kimlik doğrulama olmamalıdır.

DPO push bildirimleri imzasız gelir, bu nedenle içerikleri asla güvenilir kabul edilmez. Modül bunları yalnızca ödemeyi işlem jetonuyla bulmak için kullanır, ardından sonucu DPO'nun kendisinden kontrol eder. Mağazanızın oluşturmadığı bir jeton, DPO'ya hiçbir istek yapılmadan reddedilir.

Scheduled status re-check (cron): bu URL'yi bir sunucu cron işinden her 15 dakikada bir çağırın, örneğin curl ile. Onaylanmamış ödemeler, yönlendirmeden 15 dakika sonra ve ödeme süresi sınırından sonra yeniden DPO'da kontrol edilir. URL gizli bir jeton içerir, bu yüzden gizli tutun. Push URL'si ve cron olmadan sipariş yalnızca müşteri ödemeden sonra mağazaya döndüğünde oluşturulur.

Siparişler

Successful payment status: doğrulanmış başarılı bir ödemeden sonraki sipariş durumu.

Tutar veya para birimi uyuşmazlıkları, yalnızca yetkilendirilmiş ödemeler ve fazla ya da az ödenmiş işlemler her zaman DPO payment on hold durumuna gider.

Gelişmiş

Logging: API çağrılarını ve bildirimleri modül klasöründeki logs/dpo_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar her zaman kaydedilir. Jetonlar maskelenir, müşteri verisi kaydedilmez. Varsayılan: kapalı.

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

Delete data: açıkken modülün kaldırılması modül ayarlarını ve günlüğü siler. Siparişler için saklanan DPO verileri ve DPO payment on hold sipariş durumu her zaman korunur. Bu seçenek olmadan kaldırma hiçbir veriyi silmez. Varsayılan: kapalı.

Ödeme adımı

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak DPO Pay) ve You will be redirected to the secure DPO Pay payment page. notunu görür. Onaylandıktan sonra modül, sepet para biriminde sepet toplamı için bir DPO işlemi oluşturur; açıklama olarak sepet numarasını ve mağaza adınızı kullanır ve müşteriyi DPO ödeme sayfasına gönderir. Müşterinin adı, e-postası, telefonu ve fatura adresi sayfayı önceden doldurmak için iletilir. Orada müşteri, DPO hesabınızda etkin olan herhangi bir yöntemle öder. Ödeme bağlantısı 5 saat geçerlidir. Bu noktada henüz bir sipariş yoktur.

Ödemeden sonra müşteri mağazanıza döner. Sipariş, yalnızca DPO onayladığında ödenmiş olarak işaretlenir: modül, müşteri geri döndüğünde, bir push bildirimi geldiğinde ve planlanmış yeniden kontrollerde işlemin sonucunu DPO'dan ister. Sipariş ancak o zaman oluşturulur ve müşteri standart sipariş onay sayfasını görür.

Ödeme onaylanmazsa, müşteri aşağıdaki mesajlardan biriyle ödeme adımına döner. Sepet korunur.

Müşteri DPO sayfasındaki düğmeye tıklayarak mağazaya dönerse, işlem önce kontrol edilir. Ödenmişse sipariş oluşturulur. Aksi halde DPO'da iptal edilir ve müşteri sepetiyle birlikte ödeme adımına döner.

Müşteri aynı sepet için tekrar ödeme yaparsa, önceki DPO işlemi önce kontrol edilir. Ödenmişse sipariş ikinci bir tahsilat olmadan oluşturulur. Hâlâ işleniyorsa müşteri Your previous payment for this order is still being processed by DPO. Please wait a few minutes before trying again. mesajını görür. Aksi halde eski işlem DPO'da iptal edilir ve yeni bir işlem oluşturulur.

DPO ödemeyi başlatamazsa, müşteri DPO hata koduna göre seçilmiş kısa bir mesajla ödeme adımında kalır, örneğin DPO Pay does not support the currency of this order. Please choose another payment method. veya The amount exceeds the limit allowed by DPO Pay. Please choose another payment method or contact us. Diğer hatalarda DPO Pay is temporarily unavailable. Please try again or choose another payment method. görüntülenir. Teknik neden günlüğe yazılır.

Push bildirimi ve cron URL'si mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez.

Modül yalnızca DPO sayfasında tek seferlik ödemeleri kabul eder. Mağazadan iade, kayıtlı kart, abonelik veya yinelenen ödeme, sitenizde kart alanı ve yalnızca yetkilendirilmiş ödemelerin tahsilatı yoktur.

Siparişler

Sipariş durumları

No order yet: müşteri DPO'ya yönlendirildi ve ödeme yapmadı, ödeme reddedildi veya iptal edildi ya da DPO henüz ödemeyi onaylamadı. Yalnızca sepet vardır.

Payment accepted, Delivered or DPO payment on hold: ödeme doğrulandı. Durum Successful payment status ayarını izler. Ödeme, işlem kimliği olarak DPO işlem jetonuyla kaydedilir. Sipariş sayfasındaki özel bir not tutarı, para birimini, onay kodunu ve jetonun başlangıcını gösterir.

DPO payment on hold after payment: DPO bir ödemeyi onayladı, ancak tutar veya para birimi sepetten farklı, ödeme yalnızca yetkilendirilmiş ve tahsil edilmemiş, işlem fazla veya eksik ödenmiş ya da müşteri ödemeyi iptal etmiş ya da sipariş zaten iptal edilmiş. Özel not nedeni açıklar. İşlemi DPO portalında kontrol edin. Yalnızca yetkilendirilmiş bir ödemeyi DPO portalında tahsil edin veya iptal edin, ardından sipariş durumunu güncelleyin.

Cancelled: modülün ödenmemiş bir siparişini (örneğin yalnızca yetkilendirilmiş bir ödeme nedeniyle beklemedeki bir siparişi) iptal ettiğinizde, açık DPO işlemi de DPO'da iptal edilir.

Daha sonra gelen bir red sonucu hiçbir siparişi değiştirmez ve eski işlemlerin sonuçları mevcut denemeyi asla başarısız kılmaz. DPO, zaten ödenmiş bir sipariş için ikinci bir başarılı ödeme onaylarsa, sipariş değiştirilmez ve olası çift ödeme hakkında bir not alır; böylece bunu DPO portalında iade edebilirsiniz. Ödenmiş veya iade edilmiş bir sipariş asla yeniden açılmaz.

İadeler

Mağazadan iade bu sürümde kullanılamaz. Ödemeyi DPO satıcı portalında iade edin, ardından PrestaShop'ta sipariş durumunu değiştirin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox DPO Pay Gateway lisans bloğu, Modules > Module Manager > VibeFox DPO Pay Gateway > Configure 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ı gizlenmiş olarak, durumu (örneğin lisansın hangi tarihe kadar etkin olduğunu ve alan adınızı) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: presta-payment-dpo satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure izni olan çalışanlar değiştirebilir. Bloğun metinleri back office 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 veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül son bilinen durumla çalışmaya devam eder.

Bir anahtar yalnızca bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan DPO Pay müşterilere ödeme adımı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. PrestaShop vitrini back office'e giriş yaptığınızı bilmez, bu nedenle ödeme yöntemi sizden de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ancak ödeme adımında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: başlatılmış ödemeler hâlâ onaylanır.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Back office'te çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

DPO Pay does not appear at checkout: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve seçili modun Company Token ve Service Type bilgilerinin girildiğini kontrol edin: test modunda test alanları, diğer durumlarda canlı alanlar. Ayarlar sayfası eksik olduklarında bir uyarı gösterir. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

The payment went through, but no order was created: büyük olasılıkla DPO hesabınız için push bildirim URL'si ayarlanmamıştır ve müşteri mağazaya dönmemiştir. DPO desteğinden ayarlarda gösterilen URL'yi ayarlamasını isteyin ve cron'un yeniden kontrol URL'sini her 15 dakikada bir çağırdığını doğrulayın. Logging seçeneğini açın ve modül sayfasındaki Log alanına bakın.

Push notification answers Unknown transaction: işlem jetonu bu mağazanın bir DPO Pay ödemesine ait değildir; örneğin bildirim aynı DPO hesabındaki başka bir mağazadan gelmiştir.

Push notification answers Verification failed: ödemeyi kontrol etmek için DPO'ya ulaşılamadı, sepet aynı anda başka bir istek tarafından işleniyordu veya sipariş oluşturulamadı (örneğin modül devre dışı). DPO bildirimi tekrarlar ve planlanmış yeniden kontrol de siparişi onaylar. Nedeni günlükte bulunur.

The push URL shows Method not allowed in the browser: bu normaldir. URL yalnızca DPO'dan gelen istekleri kabul eder.

The cron URL answers Forbidden: URL'deki jeton yanlıştır. URL'yi Configure sayfasından yeniden kopyalayın. Çalışan bir çağrı OK checked= ve kontrol edilen ödeme sayısını yanıtlar.

The Service Type is not saved: DPO'dan gelen sayısal Service Type ID olmalıdır.

The customer sees DPO Pay is temporarily unavailable: DPO işlemi oluşturmayı reddetti; örneğin yanlış bir Company Token veya Service Type ya da diğer modun bir jetonu yüzünden. DPO sonuç kodu günlüktedir.

The customer sees that DPO accepts at most 2 decimal places: sepet toplamı 3 ondalık basamaklıdır. DPO bu tutarları tahsil edemez.

The customer sees This order has already been paid with DPO Pay: DPO aynı sepet için ikinci bir ödemeyi reddetti. DPO portalındaki ödemeyi ve PrestaShop'taki siparişi kontrol edin.

Order is DPO payment on hold after payment: sipariş sayfasındaki özel notu okuyun (bkz. Sipariş durumları), ardından işlemi DPO portalında inceleyin.

Geliştiriciler, DPO'ya gönderilen müşteri verilerini actionWcpDpoPayCustomerData kancasıyla, ödeme süresini ise actionWcpDpoPayPaymentTimeLimit kancasıyla değiştirebilir.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox DPO Pay Gateway yanındaki menüyü açın ve Uninstall seçeneğini seçin. Bu modülün lisans anahtarı ve lisans durumu her zaman kaldırılır. Delete data açıksa modül ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için korunur. Siparişler için saklanan DPO verileri ve DPO payment on hold sipariş durumu her zaman korunur; böylece eski ödemelere ait geç gelen bildirimler yeniden kurulumdan sonra da çalışmaya devam eder. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

DPO Pay, ilgili sahibinin ticari markasıdır. Bu modül DPO Pay ile bağlantılı değildir ve DPO Pay tarafından onaylanmamıştır.