VibeFox Quickpay for WooCommerce — Yardım

Gereksinimler

WordPress: 6.2 veya üzeri.

WooCommerce: 7.1 veya üzeri, kurulu ve etkin. Eklenti, WooCommerce olmadan etkinleştirilemez.

PHP: 8.0 veya üzeri.

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

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, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. wcp_quickpay_gateway klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Payments > Quickpay > Manage ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

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

5. 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).

6. Tahsilat modunu ve ödeme sonrası sipariş durumunu seçin, Enable/Disable seçeneğini açın ve kaydedin. Quickpay hesabınız test modundayken Test payments seçeneğini açın ve bir Quickpay test kartıyla ödeme yapın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Quickpay. Hem API anahtarı hem de özel anahtar girilene kadar Quickpay, ödeme yöntemleri listesinde kurulum gerektiren olarak işaretlenir ve ödeme sayfasında gizlenir; çünkü bir ödeme ne oluşturulabilir ne de onaylanabilir.

Genel

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ı. Varsayılan: Quickpay.

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. Bölümde ayrıca mağazanızın geri çağırma URL'si de gösterilir; bu, https://your-site/wc-api/qpg_quickpay/ biçiminde görünür. Her ödemeyle birlikte otomatik olarak gönderilir, bu nedenle 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.

Alanın altındaki Test API key düğmesi, alana yazılan anahtarı (alan boşsa kayıtlı olanı) Quickpay'e kimliği doğrulanmış bir istekle kontrol eder. Yanıt olarak Connection successful — the API key is valid., Quickpay rejected the API key., API key is not configured. veya Connection failed: ve ardından nedeni gösterir.

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.

Test payments: Accept payments made with Quickpay test cards. 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 yaparken açın. Kapalıyken bir test ödemesi hiçbir zaman siparişi ödenmiş olarak işaretlemez; bunun yerine siparişe bir not eklenir. Açıkken ödeme sayfasında Test mode: Quickpay test cards are accepted. gösterilir. Varsayılan: kapalı.

Ödeme

Capture: paranın karttan çekildiği an.

Order status after payment: Quickpay tahsil edilen ödemeyi onayladıktan sonraki sipariş durumu. Durum hemen, tek bir durum değişikliği ve tek bir e-posta grubuyla ayarlanır.

Gelişmiş

Debug log: Enable logging. Günlük, WooCommerce > Status > Logs bölümünde, kaynak wcp_quickpay_gateway olarak bulunur. Reddedilen geri çağırmalar ve Quickpay API hataları gibi hatalar ve uyarılar her zaman kaydedilir. Her isteği ve geri çağırmayı da kaydetmek için bunu açın. API anahtarları, kart verileri ve müşteri bilgileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

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

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak Quickpay, Visa ve Mastercard simgeleriyle gösterilir) ve siparişi verir. Eklenti, sipariş için sipariş para biriminde bir Quickpay ödemesi ve sipariş tutarı için bir ödeme bağlantısı oluşturur ve müşteriyi Quickpay ödeme penceresine yönlendirir. Müşteri orada, Quickpay ödeme penceresinizde etkin olan yöntemlerden biriyle öder. Fatura e-postası Quickpay'e iletilir. Ödeme penceresi, Quickpay destekliyorsa sitenizin 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.

Ödemeden sonra müşteri mağazanızın sipariş alındı sayfasına döner. Dönüş işlemi tek başına hiçbir şeyi ödenmiş olarak işaretlemez. Sipariş, yalnızca Quickpay imzalı geri çağırma ile onayladığında ve tutar ile para birimi siparişle eşleştiğinde ödenmiş olarak işaretlenir. Authorize only seçiliyken sipariş bunun yerine Beklemede durumuna geçer ve ödemeyi daha sonra tahsil edersiniz.

