VibeFox MakeCommerce 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.

Mağazanıza internet erişimi: MakeCommerce ödeme bildirimlerini mağazanıza gönderir, bu nedenle sitenin internetten erişilebilir olması gerekir. Bir güvenlik duvarı veya temel kimlik doğrulama bunları engelleyebilir. Mağazanızın bakım modu ve ülke kısıtlaması bu bildirimleri engellemez.

MakeCommerce hesabı: MakeCommerce Merchant Portal'daki (Settings > API) Shop ID ve Secret key bilgilerine ihtiyacınız vardır. Test ve canlı ortamların hesapları ve anahtarları ayrıdır. Hangi ödeme yöntemlerinin ve para birimlerinin kullanılabileceği MakeCommerce sözleşmenizle belirlenir. KWD veya BHD gibi üç ondalık basamaklı para birimleri sunulmaz.

VibeFox lisans anahtarı: vibefox.net üzerinden 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 MakeCommerce 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ı girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Test ortamının Shop ID ve Secret key bilgilerini ve gerçek ödemeler için canlı anahtarları girin (bkz. Yapılandırma). Merchant Portal'da bir şey ayarlamanız gerekmez.

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Test mode açıkken bir ödeme deneyin, ardından gerçek ödemeleri kabul etmek için kapatın.

Kurulumda modül MakeCommerce payment on hold sipariş durumunu oluşturur. PrestaShop, yeni ödeme modülünü tüm para birimleri, ülkeler ve müşteri grupları için 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 MakeCommerce 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, test modu açıkken sayfa Test mode is on: payments are created in the MakeCommerce test environment and no real money is charged. uyarısını gösterir. Yöntem etkinleştirilmiş ancak geçerli ortamın Shop ID veya Secret key bilgisi boşsa ya da mağazanızın varsayılan para birimi MakeCommerce tarafından tahsil edilemiyorsa sizi uyarır. Her iki durumda da yöntem ödeme sayfasında gizlenir. Kaydederken anahtarlardaki boşluklar silinir.

MakeCommerce

Enable/Disable: Enable MakeCommerce payments ö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: Bank link or card (MakeCommerce). Zorunlu.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay with your Estonian, Latvian, Lithuanian or Finnish bank, or by card. You will be redirected to the secure MakeCommerce payment page.

MakeCommerce hesabı

Shop ID ve Secret key, MakeCommerce Merchant Portal'da Settings > API altındadır. Test portalı ve canlı portal ayrı hesaplara ve anahtarlara sahiptir. Bu bölümde her iki portala ve MakeCommerce kayıt sayfasına bağlantılar bulunur.

Test mode: MakeCommerce test ortamını kullanır (gerçek para tahsil edilmez). Yeni ödemeler, seçili ortamda o ortamın anahtarlarıyla oluşturulur. Her sipariş ödendiği ortamı hatırlar: durum kontrolleri ve iadeler her zaman oraya gönderilir. Açıkken müşteriler ödeme yönteminin altında TEST MODE — MakeCommerce test environment, no real money is charged. ifadesini görür. Varsayılan: açık.

Test Shop ID: test hesabınızın Shop ID bilgisi; xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx biçimindedir.

Test Secret key: test hesabınızın Secret key bilgisi.

Live Shop ID: canlı hesabınızın Shop ID bilgisi.

Live Secret key: canlı hesabınızın Secret key bilgisi.

Kayıtlı gizli anahtarlar 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 secret keys: bir anahtarı işaretleyip Save düğmesine tıklayarak kaldırın. Boş bir alan kayıtlı değeri korur.

Ödeme bildirimleri

Merchant Portal'da bir şey ayarlamanız gerekmez. Callback URLs, yalnızca bilgi amacıyla müşterinin dönüş veya iptal adresini ve ödeme bildirimleri adresini gösterir. Her işlem, bu adreslere sepet numarası ve eklenen bir anahtar eklenerek oluşturulan kendi geri dönüş, iptal ve bildirim URL'lerini taşır. MakeCommerce, imzalı bir mesajı bildirim URL'sine (sunucudan sunucuya) ve müşterinin tarayıcısı üzerinden dönüş veya iptal URL'sine gönderir. İmza, işlemin oluşturulduğu ortamın Secret key bilgisiyle kontrol edilir. Geçerli imzası olmayan mesajlar reddedilir.

Modül şu MakeCommerce işlem durumlarını işler:

Ödeme, müşteri mağazaya döndüğünde de onaylanır. Müşteri imzalı bir mesaj olmadan dönerse modül durumu MakeCommerce API'sinden sorgular.

Gelişmiş

Debug log: API çağrılarını ve ödeme bildirimlerini modül klasöründeki logs/wc_mkc_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Hatalar her zaman kaydedilir. Anahtarlar ve müşteri verileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

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

