VibeFox CorvusPay for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

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

Para birimi: AUD, BAM, BHD, CAD, CHF, CZK, DKK, EUR, GBP, HRK, HUF, ISK, MKD, NOK, PLN, RON, RSD, RUB, SEK veya USD. Sepetin para birimi bunlardan farklıysa ödeme yöntemi ödeme sayfasında gösterilmez. Tutarlar 2 ondalık basamakla gönderilir; daha fazla ondalık basamağa sahip bir toplam (örneğin 3 ondalıklı BHD fiyatları olan bir mağazada) yuvarlanmak yerine reddedilir.

CorvusPay hesabı: bir CorvusPay satıcı hesabına ihtiyacınız vardır. CorvusPay, her mağaza için ayrı ayrı test ve canlı mağaza için bir Store ID ve bir Secret Key verir; bunlar CorvusPay Merchant Center'da gösterilir. Modülün Success URL ve Cancel URL adresleri oraya girilmelidir (bkz. Yapılandırma).

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar yalnızca 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 tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox CorvusPay Gateway öğesini bulup Configure düğmesine tıklayın.

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

4. CorvusPay test mağazanızın Store ID ve Secret Key bilgilerini girin (gerçek ödemeler için canlı mağazanın bilgilerini de). Configure sayfasında gösterilen Success URL ve Cancel URL adreslerini hem test hem de canlı mağaza için CorvusPay Merchant Center'a kopyalayın.

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Bir test siparişi verin, ardından canlıya geçmek için Test Mode seçeneğini kapatın.

Kurulumda modül CorvusPay payment on hold sipariş durumunu oluşturur. PrestaShop, yeni bir ödeme modülünü o anda etkin olan para birimleri, müşteri grupları ve ülkelerle ilişkilendirir. Bunu Payment > Preferences bölümünden değiştirebilirsiniz; daha sonra etkinleştirdiğiniz bir ülke, modül için orada işaretlenmelidir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox CorvusPay Gateway > 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, test modu açıkken Test modu açık. Ödemeler CorvusPay test ortamına gider — gerçek para alınmaz. mesajını gösterir; ayrıca ödeme geçidi etkinken mevcut modun Store ID veya Secret Key bilgisi boşsa (bunlar doldurulana kadar ödeme sayfasında gizlenir) ve mağazanızın varsayılan para birimi CorvusPay tarafından desteklenmiyorsa sizi uyarır.

CorvusPay

Enable/Disable: Enable CorvusPay Gateway ö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: Credit/Debit Card (CorvusPay).

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely with your credit or debit card via CorvusPay. Test modunda buna (Test modu — gerçek ödeme alınmaz.) eklenir.

Mağaza kimlik bilgileri

Store ID ve Secret Key, CorvusPay tarafından her mağaza için ayrı ayrı (test ve canlı) verilir ve CorvusPay Merchant Center'da gösterilir.

Test Mode: CorvusPay test ortamını (wallet.test.corvuspay.com) ve test Store ID ile test Secret Key bilgilerini kullanır. Varsayılan: açık. Gerçek ödemeleri wallet.corvuspay.com üzerinden almak için kapatın.

Test Store ID: CorvusPay test mağazanızın sayısal Store ID'si.

Test Secret Key: CorvusPay test mağazanızın Secret Key'i; HMAC-SHA256 imzaları için kullanılır.

Live Store ID: CorvusPay canlı mağazanızın sayısal Store ID'si.

Live Secret Key: CorvusPay canlı mağazanızın Secret Key'i; HMAC-SHA256 imzaları için kullanılır.

Clear saved secrets: Test Secret Key veya Live Secret Key seçeneğini işaretleyin ve kaldırmak için Save düğmesine tıklayın.

