VibeFox Quickpay for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

PHP: 8.0 veya üzeri. Modül, eski PHP sürümlerinde kurulmayı reddeder.

Quickpay hesabı: Quickpay yönetim panelinden iki değere ihtiyacınız var: bir API kullanıcısının API anahtarı (ödeme oluşturmak, tahsil etmek ve iade yapmak için) ve hesabın özel anahtarı (Quickpay geri çağırmalarının imzasını doğrulamak için). Quickpay'de başka bir şey ayarlanması gerekmez. Quickpay geri çağırmalarının ulaşabilmesi için mağazanızın internetten erişilebilir olması ve parola korumasında olmaması gerekir.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek 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 ya da daha sonra modül listesinde VibeFox Quickpay Gateway öğesini 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ı girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Quickpay yönetim panelinden API anahtarını ve özel anahtarı yapıştırın, ardından Test API key düğmesine tıklayın (bkz. Yapılandırma).

5. Ödeme sonrası tahsilat modunu ve sipariş durumunu seçin, Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Quickpay hesabınız test modundayken Test payments seçeneğini açın ve bir Quickpay test kartıyla ödeme yapın.

Kurulumda modül bir sipariş durumu oluşturur: Quickpay payment on hold. PrestaShop, yeni ödeme modülünü tüm para birimleri, ülkeler ve müşteri grupları için etkinleştirir. Modül, kurulum sırasında etkin olan ülkelere bağlanır. Hepsini Payment > Preferences bölümünden değiştirebilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Quickpay Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. API anahtarı ve özel anahtar kaydedilene kadar sayfa Quickpay kurulum gerektiriyor: API anahtarını ve özel anahtarı girin. İkisi de kaydedilene kadar ödeme yöntemi ödeme sayfasında gizlenir. mesajını gösterir. Test payments açıkken sayfa, Quickpay hesabınız canlıya geçtiğinde kapatmanızı hatırlatır.

Quickpay

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Quickpay. Zorunlu: boş bir başlık kaydedilmez.

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

Quickpay API kimlik bilgileri

Quickpay yönetim panelinde (manage.quickpay.net) Settings > Integration bölümünü açın. Bir API kullanıcısının API anahtarını (Settings > Users) ve hesabın özel anahtarını kopyalayın.

Callback URL: mağazanızın geri çağırma URL'sini gösterir. Dostça URL'ler kullanılırken şöyle görünür: https://your-shop/module/wcp_quickpay_gateway/callback. Quickpay bunu her ödeme işleminden sonra (yetkilendirme, tahsilat, iade, iptal) çağırır. Her ödemeyle otomatik olarak gönderildiği için Quickpay'de hiçbir şey yapılandırılmasına gerek yoktur.

API key: bir Quickpay API kullanıcısının API anahtarı. Ödeme oluşturmak, tahsil etmek ve iade yapmak için kullanılır.

Private key: hesabın özel anahtarı. Quickpay geri çağırmalarının imzasını (HMAC-SHA256) doğrulamak için kullanılır. Bu anahtar olmadan hiçbir ödeme onaylanamaz ve geri çağırmalar reddedilir.

Kaydedilmiş anahtarlar bir daha gösterilmez. Alan boş kalır ve Kaydedildi — saklamak için boş bırakın. mesajını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Kayıtlı gizli bilgileri temizle: kaldırmak için API key veya Private key kutusunu işaretleyin ve Save düğmesine tıklayın. Boş bir alan kayıtlı değeri korur.

Test payments: Quickpay test kartlarıyla yapılan ödemeleri kabul eder. Quickpay'in ayrı bir sandbox'ı yoktur: Quickpay hesabınız test modundayken ödemeler test kartlarıyla yapılır ve test olarak işaretlenir. Bunu yalnızca test sırasında açın. Kapalıyken bir test ödemesi hiçbir zaman siparişi ödenmiş olarak işaretlemez. Açıkken ödeme sayfasında ödeme yönteminin altında Test modu: Quickpay test kartları kabul edilir. görünür. Varsayılan: kapalı.

Test API key: bu düğme, API key alanına yazılan anahtarı (alan boşsa kayıtlı anahtarı) kaydetmeden, Quickpay'e kimliği doğrulanmış bir istekle kontrol eder. Yanıtları şunlardır: Bağlantı başarılı — API anahtarı geçerli., Quickpay API anahtarını reddetti., API anahtarı yapılandırılmamış. veya Bağlantı başarısız: ardından neden.

