VibeFox Paysera for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerinde kurulmaz.

Paysera projesi: Paysera projenizin proje kimliğine ve proje şifresine (sign key) ihtiyacınız vardır. Müşterinin gördüğü ödeme yöntemleri bu projede etkinleştirilenlerdir. Callback için Paysera'da bir şey ayarlamanız gerekmez: URL'si her ödeme isteğiyle birlikte gönderilir.

Erişilebilir mağaza: siparişler Paysera callback'i ile oluşturulduğundan mağazanız internetten erişilebilir olmalıdır; oturum açma, temel kimlik doğrulama veya güvenlik duvarının arkasında olmamalıdır. Callback, mağaza bakım modundayken de çalışır.

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

Kurulum

1. Back Office'te 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 tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Paysera Payment modülünü bulup Configure düğmesine tıklayın.

3. Configure sayfasının üstündeki lisans bloğunda License key alanına VibeFox lisans anahtarınızı yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Paysera hesabınızdaki Project ID ve Project password değerlerini girin (bkz. Yapılandırma).

5. İsteğe bağlı: Para çekmeden akışı denemek için Paysera projesinde Allow test payments ve modülde Test payments seçeneğini etkinleştirin. Satışa başlamadan önce kapatın.

6. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın.

Kurulumda modül iki sipariş durumu oluşturur: Awaiting Paysera payment ve Paysera payment on hold. 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ırlayabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Paysera Payment > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanların üstünde sayfa, proje kimliği ve proje şifresi girilene kadar Paysera is hidden at checkout until the project ID and the project password are entered. mesajını, test ödemeleri veya sandbox açıkken ise Test mode is on: customers are not charged. Turn off "Test payments" and select "Production" before accepting real orders. mesajını gösterir.

Paysera

Enable/Disable: Enable Paysera Payment ödeme yöntemini açar veya kapatır. Varsayılan: off.

Title: müşterinin ödeme sırasında gördüğü ödeme yöntemi adı. Siparişte de ödeme yönteminin adı olarak kaydedilir. Varsayılan: Paysera. Zorunlu.

Description: ödeme sırasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely via Paysera.

Paysera projesi

Proje kimliğini ve proje şifresini Paysera hesabınızda, Projects and activities altında, projenizin ardından General project settings bölümünde bulabilirsiniz.

Callback URL: Paysera'nın her ödemeyi onaylamak için kullandığı adres. Dostça URL'ler kullanıldığında şöyle görünür: https://your-shop/module/wcp_paysera_payment/callback; başına bir dil kodu da eklenmiş olabilir. Her ödemeyle otomatik gönderildiğinden Paysera'da bir şey ayarlamanız gerekmez, ancak internetten erişilebilir olmalıdır. Siparişler yalnızca bu imzalı callback'lerle oluşturulur.

Project ID: Paysera projenizin sayısal kimliği. Yalnızca rakamlar kabul edilir: başka bir değer Project ID must be a number: the numeric ID of your Paysera project. hatasını verir ve hiçbir şey kaydedilmez.

Project password: proje şifresi (sign key). Ödeme isteklerini imzalar ve Paysera callback'lerini doğrular. Kayıtlı şifre bir daha 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.

Clear saved password: kayıtlı şifreyi kaldırmak için Project password kutusunu işaretleyin ve Save düğmesine tıklayın. Boş alan kayıtlı değeri korur.

Test

Test payments: ödemeleri test modunda gönderir, bu nedenle para çekilmez. Paysera, müşteriden ücret almadan başarılı bir test ödemesi döndürür. Önce Paysera projesi ayarlarında Allow test payments seçeneğini etkinleştirin. Bu seçenek açık olduğunda test ödemeleri siparişleri ödenmiş olarak işaretler; kapalıyken bir test ödemesi siparişi beklemeye alır. Varsayılan: off. Açık olduğunda müşteriler ödeme yönteminin altında TEST MODE — no money will be charged. ifadesini görür.

Environment: müşterinin yönlendirildiği ortam. Normal bir Paysera projesi için, test ödemeleri dahil, Production seçili kalmalıdır. Varsayılan: Production.

Gelişmiş

Debug log: ödeme olaylarını modül klasöründeki logs/wc_psr_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar ve uyarılar her zaman yazılır; diğer adımlar yalnızca bu seçenek açıkken yazılır. Şifreler ve müşteri verileri hiçbir zaman yazılmaz. Varsayılan: off.

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çıksa modülü kaldırmak modül ayarlarını ve günlüğü siler. Sipariş verileri (siparişler, Paysera ödeme kayıtları, sipariş durumları) her zaman korunur. Varsayılan: off.

