VibeFox Culqi for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 6.0 veya üzeri, kurulu ve etkin. Eklenti, WooCommerce olmadan etkinleştirilmeyi reddeder.

PHP: 8.0 veya üzeri.

Mağaza para birimi: Peru Solu (PEN) veya ABD Doları (USD). Culqi başka para birimlerini kabul etmez ve mağaza para birimi farklıysa ödeme yöntemi ödeme sayfasında gizlenir.

Culqi hesabı: Culqi hesabınızın genel anahtarına ve gizli anahtarına ihtiyacınız vardır. Entegrasyon (test) anahtarları integ-panel.culqi.com adresinden, üretim (canlı) anahtarları ise mipanel.culqi.com adresinden, CulqiPanel > Desarrollo > API Keys bölümünden alınır. Genel anahtar tarayıcıdaki Culqi açılır penceresi tarafından kullanılır. Gizli anahtar yalnızca sunucunuzda kullanılır ve tarayıcıya hiçbir zaman gönderilmez. Webhook gerekmez.

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_culqi_payment klasörünü FTP ile /wp-content/plugins/ içine de yükleyebilirsiniz.

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

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

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

5. Entegrasyon anahtarlarını ve gerçek ödemeler için üretim anahtarlarını yapıştırın (bkz. Yapılandırma).

6. Enable/Disable seçeneğini açın. Test ederken Test Mode seçeneğini açık tutun, gerçek ödeme almak için işaretini kaldırın.

7. Mağaza para biriminin PEN veya USD olduğundan emin olun.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Culqi. Test modu açıkken sayfa, alanların üstünde Test mode is active: the integration keys are used and no real money is charged. mesajını gösterir. Ağ geçidi etkinken geçerli modun anahtarları eksikse ve mağaza para birimi Culqi tarafından desteklenmiyorsa sizi uyarır. Her iki durumda da ödeme yöntemi ödeme sayfasında gizlenir. Ödeme yöntemleri listesinde, geçerli modun her iki anahtarı da girilene kadar Culqi kurulum gerektiriyor olarak işaretlenir.

Genel

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

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely with your credit/debit card or Yape via Culqi.

API anahtarları

Anahtarları CulqiPanel > Desarrollo > API Keys bölümünden kopyalayın: entegrasyon (test) anahtarları integ-panel.culqi.com adresinde, üretim anahtarları mipanel.culqi.com adresinde. Test modu yalnızca test anahtarlarını, canlı mod yalnızca canlı anahtarları kullanır. Her anahtar, alanının önekiyle başlamalıdır. Yanlış önekli bir anahtar kaydedilmez: sayfa bir hata gösterir ve önceki değeri korur.

Test Mode: Use the Culqi integration (test) environment. Açıkken test anahtarları (pk_test_ / sk_test_) kullanılır ve gerçek para tahsil edilmez. Varsayılan: açık. Canlı anahtarlarla gerçek ödeme almak için işaretini kaldırın.

Test Public Key: entegrasyon ortamının genel anahtarı. pk_test_ ile başlar.

Test Secret Key: entegrasyon ortamının gizli anahtarı. sk_test_ ile başlar ve tarayıcıyla hiçbir zaman paylaşılmaz.

Live Public Key: üretim ortamının genel anahtarı. pk_live_ ile başlar.

Live Secret Key: üretim ortamının gizli anahtarı. sk_live_ ile başlar ve tarayıcıyla hiçbir zaman paylaşılmaz.

1.0 sürümünden güncelliyorsanız, o sürümün tek anahtar çifti öneklerine göre test veya canlı alanlarına taşınır. Güncellemeden sonra anahtarları kontrol edin.

Ödeme yöntemleri

Kartlar her zaman sunulur. Banka havalesi, acenteler, cüzdanlar ve Cuotéalo, Culqi Orders API gerektirir ve bu eklenti tarafından sunulmaz.

Yape: Offer Yape in the Culqi popup, Culqi penceresinde kartların yanında Yape'yi gösterir. Varsayılan: açık.

Gelişmiş