Delete data: açıkken modül kaldırıldığında modül ayarları ve günlük silinir. Siparişler ve MakeCommerce ödeme verileri her zaman korunur. Varsayılan: kapalı.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini (varsayılan olarak Bank link or card (MakeCommerce)) seçer ve onaylar. Modül, sepet tutarı için sepetin para biriminde bir MakeCommerce işlemi oluşturur ve müşteriyi MakeCommerce ödeme sayfasına yönlendirir. Orada müşteri bir banka bağlantısı veya kart seçer. Müşterinin e-posta adresi ve ülkesi MakeCommerce'e iletilir; sayfa, MakeCommerce destekliyorsa mağaza dilinde (Estonca, İngilizce, Letonca, Litvanca, Fince, Rusça, Almanca, Lehçe), desteklemiyorsa İngilizce açılır. Bu noktada henüz bir sipariş yoktur.

Ödemeden sonra müşteri mağazanıza döner. Sipariş yalnızca MakeCommerce onayladıktan sonra ödendi olarak işaretlenir: imzalı bildirim veya müşterinin imzalı geri dönüşü ile, işlemin MakeCommerce API üzerinden kontrol edilmesiyle. Sipariş ardından oluşturulur ve müşteri Your MakeCommerce payment has been received. ifadesini içeren standart sipariş onay sayfasını görür. Sipariş inceleme için beklemeye alındıysa sayfa Your MakeCommerce payment was received and is being reviewed by the shop. mesajını gösterir.

Ödeme onaylanmış ama henüz tamamlanmamışsa veya MakeCommerce'e ulaşılamıyorsa, Payment confirmation sayfası We could not confirm your payment yet. If you completed it, your order will be updated automatically — please do not pay again. mesajını ve Check again ile Back to checkout düğmelerini gösterir. Bildirim, ödeme tamamlanır tamamlanmaz siparişi oluşturur.

Müşteri MakeCommerce sayfasında iptal ederse veya ödeme süresi dolar ya da başarısız olursa, müşteri ödeme sayfasına bir mesajla geri döner; örneğin The payment was cancelled. You can try again or choose another payment method., The payment session expired. Please try again. veya The payment was not completed. Please try again or choose another payment method. Sepet korunur ve müşteri yeniden ödeme yapabilir. Her deneme yeni bir MakeCommerce işlemidir. Aynı sepetin daha eski bir ödeme bağlantısı hâlâ çalışır ve sepet iki siparişte iki kez ödenemez.

MakeCommerce ödemeyi başlatamazsa müşteri ödeme sayfasında kalır ve MakeCommerce is temporarily unavailable. Please try again in a moment or choose another payment method. ya da MakeCommerce could not start the payment for this order. Please choose another payment method or contact us. mesajını görür. Teknik neden günlüğe yazılır.

Banka veya kart, ödeme sayfanızda değil MakeCommerce sayfasında seçilir. Modülde kayıtlı kartlar, yinelenen ödemeler veya abonelikler ile MakeCommerce kargo hizmetleri (paket otomatları, etiketler) bulunmaz.

Siparişler ve iadeler

Sipariş durumları

No order yet: müşteri MakeCommerce'e yönlendirildi ve henüz ödeme yapmadı ya da MakeCommerce ödemeyi henüz onaylamadı. Yalnızca sepet vardır.

Payment accepted: ödeme onaylandı. Ödeme, MakeCommerce işlem kimliğiyle kaydedilir ve bir not tutarı, işlemi, ortamı ve doğrulama şeklini (MakeCommerce API veya imzalı bildirim) gösterir.

MakeCommerce payment on hold: ödenen tutar veya para birimi sepetten farklıydı (örneğin ödeme başladıktan sonra sepet değiştirildi), tutar eksikti, MakeCommerce'teki işlem tamamlandı olarak bildirilmesine rağmen henüz kesinleşmemişti veya ödeme, sipariş iptal edildikten sonra geldi. Not bunu açıklar. Ödenen para birimi sipariş para birimiyse, siparişe gerçekten ödenen tutar kaydedilir. Uyuşmazlık içeren bir işlem siparişi sonradan asla ödemez; henüz kesinleşmemiş bir işlem, MakeCommerce tamamlandı olarak bildirdiğinde siparişi tamamlar. Merchant Portal'da işlemi kontrol edin, ardından siparişi yerine getirin veya ödemeyi iade edin.

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

Zaten ödenmiş bir sipariş için ikinci bir ödeme gelirse sipariş değişmez. Bir not, mükerrer ödemeyi MakeCommerce Merchant Portal'da iade etmenizi ister.

MakeCommerce ödeme bloğu