Store ID yalnızca rakam içermelidir. Başka bir şey girerseniz sayfa … yalnızca rakam içermelidir — önceki değer korundu. mesajını gösterir ve diğer alanlar yine de kaydedilir. Kaydedilmiş Secret Key'ler bir daha gösterilmez: alan boş kalır ve Kaydedildi — korumak için boş bırakın. yazısını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Bir ödeme her zaman başlatıldığı mağazanın Secret Key'i ile doğrulanır; bu yüzden test ödemeleri hâlâ geri gelebilecekken test anahtarını dolu tutun.

Success URL ve Cancel URL

Bu bölümde gösterilen iki adresi, hem test hem de canlı mağaza için CorvusPay Merchant Center'a kopyalayın. CorvusPay, ödemeden sonra müşteriyi bu adreslere geri yönlendirir. Adresleri sayfada gösterildiği gibi birebir kopyalayın; dostça URL'lerde aşağıdaki örneklere benzerler, başında /en/ gibi bir dil kodu da olabilir.

Ödeme ayarları

Transaction Type: kartın nasıl tahsil edileceği.

Payment Page Language: CorvusPay ödeme sayfasının dili. Site language (varsayılan), CorvusPay destekliyorsa mağazanızın mevcut dilini kullanır; desteklemiyorsa İngilizce kullanılır. Ayrıca Hrvatski, English, Deutsch, Italiano, Srpski veya Slovenščina seçebilirsiniz.

Order Status After Payment: başarılı bir Sale ödemesinden sonra sipariş durumu. Sipariş doğrudan bu durumda oluşturulur.

Gelişmiş

Logging: hata ayıklama bilgilerini modül klasöründeki logs/corvuspay_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Bu kapalı olsa bile hatalar her zaman kaydedilir; gizli bilgiler, imzalar ve müşteri verileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

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

Delete Data: açıksa modül kaldırıldığında modül ayarları ve günlük dosyaları silinir. Siparişler, CorvusPay işlem verileri ve sipariş durumu her zaman korunur. Varsayılan: kapalı.

Ödeme

Ödeme adımında müşteri ödeme yöntemini (varsayılan olarak Credit/Debit Card (CorvusPay)) seçer ve onaylar. Sonraki sayfa CorvusPay'e ödeme için yönlendiriliyorsunuz. Lütfen bekleyin... mesajını gösterir ve imzalı formu CorvusPay ödeme sayfasına gönderir. Yönlendirme başlamazsa müşteri Pay via CorvusPay düğmesine tıklar; Back to checkout ise ödeme sayfasına geri döndürür. Sepet toplamı, para birimi, kısa bir açıklama (sepet numarası ve mağaza adı) ile fatura adresi bilgileri ve e-posta (ödeme sayfasını önceden doldurmak için) gönderilir. Bu noktada henüz bir sipariş yoktur. Tutar, para birimi, mod ve işlem türü değişmediği sürece aynı CorvusPay sipariş numarası yeniden kullanılır ve CorvusPay bu numara için ikinci bir ödeme kabul etmez.

Ödemeden sonra CorvusPay müşteriyi Success URL'ye geri yönlendirir. Sipariş, CorvusPay onaylayana kadar ödenmiş olarak işaretlenmez: CorvusPay sipariş numarası bu mağaza tarafından verilmiş olmalı, imza ödemenin başlatıldığı mağazanın Secret Key'i ile eşleşmeli ve tutar ile para birimi sepetle uyuşmalıdır. Ardından sipariş oluşturulur ve müşteri standart sipariş onay sayfasında CorvusPay ödemeniz alındı. mesajını görür. Authorize only için sayfa CorvusPay ödemeniz yetkilendirildi. Tutar, mağaza siparişinizi işlediğinde tahsil edilecek. mesajını gösterir; beklemedeki bir sipariş için ise Ödemeniz alındı ve mağaza tarafından inceleniyor. mesajını gösterir.