Ödeme

Capture: paranın karttan ne zaman çekildiği.

Order status after payment: Quickpay tahsil edilen ödemeyi onayladıktan sonraki sipariş durumu.

Gelişmiş

Debug log: modül klasöründeki logs/qpg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Reddedilen geri çağırmalar ve Quickpay API hataları gibi hatalar ve uyarılar her zaman kaydedilir. Her istek ve geri çağırmanın ayrıntılarını da kaydetmek için bunu açın. API anahtarları, kart bilgileri ve müşteri ayrıntıları hiçbir zaman 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 kaldırıldığında ağ geçidi ayarları ve günlük silinir. Sipariş verileri (Quickpay ödemeleri, iadeler, notlar) ve Quickpay payment on hold sipariş durumu her zaman saklanır. Varsayılan: kapalı.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak bir kart simgesiyle Quickpay) ve onaylar. Modül, sepet için sepet para biriminde bir Quickpay ödemesi ve sepet tutarı için bir ödeme bağlantısı oluşturur ve müşteriyi Quickpay ödeme penceresine yönlendirir. Bu noktada henüz bir sipariş yoktur. Müşteri, Quickpay ödeme penceresinde etkinleştirilmiş yöntemlerden biriyle orada öder. Müşterinin e-posta adresi Quickpay'e iletilir. Quickpay destekliyorsa ödeme penceresi müşterinin dilinde açılır (Danca, Almanca, İngilizce, İspanyolca, Fince, Fransızca, İtalyanca, Hollandaca, Norveççe, Lehçe, İsveççe); aksi halde İngilizce açılır.

Ödemeyi tamamladıktan sonra müşteri mağazanıza geri döner. Dönüşün kendisi hiçbir şeyi ödenmiş olarak işaretlemez. Sipariş, yalnızca Quickpay onayladıktan sonra ödenmiş olarak işaretlenir: imzalı geri çağırma, tahsil edilen tutar ve para birimi sepetle eşleştiğinde siparişi oluşturur. Ardından müşteri standart sipariş onay sayfasını görür. Authorize only seçeneğinde sipariş bunun yerine Quickpay payment on hold durumunda oluşturulur ve ödemeyi daha sonra siz tahsil edersiniz. Müşteri geri döndüğünde geri çağırma henüz ulaşmamışsa, bir Payment confirmation sayfası Ödemeniz Quickpay tarafından onaylanıyor. Sipariş onaylanır onaylanmaz size bir e-posta gönderilecek. mesajını, Check again ve Back to checkout düğmeleriyle birlikte gösterir.

Müşteri ödeme penceresinde iptal ederse, ödeme bağlantısı Quickpay'de silinir ve müşteri Ödeme iptal edildi. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. mesajıyla ödeme sayfasına döner. Kart reddedildiyse mesaj Ödeme tamamlanamadı. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. olur. Sepet korunur. Yeni bir deneme, sepetin mevcut Quickpay ödemesini yeni bir bağlantıyla yeniden kullanır; bu yüzden eski bağlantı asla paralel olarak ödenemez. Sepetin bir ödemesi yetkilendirilmiş ve tahsilatını bekliyorsa ikinci bir ödeme başlatılmaz; müşteri Payment confirmation sayfasını görür.

Ödeme başlatılamazsa müşteri ödeme sayfasında kalır ve Quickpay ödemesi başlatılamadı. Lütfen tekrar deneyin veya başka bir ödeme yöntemi seçin. mesajını görür. Teknik neden günlüğe yazılır. Anahtarlar eksikse mesaj Quickpay şu anda kullanılamıyor. Lütfen başka bir ödeme yöntemi seçin. olur.

Geri çağırma, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez.

Modül yalnızca tek seferlik ödemeleri kabul eder. Abonelik veya tekrarlayan ödeme, kayıtlı kart ve kısmi tahsilat yoktur; Quickpay'e sepet veya fatura satırı gönderilmez ve ayrı MobilePay, Apple Pay veya Klarna yöntemleri yoktur: müşteri, Quickpay ödeme penceresinizdeki yöntemler arasından seçim yapar.

Siparişler ve iadeler

Sipariş durumları

No order yet: müşteri Quickpay'e yönlendirildi ve ödeme yapmadı, kart reddedildi ya da ödeme yetkilendirildi ve otomatik tahsilatı bekliyor. Yalnızca sepet vardır.