Müşteri ödeme sırasında ödeme penceresinde iptal ederse, ödenmemiş sipariş WooCommerce'in standart yöntemiyle iptal edilir ve sepet geri yüklenir. Pay for order sayfasında iptal, müşteriyi o sayfaya geri döndürür; böylece sipariş ödenebilir kalır. Başarısız ya da iptal edilmiş bir ödeme yeniden denenebilir: Yeni deneme, siparişin mevcut Quickpay ödemesini yeni bir bağlantıyla yeniden kullanır; bu yüzden eski bir bağlantı hiçbir zaman paralel olarak ödenemez. Ödenmemiş bir sipariş iptal edildiğinde, ödeme bağlantısı Quickpay'de silinir.

Ödeme başlatılamazsa müşteri The Quickpay payment could not be started. Please try again or choose another payment method. mesajını görür. Teknik neden sipariş notlarına ve günlüğe eklenir. Anahtarlar eksikse müşteri Quickpay is not available at the moment. Please choose another payment method. mesajını görür.

Ödeme yöntemi klasik ödeme sayfasında, Ödeme bloğunda ve Pay for order sayfasında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklenti yalnızca tek seferlik ödemeleri kabul eder. Abonelik veya yinelenen ödeme yoktur, kayıtlı kart yoktur, ödeme ücreti yoktur, Quickpay'e sepet veya fatura satırı gönderilmez ve ayrı MobilePay, Apple Pay veya Klarna yöntemleri yoktur: Müşteri, Quickpay ödeme penceresinizin yöntemleri arasından seçim yapar.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri Quickpay'e yönlendirildi ve henüz ödeme yapmadı. Otomatik tahsilatta, tahsilat bekleyen yetkilendirilmiş bir ödeme siparişte not edilir.

Processing or Completed: Quickpay, tahsil edilen ödemeyi doğru tutar ve para birimiyle onayladı. Durum, Order status after payment ayarını izler. Sipariş notunda Quickpay ödeme kimliği gösterilir (test ödemeleri için TEST olarak işaretlenir) ve siparişin işlem kimliği olarak kaydedilir.

On hold: ödeme yalnızca yetkilendirilmiştir ve Capture Quickpay payment işlemini bekler; ya da Quickpay, sipariş toplamından farklı bir tutar veya para birimi bildirmiştir (örneğin ödeme başladıktan sonra sipariş düzenlendiyse ya da Quickpay yönetim panelinde farklı bir tutar tahsil edildiyse); ya da tahsilat başarısız olmuş ve tutar hâlâ yalnızca ayrılmıştır. Sipariş notu bunu açıklar; sipariş zaten Beklemede durumundaysa da öyledir.

Failed: ödeme denemesi reddedildi. Müşteri yeniden ödeme yapabilir.

Cancelled: müşteri ödeme penceresinde iptal etti, sipariş sizin tarafınızdan ya da WooCommerce stok tutma zaman aşımı nedeniyle iptal edildi ya da ödeme Quickpay yönetim panelinde iptal edildi.

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

Tahsilat

Authorize only ile siparişi açın, sipariş işlemleri arasından Capture Quickpay payment seçeneğini seçin ve güncelleme düğmesine tıklayın. Sipariş toplamı tahsil edilir; kısmi tahsilat kullanılamaz. Quickpay hemen onaylarsa sipariş ödenmiş olarak işaretlenir. Aksi halde bir not tahsilatın istendiğini belirtir ve Quickpay geri çağırması onaylayınca sipariş ödenmiş olarak işaretlenir. Reddedilen bir tahsilat sipariş ekranında gösterilir ve siparişe not olarak eklenir.

Yetkilendirilmiş bir siparişi iptal etmek, ayrılan tutarı otomatik olarak serbest bırakmaz. Sipariş notu, ödemeyi Quickpay yönetim panelinde iptal etmenizi hatırlatır; aksi halde rezervasyon, yetkilendirme süresi dolduğunda sona erer.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Quickpay düğmesine tıklayın. Tahsil edilmiş ödemeler için tam ve kısmi iadeler desteklenir. Quickpay iadeleri eşzamansız işler: bir not iadenin istendiğini belirtir ve geri çağırma nihai sonucu ekler: confirmed (onaylandı) ya da nedeni belirtilmiş FAILED. Quickpay iadeyi hemen reddederse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Hiç tahsil edilmemiş bir yetkilendirilmiş ödeme iade edilemez; bunun yerine Quickpay yönetim panelinde iptal edin.

