VibeFox MakeCommerce for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. WooCommerce olmadan eklenti etkinleşmeyi reddeder.

PHP: 8.0 veya üzeri.

Sitenize internet erişimi: MakeCommerce mağazanıza ödeme bildirimleri gönderir, bu nedenle sitenin internetten erişilebilir olması gerekir (HTTPS önerilir). Güvenlik duvarı, bakım modu veya temel kimlik doğrulama bunları engelleyebilir.

MakeCommerce hesabı: MakeCommerce Merchant Portal'dan (Settings > API) temin edilecek Shop ID ve Secret key bilgilerine ihtiyacınız vardır. Test ve canlı ortamların ayrı hesapları ve anahtarları bulunur. Hangi ödeme yöntemlerinin ve para birimlerinin sunulacağı MakeCommerce sözleşmenizle belirlenir (banka bağlantıları EUR cinsindendir). KWD veya BHD gibi üç ondalıklı para birimleri sunulmaz.

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

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin bölümüne gidin, eklenti ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_makecommerce_payment klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Payments > MakeCommerce > Manage yolunu izleyin veya Eklentiler sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üst kısmındaki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. 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 herhangi bir ayar yapılması gerekmez.

6. Enable/Disable seçeneğini açın. Test mode etkinken bir ödemeyi test edin, ardından gerçek ödemeleri kabul etmek için işareti kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > MakeCommerce. Test modu açıkken sayfa, alanların üzerinde 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ştirildiğinde ancak geçerli ortamın Shop ID veya Secret key alanı boş olduğunda ya da mağaza para birimi MakeCommerce tarafından tahsil edilemediğinde sizi uyarır. Her iki durumda da yöntem ödeme sayfasında gizlenir. Ödeme yöntemleri listesinde MakeCommerce, geçerli ortamın anahtarları girilene kadar kurulum gerektiriyor olarak işaretlenir. Kaydetme sırasında anahtarlardaki boşluklar temizlenir.

General

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ı. Varsayılan: Bank link or card (MakeCommerce).

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 account

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

Test mode: Use the MakeCommerce test environment (no real money is charged). Yeni ödemeler, seçilen ortamda ortamın anahtarlarıyla oluşturulur. Her sipariş ödendiği ortamı hatırlar: durum kontrolleri ve iadeler her zaman oraya gider. Ödeme sayfasında TEST MODE — MakeCommerce test environment, no real money is charged. satırı gösterilir. 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.

Payment notifications

Merchant Portal'da herhangi bir ayar yapılması gerekmez. Her işlem, sipariş numarası ve sipariş anahtarı eklenerek bu bölümde gösterilen adrese (şuna benzer: https://your-site/wc-api/wc_mkc_payment/) dayalı kendi geri dönüş, iptal ve bildirim URL'lerini taşır. MakeCommerce, bildirim URL'sine (sunucudan sunucuya) ve müşterinin tarayıcısı aracılığıyla geri dönüş veya iptal URL'sine imzalı bir mesaj gönderir. İmza, işlemin oluşturulduğu ortamın Secret key bilgisi ile kontrol edilir. Geçerli bir imzası olmayan mesajlar reddedilir.

Eklenti şu MakeCommerce işlem durumlarını işler:

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

Advanced

Debug log: Log API calls and payment notifications ayrıntıları WooCommerce > Status > Logs altına yazar, kaynak: wcp_makecommerce_payment. Hatalar her zaman günlüğe kaydedilir. Anahtarlar ve müşteri verileri asla günlüğe kaydedilmez. Varsayılan: kapalı.

Delete data: Delete the gateway settings and logs when the plugin is deleted. Siparişler ve ödeme notları her zaman korunur. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Varsayılan: kapalı.

Ödeme adımı

Müşteri ödeme yöntemini seçer (varsayılan olarak Bank link or card (MakeCommerce)) ve siparişi verir. Eklenti, sipariş para biriminde sipariş toplamı için bir MakeCommerce işlemi oluşturur ve müşteriyi MakeCommerce ödeme sayfasına yönlendirir. Müşteri orada bir banka bağlantısı veya kart seçer. Fatura e-postası ve ülke MakeCommerce'e iletilir ve sayfa MakeCommerce'in desteklediği durumlarda mağaza dilinde (Estonca, İngilizce, Letonca, Litvanca, Fince, Rusça, Almanca, Lehçe), aksi takdirde İngilizce açılır.