Payment accepted or Delivered: Quickpay, tahsil edilen ödemeyi doğru tutar ve para birimiyle onayladı. Durum, Order status after payment seçimini izler. Ödeme, Quickpay ödeme kimliği işlem kimliği olarak kaydedilir ve bir notta ödeme gösterilir (test ödemeleri için TEST olarak işaretlenir).

Quickpay payment on hold: ödeme yalnızca yetkilendirilmiştir ve Capture Quickpay payment işlemini bekler; ya da Quickpay, sipariş tutarından farklı bir tutar veya para birimi bildirdi (ör. ödeme başladıktan sonra sepet değiştirildi ya da Quickpay yönetim panelinde farklı bir tutar tahsil edildi); ya da otomatik tahsilat başarısız oldu ve tutar hâlâ yalnızca rezerve edilmiş. Not bunu açıklar. Para farklı bir tutarla tahsil edildiğinde ödeme, Quickpay'in tahsil ettiği tutarla siparişe kaydedilir.

Canceled: siparişi iptal ettiniz ya da beklemedeki bir siparişin ödemesi Quickpay yönetim panelinde iptal edildi.

Refunded: ödeme modül üzerinden tamamen iade edildi.

Zaten ödenmiş, iptal edilmiş veya iade edilmiş bir siparişe gelen ödeme siparişi değiştirmez. Bir not, örneğin çift ödemeyi iade etmek için ödemeyi Quickpay yönetim panelinde kontrol etmenizi ister.

Ödenmemiş bir siparişi iptal ettiğinizde, ödeme bağlantısı Quickpay'de silinir. Yetkilendirilmiş bir siparişi iptal etmek, ayrılan tutarı otomatik olarak serbest bırakmaz: bir not, ödemeyi Quickpay yönetim panelinde iptal etmenizi hatırlatır; aksi halde rezervasyon, yetkilendirme süresi dolduğunda sona erer.

Quickpay bloğu

Sipariş sayfasında ödeme kimliği, ödeme durumu, tutar ve iade edilen tutarın yer aldığı bir Quickpay payment bloğu; test ödemeleri için bir Test payment rozeti; sepetin tüm Quickpay ödemelerinin listesi (birden fazla varsa); iade geçmişi ve siparişin Quickpay notes bölümü gösterilir. Tahsilat ve iadeler için siparişleri düzenleme yetkisi gerekir; modül sayfalarına erişim gerekmez.

Tahsilat

Authorize only seçiliyken Quickpay bloğunda Capture Quickpay payment düğmesine tıklayın ve Sipariş tutarı Quickpay üzerinden tahsil edilsin mi? sorusunu onaylayın. Sipariş tutarının tamamı tahsil edilir; kısmi tahsilat kullanılamaz. Quickpay hemen onaylarsa sipariş Order status after payment durumuna alınır. Aksi halde bir not tahsilatın istendiğini belirtir ve Quickpay geri çağırması onayladığında sipariş ödenmiş olarak işaretlenir. Reddedilen bir tahsilat blokta gösterilir ve siparişe not edilir.

İadeler

Quickpay bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via Quickpay düğmesine tıklayın. Bu tutar Quickpay üzerinden iade edilsin mi? Bu işlem geri alınamaz. sorusunu onaylayın. Tahsil edilmiş ödemeler için tam ve kısmi iadeler desteklenir. İadeler, Quickpay'in tahsil ettiği tutar ve para biriminde yapılır; bu yüzden tutar veya para birimi uyuşmazlığından sonra, sipariş tutarına değil müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz. Quickpay iadeleri eşzamansız işler: iade geçmişinde requested görünür, geri çağırma bunu confirmed veya failed olarak ayarlar ve sonucu notlara ekler. Quickpay iadeyi hemen reddederse blok hatayı gösterir ve hiçbir iade kaydedilmez. Tam iade siparişi Refunded durumuna alır; kısmi iade durumu değiştirmez. Hiç tahsil edilmemiş yetkilendirilmiş bir ödeme iade edilemez; Quickpay yönetim panelinde iptal edin.

Modül kredi notları oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Quickpay üzerinden para geri göndermez.