Ödeme

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Paysera) ve siparişi onaylar. Modül, sepet tutarını sepet para biriminin en küçük biriminde, müşterinin adı, e-posta adresi ve fatura adresiyle ve mağaza sayfasının dilini (Litvanca, Letonca, Estonca, Rusça, Almanca, Lehçe; diğer durumlarda İngilizce) içeren imzalı bir ödeme isteği oluşturur. Müşteri Paysera ödeme penceresine yönlendirilir ve orada bir banka, kart veya başka bir yöntem seçer. Bu noktada henüz bir sipariş yoktur.

Paysera ödemeyi sunucudan sunucuya bir callback ile onaylar. Sipariş, Paysera imzalı bir callback ile onaylayana kadar ödenmiş olarak işaretlenmez; müşterinin mağazaya dönüşü hiçbir zaman sipariş oluşturmaz veya ödemez. Müşteri callback'ten sonra geri döndüğünde standart sipariş onay sayfası gösterilir. Banka ödeme emrini kabul etmiş ama henüz yürütmemişse sipariş Awaiting Paysera payment durumunda oluşturulur ve sayfa Paysera is confirming your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. mesajını gösterir. Beklemedeki bir sipariş için sayfa Your payment is being reviewed. We will contact you if anything else is needed. mesajını gösterir.

Müşteri callback gelmeden geri dönerse, Payment confirmation sayfası siparişin Paysera ödemeyi onaylar onaylamaz oluşturulacağını açıklar ve Check again ve Back to checkout seçeneklerini sunar.

Müşteri Paysera penceresinde iptal ederse ödeme sayfasına The Paysera payment was cancelled. You can try again or choose another payment method. mesajıyla döner. Paysera ödemenin yürütülmediğini bildirirse mesaj The payment was not completed. You can try again or choose another payment method. olur. Her iki durumda da sepet korunur. Sepetin zaten bir siparişi varsa yeni bir deneme ikinci bir ödeme yerine doğrudan sipariş onayına gider.

Ödeme başlatılamazsa müşteri Paysera payments are temporarily unavailable. Please choose another payment method. mesajıyla ödeme sayfasında kalır; geçersiz bir sipariş tutarı varsa This order cannot be paid via Paysera. mesajını görür. Neden günlüğe yazılır.

Callback, mağaza bakım modundayken çalışır ve mağazanızın ülke kısıtlamasından etkilenmez.

Modül; Back Office'ten iade, ödeme sayfasında banka veya ödeme yöntemi seçimi, abonelik, kayıtlı kart ve Paysera teslimat veya kurye hizmetlerini desteklemez.

Siparişler

Sipariş durumları

No order yet: müşteri Paysera'ya yönlendirildi ve callback henüz gelmedi ya da müşteri iptal etti. Yalnızca sepet mevcuttur.

Payment accepted: Paysera, ödemeyi eşleşen tutar ve para birimiyle onayladı. Ödeme, Paysera istek kimliğiyle işlem kimliği olarak kaydedilir; bir not isteği ve ödeme yöntemini gösterir, test ödemeleri için (TEST — no money charged) işaretiyle.

Awaiting Paysera payment: Paysera ödeme emrini kabul etti, ancak banka henüz yürütmedi. Paysera ödemeyi onayladığında sipariş Payment accepted durumuna geçer.

Paysera payment on hold: ödemenin manuel inceleme gerekir. Ödenen tutar veya para birimi sepetten ya da sipariş toplamından farklıdır; Test payments kapalıyken bir TEST ödemesi geldi (para çekilmedi); ya da ödeme, müşteri onu iptal ettikten sonra onaylandı. Ödeme kaydedilmez. Not nedenini açıklar ve Paysera bloğu, ödemeyi Paysera hesabınızda kontrol edip siparişi Payment accepted olarak ayarlamanızı ya da siparişi iptal edip ödemeyi Paysera'da iade etmenizi ister.

Cancelled: iptal edilmiş bir sipariş için daha sonra onaylanan bir ödeme, siparişin durumunu değiştirmez. Bir not, siparişi geri yüklemenizi (Payment accepted olarak ayarlamanızı) veya ödemeyi Paysera'da iade etmenizi ister. İptal edilmiş bir siparişte sonraki bir TEST ödemesi ya da tutar uyuşmazlığı da yalnızca bir not ekler.

Zaten ödenmiş bir sipariş için başka bir başarılı ödeme gelirse sipariş değişmez ve bir not, çift ödemenin Paysera hesabınızda iade edilmesini ister. Diğer Paysera durumları (ödeme yürütülmedi, ek bilgi) yalnızca bir not ekler.