Ödeme yapıldıktan sonra müşteri mağazanızın sipariş alındı sayfasına döner. Sipariş, yalnızca MakeCommerce ödemeyi onayladıktan sonra ödendi olarak işaretlenir: imzalı bildirimle veya müşterinin imzalı geri dönüşüyle, işlemin MakeCommerce API'si üzerinden doğrulanmasıyla.

Müşteri MakeCommerce sayfasında işlemi iptal ederse veya ödeme süresi dolarsa müşteri bir mesajla ödeme sayfasına (veya Pay for order sayfasına) geri döner; örneğin The payment was cancelled. You can try again or choose another payment method. veya The payment session expired. Please try again. Ödeme henüz doğrulanamıyorsa mesaj şöyledir: We could not confirm your payment yet. If you completed it, your order will be updated automatically; otherwise please try again. Müşteri yeniden ödeme yapabilir. Aynı siparişin daha eski bir ödeme bağlantısı hâlâ çalışır ve sipariş iki kez ödenemez.

MakeCommerce ödemeyi başlatamazsa müşteri MakeCommerce is temporarily unavailable. Please try again in a moment or choose another payment method. veya MakeCommerce could not start the payment for this order. Please choose another payment method or contact us. mesajını görür. Teknik neden sipariş notlarına ve günlüğe eklenir.

Ödeme yöntemi klasik ödeme sayfasında, Ödeme bloğunda ve Pay for order sayfasında çalışır. WooCommerce Yüksek Performanslı Sipariş Depolama (HPOS) ile uyumludur.

Banka veya kart, mağazanızın ödeme sayfasında değil MakeCommerce sayfasında seçilir. Eklentide kayıtlı kartlar, yinelenen ödemeler veya WooCommerce Subscriptions ile MakeCommerce kargo hizmetleri (paket otomatları, etiketler) bulunmaz.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri MakeCommerce'e yönlendirildi ve henüz ödeme yapmadı ya da MakeCommerce ödemeyi henüz onaylamadı. Sipariş notunda MakeCommerce işlemi, tutar ve ortam gösterilir.