Sipariş o anda oluşturulamazsa (örneğin başka bir istek aynı sepeti onaylıyorsa), müşteri Check again düğmesiyle birlikte Ödemeniz onaylanıyor mesajını görür; düğme, sipariş var olur olmaz sipariş onayına götürür. Success URL isteği doğrulanamazsa müşteri Ödeme onaylanmadı ve Bu CorvusPay ödemesi onaylanamadı. Kartınızdan tahsilat yapıldıysa lütfen mağazayla iletişime geçin — tekrar ödeme yapmayın. mesajını görür. Hiçbir şey değiştirilmez. Success URL, mağaza bakım modundayken de çalışır.

Müşteri CorvusPay sayfasında iptal ederse, sepeti bozulmadan ödeme sayfasına döner ve CorvusPay ödemesi iptal edildi ve sipariş ödenmedi. Sepetiniz hâlâ burada — tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. mesajını görür.

Ödeme başlatılamazsa müşteri ödeme sayfasında kısa bir mesajla kalır: CorvusPay yapılandırılmamış. Lütfen başka bir ödeme yöntemi seçin., CorvusPay … para biriminde ödeme kabul etmiyor veya Bu sipariş toplamı CorvusPay ile ödenemez (sıfırdan büyük olmalı ve en fazla 2 ondalık basamağa sahip olmalıdır). Lütfen başka bir ödeme yöntemi seçin.

Sipariş, yalnızca CorvusPay müşteriyi Success URL'ye geri yönlendirdiğinde onaylanır; sunucudan sunucuya bildirim yoktur. Müşteri ödemeden hemen sonra tarayıcıyı kapatırsa sipariş oluşturulmaz. Modül, PrestaShop üzerinden iade, tahsilat (capture) veya iptal (void) işlemi sunmaz (CorvusPay sunucu API'si bir istemci sertifikası gerektirir); ayrıca kayıtlı kart, abonelik, taksit veya mağaza içi kart formu da yoktur.

Siparişler

Sipariş durumları

Henüz sipariş yok: müşteri CorvusPay'e gönderildi ve onaylanmış bir ödemeyle geri dönmedi. Yalnızca sepet mevcut. Müşteri ödeme yaptı ama geri dönmediyse, ödemeyi CorvusPay Merchant Center'da kontrol edin ve siparişi manuel olarak oluşturun.

Payment accepted, Delivered veya CorvusPay payment on hold: Sale ödemesi onaylandı. Durum, Order Status After Payment ayarını izler. Ödeme, CorvusPay işlem kimliğiyle kaydedilir; CorvusPay bir kimlik göndermezse CorvusPay sipariş numarasıyla kaydedilir ve ödeme Merchant Center'da bu numarayla bulunabilir. Özel bir sipariş notu, CorvusPay sipariş numarasını, onay kodunu ve kart türünü gösterir.

CorvusPay payment on hold, authorized: Authorize only seçilidir. Ödemeyi CorvusPay Merchant Center'da tahsil edin, ardından siparişi Payment accepted durumuna getirin.

CorvusPay payment on hold, amount/currency mismatch: ödenen tutar veya para birimi sepetle uyuşmuyor; örneğin sepet başka bir sekmede değiştirildiği için. Ödenen tutar sipariş para biriminde ise ödeme, gerçekte ödenen tutarla kaydedilir. Ödemeyi CorvusPay Merchant Center'da doğrulamadan göndermeyin.

CorvusPay payment on hold, payment after cancel: müşterinin iptal ettiği bir ödeme denemesi için başarılı bir ödeme ulaştı. Siparişi tamamlayın veya ödemeyi CorvusPay Merchant Center'da iade edin.

Zaten siparişi olan bir sepet için farklı ve başka bir başarılı ödeme gelirse sipariş değiştirilmez. Bir not, CorvusPay Merchant Center'ı kontrol etmenizi ve gerekirse mükerrer ödemeyi iade etmenizi ister.

CorvusPay ödeme bloğu