Paysera ödeme bloğu

Sipariş sayfasında, Paysera sipariş kimliğini (sepet numarası ve deneme), Paysera istek kimliğini, ortamı ve bir TEST payment işaretini, ödeme durumunu, istenen ve ödenen tutarları, ödeme yöntemini ve modülün notlarını içeren bir Paysera payment bloğu gösterilir.

İadeler

Back Office'ten iadeler desteklenmez: Paysera ödeme penceresi protokolünün bir iade API'si yoktur. İadeleri Paysera hesabınızdan yapın. Paysera bir iade bildirdiğinde, siparişe iade edilen tutarı içeren bir not eklenir ve sipariş durumu değişmez. Gerekirse iadeyi PrestaShop'ta manuel olarak kaydedin.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Paysera Payment lisans bloğu, Modules > Module Manager > VibeFox Paysera Payment > 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ı maskelenmiş 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: presta-payment-paysera satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure yetkisine sahip ç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 bir tarihle birlikte License expired on. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı hakkı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: çok mağazalı kurulumda da ana mağazanın alan adında. Anahtarı mağazadan kaldırmak alan adı hakkını serbest bırakmaz. Alan adı hakkını vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan Paysera, ö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. PrestaShop vitrini Back Office'e giriş yaptığınızı bilmez, bu nedenle ödeme yöntemi sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sırasında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine callback ile onaylanır.

Lisans süresi dolduğunda 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 günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Paysera ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve hem Project ID hem de Project password alanlarının girildiğini kontrol edin. Ayarlar sayfası, bunlardan biri eksik olduğu sürece 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.

Ödeme yapıldı ama sipariş oluşturulmadı: sipariş, müşterinin dönüşüyle değil Paysera callback'iyle oluşturulur. Mağazanızın ayarlarda gösterilen Callback URL adresinden internete erişilebilir olduğunu kontrol edin (oturum açma, temel kimlik doğrulama veya güvenlik duvarının arkasında olmamalı) ve modül sayfasındaki Log alanına bakın.

Callback, Invalid signature yanıtı veriyor: Project password projeyle eşleşmiyor veya callback Paysera'dan gelmiyor. Proje şifresini yeniden kopyalayın. Projeyi ya da şifreyi değiştirdiyseniz, değişiklikten önce başlatılan ödemeler artık doğrulanamaz.

Callback, Project ID mismatch yanıtı veriyor: ayarlardaki Project ID, ödemeyi yapan projeden farklı.

Callback, Order not found yanıtı veriyor: callback'teki sepetin bu mağazada bir Paysera ödemesi yok; örneğin ödeme, aynı projeye sahip başka bir mağazada başlatılmış olabilir.

Callback, Gateway not configured, Busy veya Temporary error yanıtı veriyor: proje kimliği veya şifresi boş, aynı sepet için başka bir callback hâlâ çalışıyor ya da sipariş oluşturulamadı (örneğin modül devre dışı). Paysera callback'i yeniden dener. Nedenini görmek için Debug log seçeneğini açın.

Paysera ödeme penceresini reddediyor ya da projenin mevcut olmadığını söylüyor: Environment ayarını kontrol edin. Normal bir Paysera projesi yalnızca Production ile çalışır; Sandbox, Paysera sandbox ortamında oluşturulmuş bir proje gerektirir.

Test ödemesi siparişi ödemiyor: bir TEST ödemesi, siparişi yalnızca Test payments açıkken öder. Aksi halde sipariş, para çekilmediğini belirten bir notla beklemeye alınır. Ayrıca Paysera projesinde Allow test payments seçeneğini etkinleştirin.

Bir sipariş, tutar/para birimi uyuşmazlığına ilişkin bir notla Paysera payment on hold durumunda: Paysera, tutarı veya para birimi sepet toplamından farklı bir ödeme onayladı; örneğin müşteri ödemeye başladıktan sonra sepet başka bir sekmede değiştirilmiş olabilir. Ödemeyi Paysera hesabınızda karşılaştırın ve siparişi kabul edin ya da ödemeyi manuel olarak iade edin. Aynı sipariş için sonraki doğru bir ödeme siparişi ödenmiş olarak işaretler.

Müşteri, Paysera payments are temporarily unavailable mesajını görüyor: Log alanına bakın. Proje kimliği veya şifresi boş olabilir ya da Paysera'ya gönderilen mağaza adreslerinden biri 255 karakterden uzun olabilir.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Paysera Payment 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 saklanır. Paysera ödeme kayıtları ile Awaiting Paysera payment ve Paysera payment on hold sipariş durumları her zaman korunur. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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