Debug log: Log API requests and payment steps ayrıntıları WooCommerce > Status > Logs bölümüne, wcp_culqi_payment kaynağıyla yazar. Hatalar her zaman kaydedilir. Anahtarlar, kart bilgileri ve müşteri verileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

Delete Data on Uninstall: Delete the gateway settings and logs when the plugin is deleted. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Siparişlere kaydedilen Culqi verileri her zaman korunur. Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak Credit/Debit Card or Yape (Culqi)) ve sipariş verme düğmesine tıklar. Culqi Checkout açılır penceresi aynı sayfada mağazanızın adı, sipariş toplamı ve para birimiyle açılır. Müşteri burada kart bilgilerini girer veya Yape ile öder. Test modu açıkken ödeme yöntemi TEST MODE: No real charges will be made. mesajını gösterir.

Culqi ödeme verilerini tek kullanımlık bir jetona dönüştürür ve ödeme bu jetonla mağazanıza gönderilir. Sunucunuz, sipariş numarası tahsilat açıklamasında yer alacak şekilde, sipariş toplamı için sipariş para biriminde Culqi Charges API ile tahsilatı oluşturur. Sipariş, ancak Culqi tahsilatı onayladıktan ve tahsil edilen tutar ile para birimi siparişle eşleştikten sonra ödenmiş olarak işaretlenir. Ardından müşteri sipariş alındı sayfasına yönlendirilir.

Banka 3-D Secure gerektiriyorsa müşteri Your bank requires additional verification (3-D Secure). Please complete it in the window that opens. mesajını görür. Doğrulamadan sonra tahsilat otomatik olarak yeniden gönderilir. Doğrulama tamamlanmazsa müşteri The 3-D Secure verification was not completed. Please try again or use another card. mesajını görür.

Kart reddedilirse müşteri Culqi'nin mesajını görür, örneğin Payment failed: ve ardından gerekçe, ve başka bir kartla yeniden deneyebilir. Culqi yanıt vermezse müşteri We could not confirm your payment with Culqi. Please check your email or contact us before trying again. mesajını görür. Müşteri Culqi penceresini kapatırsa hiçbir tahsilat yapılmaz, müşteri The payment window was closed before the payment was completed. mesajını görür ve siparişi yeniden verebilir.

Ö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 anında tahsil edilen, tek seferlik kart ve Yape ödemelerini kabul eder. PagoEfectivo veya CIP kodları, banka uygulaması, acenteler, cüzdanlar ya da Cuotéalo yoktur; kayıtlı kart, abonelik veya taksit yoktur; Culqi webhook'ları yoktur ve ayrı yetkilendirme ile tahsilat yoktur.

Siparişler ve iadeler

Sipariş durumları

Pending payment: sipariş oluşturuldu ancak henüz tahsil edilmedi veya Culqi yanıt vermedi. Bu durumda bir not Culqi did not confirm the charge der. Başka bir ödemeyi kabul etmeden önce CulqiPanel'de bu siparişe ait bir tahsilat olup olmadığını kontrol edin.

Processing: ödeme onaylandı (WooCommerce varsayılanı; yalnızca indirilebilir sanal ürün içeren siparişler Tamamlandı olur). Sipariş notu Culqi tahsilat kimliğini, modu (test veya canlı) ve 3-D Secure'un kullanılıp kullanılmadığını gösterir. İşlem kimliği, Culqi tahsilat kimliğidir.

On hold: Culqi, tutarı veya para birimi siparişle uyuşmayan bir tahsilat ya da yetkilendirilmiş ancak tahsil edilmemiş bir ödeme bildirdi. Sipariş notu bunu açıklar ve tahsilat kimliğini gösterir. Tahsilatı CulqiPanel'de kontrol edin ve siparişi elle tamamlayın veya iade edin.

Failed: kart reddedildi. Sipariş notu gerekçeyi, ret kodunu ve tahsilat kimliğini gösterir. Müşteri başka bir kartla yeniden ödeyebilir.