Doğrudan Quickpay yönetim panelinde yapılan iadeler yalnızca notlara eklenir. Sipariş durumu ve kredi notları otomatik olarak değişmez. Gerekirse bunları elle güncelleyin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Quickpay Gateway lisans bloğu, Modules > Module Manager > VibeFox Quickpay Gateway > Configure sayfasında ayarların üstünde bulunan ilk bloktur. Anahtarı License key alanına girin 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-quickpay 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 yönetim paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini belirtir; örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihle birlikte 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 tek 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ızda serbest bırakın.

Etkin bir anahtar olmadan Quickpay, ö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. PrestaShop vitrini, yönetim paneline giriş yaptığınızı bilmez; bu nedenle ödeme yöntemi sizden de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager bölümünde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır, tahsilat ve iadeler çalışır.

Bir lisansın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, ardından 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

Quickpay ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve hem API key hem de Private key değerlerinin kaydedildiğini kontrol edin. İki anahtar da yoksa yöntem gizlenir. 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 gerçekleşti ama sipariş oluşturulmadı: Quickpay geri çağırması mağazanıza ulaşmadı ya da reddedildi. Mağazanızın internetten erişilebilir olduğunu (parola koruması olmadan) ve Private key değerinin aynı Quickpay hesabının özel anahtarı olduğunu kontrol edin. Reddedilen geri çağırmalar her zaman modül sayfasındaki günlüğe yazılır. Her geri çağırmayı görmek için Debug log seçeneğini açın.

Günlük Callback rejected: invalid checksum. gösteriyor: ayarlardaki özel anahtar, geri çağırmayı gönderen hesaba ait değil. Quickpay yönetim panelindeki Settings > Integration bölümünden tekrar kopyalayın.

Günlük Callback rejected: the private key is not configured. gösteriyor: özel anahtarı girin. Geri çağırmalar özel anahtar olmadan asla kabul edilmez.

Günlük Callback: no cart found for payment … gösteriyor: geri çağırma, bu mağazanın oluşturmadığı bir Quickpay ödemesine ait; örneğin PrestaShop dışında yapılmış bir ödeme.

Günlük Could not lock the cart veya Cannot create the order gösteriyor: aynı sepetin başka bir geri çağırması o anda uygulanıyordu ya da sipariş oluşturulamadı (ör. modül devre dışı). Geri çağırmaya hata yanıtı verilir, bu yüzden Quickpay onu yeniden gönderir.

Bir test ödemesi siparişi ödenmiş olarak işaretlemedi: Test payments kapalı. Günlük (ve sipariş varsa not), test ödemesinin kabul edilmediğini belirtir. Test sırasında ayarı açın, hesabınız canlıya geçtiğinde kapatın.

Ödeme sonrası sipariş Quickpay payment on hold durumunda: Quickpay bloğundaki notları okuyun. Ödeme yalnızca yetkilendirilmiş ve Capture Quickpay payment bekliyor olabilir, ödenen tutar veya para birimi siparişten farklı olabilir ya da tahsilat başarısız olmuş olabilir. Tahsil edin, siparişi işleyin ya da ödemeyi iade edin.

Test API key «Quickpay API anahtarını reddetti.» mesajını gösteriyor: anahtar yanlış ya da API erişimi olmayan bir kullanıcıya ait. Quickpay yönetim panelinden bir API kullanıcısının API anahtarını kopyalayın.

Müşteri «Quickpay ödemesi başlatılamadı.» mesajını görüyor: modül sayfasındaki Log alanına bakın. Quickpay hatasını gösterir; örneğin Quickpay hesabınızın kabul etmediği bir para birimi.

İade başarısız oluyor: siparişin tahsil edilmiş bir Quickpay ödemesi olmalıdır. Bu siparişin Quickpay ödemesi tahsil edilmedi — iade edilecek bir şey yok. mesajı, ödemenin yalnızca yetkilendirilmiş olduğu anlamına gelir; tahsil edin ya da Quickpay yönetim panelinde iptal edin. Geçersiz iade tutarı: en fazla … mesajı, tutarın tahsil edilmiş ödemede kalandan fazla olduğu anlamına gelir.

Geliştiriciler, actionQpgQuickpayLinkData kancasıyla Quickpay ödeme bağlantısının parametrelerini değiştirebilir.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Quickpay 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 silinir. Delete data açıksa ağ geçidi ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Quickpay ödemeleri, iadeler ve Quickpay payment on hold sipariş durumu her zaman saklanır; bu sayede daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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