Sipariş sayfasında CorvusPay sipariş numarası, ödeme denemesinin durumu, işlem türü (Sale veya Authorize only), tutar (ve CorvusPay bildirdiyse alınan tutar), onay kodu, işlem ve kart türünü içeren bir CorvusPay payment bloğu gösterilir. Test ödemeleri Test olarak işaretlenir.

İadeler: PrestaShop üzerinden iade, tahsilat ve iptal işlemleri desteklenmez. Bunları CorvusPay Merchant Center'da yapın ve sonucu PrestaShop'a manuel olarak kaydedin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox CorvusPay Gateway lisans bloğu, Modules > Module Manager > VibeFox CorvusPay 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ı maskelenmiş 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: presta-payment-corvuspay satırı ve vibefox.net hesabınızı açan Lisansları ve alan adlarını hesabınızda yönetin 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ı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa 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ızda serbest bırakın.

Etkin bir anahtar olmadan CorvusPay, ödeme sayfasında müşterilere gösterilmez. Yine de bir ödeme başlatılırsa müşteri Bu ödeme yöntemi kullanılamıyor. Lütfen başka birini seçin. mesajını görür. PrestaShop mağaza ön yüzü, back office'e giriş yaptığınızı bilmez; bu yüzden ödeme yöntemi sizin için de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ama ödeme sayfası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, müşteri CorvusPay'den döndüğünde yine onaylanır.

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

Sorun giderme

CorvusPay ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, mevcut modun Store ID ve Secret Key bilgilerinin dolu olduğunu (test modunda Test Store ID ve Test Secret Key, canlı modda Live Store ID ve Live Secret Key) ve sepet para biriminin CorvusPay tarafından desteklendiğini kontrol edin. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşteri grubu için izinli olduğunu kontrol edin.

Ödeme geçti ama sipariş oluşturulmadı: Success URL büyük ihtimalle CorvusPay Merchant Center'a girilmemiştir veya PrestaShop'taki Secret Key mağazayla eşleşmiyordur. Modül sayfasındaki Log alanında INVALID signature arayın (hatalar her zaman kaydedilir). Müşteri geri dönmeden tarayıcıyı kapattıysa da sipariş oluşturulmaz; bu durumda ödemeyi Merchant Center'da kontrol edip siparişi manuel olarak oluşturun.

Müşteri „Ödeme onaylanmadı” mesajını görüyor: Success URL isteği reddedildi: zorunlu alanlar eksikti, CorvusPay sipariş numarası bu mağaza tarafından verilmemişti, o mağazanın Secret Key'i boştu veya imza eşleşmedi. Hiçbir şey değiştirilmez. Günlük nedeni gösterir.

Müşteri uzun süre „Ödemeniz onaylanıyor” mesajını görüyor: sipariş oluşturulamadı; örneğin modül devre dışıydı veya sepet artık geçerli değil. Günlük nedeni gösterir; ödemeyi Merchant Center'da kontrol edin.

Müşteri „Bu sipariş toplamı CorvusPay ile ödenemez” mesajını görüyor: toplam sıfır veya 2'den fazla ondalık basamağa sahip.

Müşteri „CorvusPay yapılandırılmamış” veya „CorvusPay … para biriminde ödeme kabul etmiyor” mesajını görüyor: mevcut modun Store ID veya Secret Key bilgisi eksik ya da sepet para birimi desteklenmiyor.

Sipariş CorvusPay payment on hold durumunda: siparişin özel notlarını okuyun. Authorize only seçili, ödenen tutar veya para birimi sepetle uyuşmadı, ödeme müşteri iptal ettikten sonra geldi veya Order Status After Payment beklemeye alınmış olarak ayarlı.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox CorvusPay 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 dosyaları silinir. Kapalıysa, sonradan yeniden kurmak için tüm ayarlar korunur. CorvusPay işlem verileri ve CorvusPay payment on hold sipariş durumu her zaman korunur; bu yüzden yeniden kurulumdan sonra eski siparişlerdeki CorvusPay bloğu geri gelir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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