Zaten ödenmiş olan veya zaten bir Culqi tahsilatı bulunan sipariş, beklemedeki sipariş dahil, bir daha tahsil edilmez. Sipariş başına aynı anda yalnızca bir ödeme isteği işlenir.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Culqi düğmesine tıklayın. Tam ve kısmi iadeler desteklenir. İade, o zamandan beri modu değiştirmiş olsanız bile, ödemenin yapıldığı modun (test veya canlı) anahtarlarıyla gönderilir; bu nedenle o modun gizli anahtarı girilmiş olmalıdır. Culqi iadeyi kabul etmezse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, Culqi iade kimliği, tutar ve gerekçeyle birlikte sipariş notlarına eklenir.

CulqiPanel'de yapılan iadeler WooCommerce'e geri aktarılmaz. Gerekirse WooCommerce'de Refund via Culqi kullanmadan elle 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 > Culqi 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, anahtarı bu siteden kaldırmak için Remove key seçeneğini 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 sitenin alan adı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan Culqi, müşterilere ödeme sayfasında 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 (unlicensed — visible to admins only) işaretiyle görmeye devam eder; 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: iadeler çalışmaya devam eder.

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

Culqi ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modun her iki anahtarının girildiğini (test modunda Test Public Key ve Test Secret Key, canlı modda Live Public Key ve Live Secret Key) ve mağaza para biriminin PEN veya USD olduğunu kontrol edin. Ayarlar sayfası bu durumların her birinde bir uyarı gösterir.

Ödeme gerçekleşti ama sipariş Pending payment durumunda kalıyor: eklenti webhook kullanmaz. Tahsilat yalnızca Culqi'nin sunucunuza verdiği yanıtla onaylanır. Culqi zamanında yanıt vermediyse sipariş notu Culqi did not confirm the charge der. Bu siparişin tahsilatını CulqiPanel'de bulun ve varsa siparişi elle tamamlayın.

Sipariş ödemeden sonra On hold durumunda: sipariş notunu okuyun. Tahsil edilen tutar veya para birimi siparişten farklıydı ya da ödeme tahsil edilmedi. Tahsilatı CulqiPanel'de kontrol edin (kimliği notta yer alır), ardından siparişi tamamlayın veya iade edin.

Anahtar kaydedilmiyor: hata, alanın bir önekle başlaması gerektiğini söyler, örneğin sk_live_. Her alan yalnızca kendi türündeki ve modundaki anahtarları kabul eder: pk_test_, sk_test_, pk_live_ veya sk_live_.

Müşteri Payment gateway misconfiguration. Please contact the store owner. mesajını görüyor: geçerli modun anahtarları eksik veya Culqi gizli anahtarı reddetti. Ayarlardaki anahtarları kontrol edin.

Müşteri Payment token is invalid. Please try again. mesajını görüyor: Culqi penceresinden gelen jeton diğer moda aittir, örneğin ödeme sayfası açıkken Test Mode değiştirildikten sonra. Müşteri sayfayı yeniden yüklemeli ve yeniden ödemelidir.

Culqi penceresi açılmıyor: müşteri The Culqi payment window could not be loaded. Please reload the page and try again. mesajını görür. js.culqi.com ve 3ds.culqi.com adreslerinden gelen betiklerin ödeme sayfanızda, örneğin bir optimizasyon eklentisi tarafından engellenmediğini kontrol edin.

Müşteri This order is already being paid mesajını görüyor: aynı sipariş için başka bir ödeme isteği aynı anda çalışıyordu. Müşteri beklemeli ve yeniden denemeden önce e-postasını kontrol etmelidir.

İade, anahtarlarla ilgili bir mesajla başarısız oluyor: ödeme test veya canlı modda yapıldı ve o modun gizli anahtarı girilmemiş. Anahtarı girin ve yeniden deneyin.

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 hak 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şılamazsa eklenti bilinen son durumla çalışmaya devam eder.

Geliştiriciler için eklenti belgeleri culqi_p_supported_currencies, culqi_p_charge_data, culqi_p_icon ve culqi_p_lock_timeout filtrelerini listeler.

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ı ve günlükler yalnızca Delete Data on Uninstall açıksa kaldırılır. Aksi halde daha sonraki bir yeniden kurulum için kalırlar. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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