Processing: ödeme onaylandı. Yalnızca sanal indirilebilir ürünler içeren siparişler WooCommerce varsayılanı olan Tamamlandı durumuna geçer. Sipariş notunda tutar, işlem, ortam ve nasıl doğrulandığı (MakeCommerce API'si veya imzalı bildirim) gösterilir. İşlem kimliği MakeCommerce işlem kimliğidir.

On hold: ödenen tutar veya para birimi siparişten farklıydı, tutar eksikti, MakeCommerce'teki işlem durumu henüz kesinleşmemişti veya iptal edilmiş bir sipariş için ödeme ulaştı. Sipariş notu bunu açıklar. Böyle bir işlem siparişi daha sonra asla ödenmiş yapmaz. İşlemi Merchant Portal'da kontrol edin ve siparişi manuel olarak tamamlayın veya iade edin.

Failed: siparişin son ödemesi iptal edildi, süresi doldu veya başarısız oldu. Müşteri tekrar ödeme yapabilir.

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

Check MakeCommerce payment status

Sipariş ekranında, sipariş eylemlerinde Check MakeCommerce payment status seçeneğini belirleyin. Eklenti, siparişin işlemlerinin durumunu (önce en yenisi) MakeCommerce API'sine sorar, uygular ve sonucu içeren bir not ekler. Müşteri ödeme yaptığı halde sipariş Ödeme bekleniyor durumunda kaldığında bunu kullanın.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Bank link or card (MakeCommerce) düğmesine tıklayın (düğmede Title bilginiz görünür). Tam ve kısmi iadeler desteklenir. İade, siparişin ödendiği ortama (test veya canlı) gönderilir; bu nedenle o ortamın anahtarları ayarlanmış olmalıdır. MakeCommerce iadeyi kabul etmezse WooCommerce hatayı gösterir, bir not eklenir ve hiçbir iade kaydedilmez. MakeCommerce ödemeyi hâlâ işliyorsa mesaj şöyledir: MakeCommerce is still processing this payment — try the refund again later. Başarılı bir iade, MakeCommerce iade kimliğiyle sipariş notlarına eklenir.

Merchant Portal'da yapılan iadeler işlem durumuyla birlikte gelir ve sipariş notlarına eklenir. Otomatik olarak WooCommerce iadesi şeklinde kaydedilmezler.

Lisans anahtarı

Eklenti, vibefox.net adresinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > MakeCommerce sayfasının üst kısmındadır. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu, örneğin lisansın geçerli olduğu tarihi ve alan adınızı gösterir. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve bu siteden kaldırmak için Remove key seçeneklerini kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar bir alan adında çalışır. Anahtarı bir siteden kaldırmak alan adı yuvasını boşa çıkarmaz. Yuva alanını vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan MakeCommerce ödeme adımı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. uyarısını görür. Giriş yapmış mağaza yöneticileri, anahtar satın almadan önce eklentiyi kurup test edebilmeniz için ödeme yöntemini (unlicensed — visible to admins only) şeklinde işaretlenmiş olarak görmeye devam eder. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatıcı görünür. Mevcut siparişler etkilenmez: Başlatılmış ödemeler onaylanmaya devam eder ve iadeler çalışır.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak tekrar kontrol edilir.

Sorun giderme

MakeCommerce ödeme adımında görünmüyor: lisansın etkin olduğunu, Enable/Disable ayarının açık olduğunu ve geçerli ortamın anahtarlarına sahip olduğunu kontrol edin: test modunda Test Shop ID ve Test Secret key, canlı modda Live Shop ID ve Live Secret key. Mağaza para biriminin (veya Pay for order sayfasındaki sipariş para biriminin) en fazla iki ondalık basamağa sahip olduğunu kontrol edin. Ayarlar sayfası bu sorunların her biri için bir uyarı gösterir.

Ödeme yapıldı ancak sipariş Ödeme bekleniyor durumunda kalıyor: güvenlik duvarı, bakım modu veya temel kimlik doğrulama gibi nedenlerle bildirimler siteye ulaşamadı. Siparişi açın ve Check MakeCommerce payment status sipariş eylemini çalıştırın. Ödemenin yapıldığı ortamın anahtarlarının tanımlı olduğunu kontrol edin: bildirim o ortamın Secret key bilgisiyle kontrol edilir; bu anahtar olmadan MakeCommerce hata alır ve yeniden dener.

Sipariş MakeCommerce notuyla Beklemede durumunda: ödeme siparişle eşleşmedi (tutar, para birimi, durum) ya da iptal edilmiş bir sipariş için ulaştı. İşlemi Merchant Portal'da kontrol edin ve siparişi manuel olarak tamamlayın veya iade edin.

Bildirimler reddediliyor: geçersiz imzaya sahip, başka bir siparişe veya mağazaya ait ya da sipariş için oluşturulmamış bir işleme ilişkin mesajlar reddedilir ve sipariş değiştirilmez. Shop ID ve Secret key bilgilerinin aynı MakeCommerce hesabına ve ortamına ait olduğunu kontrol edin.

Müşteri sipariş verirken hata görüyor: sipariş notlarını açın veya Debug log seçeneğini etkinleştirip WooCommerce > Status > Logs altındaki wcp_makecommerce_payment kaynağını inceleyin. MakeCommerce'in tahsil edemediği bir para birimi MakeCommerce cannot process payments in ve ardından para birimi kodunu döndürür.

İ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 tekrar deneyin.

İade No MakeCommerce transaction ID found for this order mesajıyla başarısız oluyor: siparişte MakeCommerce işlemi bulunmuyor. İadeyi Merchant Portal'da gerçekleştirin.

Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar zaten başka bir alan adında kullanılıyorsa vibefox.net hesabınızdan bir yuva alanını serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti bilinen son durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Eklentiyi kaldırmak için Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları ve günlükler yalnızca Delete data etkinse kaldırılır. Aksi takdirde daha sonraki bir yeniden kurulum için kalırlar. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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