Sipariş sayfasında, sepetin tüm MakeCommerce işlemlerini (tarih, işlem kimliği, test ödemeleri için Test rozeti, tutar, MakeCommerce durumu ve sonucu), ödenen ve iade edilen tutarları, iade geçmişini ve siparişin MakeCommerce notes bölümünü içeren bir MakeCommerce payment bloğu gösterilir. Bloğun düğmeleri yalnızca siparişleri düzenleme iznini gerektirir, modüllere erişimi değil.

Check MakeCommerce payment status: sepetin işlemlerinin durumunu (en yenisi önce) MakeCommerce API'sinden sorgular, uygular ve sonucu içeren bir not ekler. Müşteri ödediğini ama siparişin tamamlanmadığını söylediğinde kullanın.

İadeler

MakeCommerce payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via MakeCommerce düğmesine tıklayın. Refund this amount via MakeCommerce? sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. İadeler, MakeCommerce işleminin tutarı ve para birimiyle sınırlıdır; bu nedenle tutar uyuşmazlığından sonra sipariş toplamına değil, müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı ortama (test veya canlı) gönderilir; bu nedenle o ortamın anahtarları ayarlanmış olmalıdır. Neden, iade açıklaması olarak MakeCommerce'e gönderilir; neden girilmezse açıklama Refund for order ve sipariş referansı olur. MakeCommerce iadeyi kabul etmezse blok hatayı gösterir, bir not eklenir ve hiçbir iade kaydedilmez. MakeCommerce ödemeyi hâlâ işliyorsa mesaj MakeCommerce is still processing this payment — try the refund again later. olur. Başarılı bir iade, MakeCommerce iade kimliğiyle birlikte iade geçmişine ve notlara eklenir. Tam iade siparişi Refunded durumuna alır. Kısmi iade durumu değiştirmez. İadeler, MakeCommerce ödemeyi onayladıktan sonra kullanılabilir.

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

Merchant Portal'da yapılan iadeler, işlem durumuyla birlikte gelir ve notlara eklenir. Sipariş durumu ve kredi notları otomatik olarak değişmez.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox MakeCommerce Payment lisans bloğu, Modules > Module Manager > VibeFox MakeCommerce 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 son 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-makecommerce 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 izni olan çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli 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 License expired on ve bir tarih. 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 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 MakeCommerce ö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 sizin için de gizlenir: modülü bir 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 ve iadeler çalışır.

Bir lisans sona erdiğinde 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 lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

MakeCommerce ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve geçerli ortamın anahtarlarının bulunduğunu kontrol edin: test modunda Test Shop ID ve Test Secret key, canlı modda Live Shop ID ve Live Secret key. Sepet para biriminin en fazla iki ondalık basamağı olduğunu kontrol edin. 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 tamamlandı ama sipariş oluşturulmadı: bildirimler mağazaya ulaşamadı; örneğin bir güvenlik duvarı veya temel kimlik doğrulama nedeniyle. Müşteri mağazaya döndüğünde ya da Check again düğmesine tıkladığında da sipariş oluşturulur. Ödemenin yapıldığı ortamın anahtarlarının ayarlı olduğunu kontrol edin: bildirim o ortamın Secret key bilgisiyle doğrulanır ve bu bilgi olmadan MakeCommerce hata alır ve yeniden dener. Bildirimleri görmek için Debug log seçeneğini açın.

Sipariş MakeCommerce payment on hold durumunda: sipariş sayfasındaki bloktaki MakeCommerce notes bölümünü okuyun (bkz. Sipariş durumları), işlemi Merchant Portal'da kontrol edin, ardından siparişi yerine getirin veya ödemeyi iade edin.

Bildirimler reddediliyor: yanlış imzalı, başka bir sepete, başka bir mağazaya ait olan veya sepet için oluşturulmamış bir işlemin mesajı reddedilir ve hiçbir şey değiştirilmez. Shop ID ve Secret key bilgilerinin aynı MakeCommerce hesabına ve ortama ait olduğunu kontrol edin.

Müşteri MakeCommerce seçerken hata görüyor: Debug log seçeneğini açın ve modül sayfasındaki Log alanına bakın. MakeCommerce'in tahsil edemediği bir para birimi MakeCommerce cannot process payments in ifadesini ve para birimi kodunu gösterir.

İade ortamla ilgili bir mesajla başarısız oluyor: sipariş test veya canlı ortamda ödendi ve o ortamın anahtarları yapılandırılmamış. Anahtarları girin ve yeniden deneyin.

İade No MakeCommerce transaction ID found for this order mesajıyla başarısız oluyor: siparişin onaylanmış bir MakeCommerce ödemesi yok. Merchant Portal'da iade edin.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox MakeCommerce 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. MakeCommerce işlemleri ve iadeleri ile MakeCommerce payment on hold sipariş durumu her zaman korunur; bu sayede daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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