Doğrudan Quickpay yönetim panelinde yapılan ödemeler ve iadeler yalnızca siparişe not edilir. Otomatik olarak WooCommerce iadesi olarak kaydedilmezler. Gerekirse WooCommerce'te Refund via Quickpay olmadan manuel bir iade oluşturun.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu, WooCommerce > Settings > Payments > Quickpay sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok, durumu gösterir; örneğin lisansın hangi tarihe kadar etkin olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key düğmesini 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, o alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan 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. Oturum açmış mağaza yöneticileri ödeme yöntemini hâlâ görür; yöntem (unlicensed — visible to admins only) olarak işaretlenir, böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: Zaten başlatılmış ödemeler yine onaylanır ve tahsilat ile 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 yeniden kontrol edilir.

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 alanlarının girildiğini kontrol edin. İki anahtar da girilmeden yöntem gizlenir.

Ödeme geçti, ancak sipariş Pending payment durumunda kalıyor: Quickpay geri çağırması mağazanıza ulaşmadı ya da reddedildi. Sitenizin internetten erişilebilir olduğunu (parola koruması ya da bakım modu olmadan) ve Private key alanının aynı Quickpay hesabının özel anahtarı olduğunu kontrol edin. Reddedilen geri çağırmalar her zaman WooCommerce > Status > Logs bölümünde, kaynak wcp_quickpay_gateway olarak yazılır. Her geri çağırmayı görmek için Debug log seçeneğini açın.

Günlükte Callback rejected: invalid checksum. yazıyor: 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ükte Callback rejected: the private key is not configured. yazıyor: özel anahtarı girin. Geri çağırmalar, özel anahtar olmadan asla kabul edilmez.

Günlükte Callback: no order found for payment … yazıyor: geri çağırma, bu mağazanın hiçbir siparişinin bilmediği bir Quickpay ödemesine ait; örneğin WooCommerce dışında ya da silinmiş bir sipariş için oluşturulmuş bir ödeme.

Günlükte Callback: order #… is locked by another request. yazıyor: aynı siparişe ait başka bir geri çağırma o anda uygulanıyordu. Geri çağırmaya hata yanıtı verilir, bu yüzden işlenmiş sayılmaz. Sipariş değişmeden kalıyorsa ödemeyi Quickpay yönetim panelinde kontrol edin.

Bir test ödemesi siparişi ödenmiş olarak işaretlemedi: Test payments kapalı. Sipariş notu, test ödemesinin kabul edilmediğini söyler. Testler sırasında ayarı açın, hesabınız canlıya geçtiğinde kapatın.

Ödemeden sonra sipariş On hold durumda: sipariş notunu okuyun. Ödeme yalnızca yetkilendirilmiş olabilir ve Capture Quickpay payment işlemini bekliyor olabilir; ödenen tutar ya da para birimi siparişten farklı olabilir ya da tahsilat başarısız olmuş olabilir. Quickpay yönetim panelinde tahsil edin, siparişi tamamlayın veya ödemeyi iade edin.

Test API key, Quickpay rejected the API key. yazıyor: 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 The Quickpay payment could not be started. mesajını görüyor: sipariş notlarını ya da günlüğü açın. Not, 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şte tahsil edilmiş bir Quickpay ödemesi olmalıdır. The Quickpay payment of this order has not been captured — there is nothing to refund. mesajı, ödemenin yalnızca yetkilendirildiği anlamına gelir; bunun yerine Quickpay yönetim panelinde iptal edin.

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

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. 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ı ile eklentinin günlükleri (döndürülmüş olanlar dahil günlük dosyaları ve veritabanı günlük kayıtları) yalnızca Delete data açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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