VibeFox Khipu for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin olmalıdır. WooCommerce olmadan eklenti etkinleştirilmeyi reddeder.

PHP: 8.0 veya üzeri.

Mağaza para birimi: Şili pesosu (CLP), Arjantin pesosu (ARS) veya Peru solü (PEN). Mağaza ya da Pay for order sayfasındaki sipariş başka bir para birimi kullandığında ödeme yöntemi ödeme sayfasında gizlenir.

Khipu hesabı: Khipu tahsilat hesabınızın Receiver ID ("Id de cobrador"), API anahtarı ve gizli anahtarına ("llave") ihtiyacınız vardır. Bunları Khipu hesabınızda satıcı profili altında bulabilirsiniz (khipu.com/merchant/profile). Üçü de gereklidir: gizli anahtar olmadan hiçbir ödeme onaylanamaz.

Erişilebilir site: Khipu ödemeleri mağazanızı arayarak onaylar, bu nedenle site internete açık olmalıdır (bakım modu, temel kimlik doğrulama veya Khipu'yu engelleyen bir güvenlik duvarı olmamalıdır).

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek 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_khipu_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 > Khipu > Manage 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 bölümüne VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Khipu tahsilat hesabınızın Receiver ID, API key ve Secret key bilgilerini girin (bkz. Yapılandırma).

6. Enable / Disable seçeneğini açın ve kaydedin. Önce test etmek için bir Khipu geliştirici hesabının anahtarlarını kullanın, ardından bunları canlı hesabınızın anahtarlarıyla değiştirin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Khipu. Sayfa, alanların üstünde Receiver ID, API anahtarı veya gizli anahtar eksik olduğunda (bu durumda Khipu ödeme sayfasında sunulmaz) ve mağaza para birimi desteklenmediğinde sizi uyarır. Ödeme yöntemleri listesinde Khipu, üç anahtar da girilene kadar kurulum gerektiriyor olarak işaretlenir.

Genel

Enable / Disable: Enable Khipu 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: Khipu.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay by bank transfer with Khipu.

Khipu hesabı

Receiver ID, API anahtarı ve gizli anahtarı Khipu tahsilat hesabınızdan kopyalayın (khipu.com/merchant/profile). Khipu'nun ayrı bir test sunucusu yoktur ve eklentide test modu anahtarı bulunmaz. Test etmek için bir geliştirici ("desarrollo") tahsilat hesabının anahtarlarını kullanın: bu hesap DemoBank test bankasıyla ödeme yapar ve gerçek para hareket etmez. Canlıya geçtiğinizde canlı tahsilat hesabınızın anahtarlarına geçin.

Receiver ID: Khipu Receiver ("cobrador") kimliğiniz. Diğer Khipu hesaplarının ödemeleri reddedilir.

API key: ödemeleri oluşturmak ve her ödemeyi Khipu ile doğrulamak için kullanılır.

Secret key: Khipu ödeme bildirimlerinin imzasını (HMAC-SHA256) doğrulamak için kullanılır. Bu olmadan hiçbir ödeme onaylanamaz.

Ödeme bildirimleri

Khipu, ödemeleri ayarların bu bölümünde gösterilen bildirim URL'sini çağırarak onaylar. URL şuna benzer: https://your-site/wc-api/webhook_wc_khipu/. URL her ödemeyle birlikte otomatik olarak gönderilir, yani Khipu hesabınızda yapılandırmanız gereken bir şey yoktur; ancak URL'nin internete açık olması gerekir.

Her bildirim, Secret key ile oluşturulmuş geçerli bir imza taşımalıdır. Geçerli imzası olmayan bildirimler reddedilir. Ardından eklenti Khipu'dan ödeme durumunu sorar ve Khipu'nun bildirdiğine göre hareket eder:

Status after payment: Khipu ödemeyi onayladıktan sonra siparişin alacağı durum. Durum hemen, tek bir durum değişikliği ve tek bir e-posta grubuyla ayarlanır.

Gelişmiş

Debug log: Log API calls and notifications seçeneği, API çağrılarını ve bildirimleri WooCommerce > Status > Logs bölümünde wcp_khipu_gateway kaynağı altında kaydeder. Hatalar her zaman kaydedilir. Anahtarlar ve ödeyen bilgileri asla yazılmaz. Varsayılan: kapalı.

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted seçeneği, eklenti silindiğinde ağ geçidi ayarlarını ve kayıtları kaldırır. Sipariş verileri (siparişlerdeki Khipu ödeme kimlikleri) her zaman saklanır. Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak Khipu) ve siparişi verir. Eklenti, sipariş toplamı için sipariş para biriminde; sipariş numarasını, mağaza adını ve sipariş edilen ürünleri içeren bir Khipu ödemesi oluşturur ve müşteriyi Khipu ödeme sayfasına yönlendirir. Fatura e-postası geçerli olduğunda Khipu'ya iletilir. Khipu sayfasında müşteri kendi bankasından havale ile ödeme yapar ve Khipu'nun sunduğu havale türleri arasından seçim yapar.

Ödeme yaptıktan sonra müşteri mağazanızın sipariş alındı sayfasına döner. Sipariş, ancak Khipu havaleyi onayladıktan sonra ödendi olarak işaretlenir: imzalı bildirimle veya müşteri sipariş alındı sayfasını açtığında Khipu'ya yapılan durum sorgusuyla. Sayfaya geri dönüş tek başına bir siparişi asla ödendi olarak işaretlemez. Havale onaylanmadığı sürece sayfa şunu gösterir: Khipu is confirming your bank transfer. Your order will be updated automatically as soon as Khipu confirms the payment, and you will receive an e-mail.

Müşteri ödeme yapmadan Khipu sayfasından ayrılırsa, Pay for order sayfasına şu mesajla gelir: The Khipu payment was not completed. You can try again or choose another payment method. Yeni bir deneme önceki ödenmemiş Khipu ödemesini siler, böylece eski bağlantı üzerinden artık ödeme yapılamaz. Khipu önceki ödemeyi zaten aldıysa sipariş tamamlanır ve yeni bir ödeme oluşturulmaz. Önceki havale hâlâ doğrulanıyorsa müşteri şunu görür: Your previous Khipu payment for this order is still being verified by the bank. Please wait a few minutes before paying again.

Stok yönetimi açıksa Khipu ödemesi, WooCommerce'in Hold stock (minutes) süresiyle birlikte sona erer; böylece müşteri iptal edilmiş bir siparişi ödeyemez.

Khipu ödemeyi oluşturamazsa müşteri kısa bir mesaj görür, örneğin Khipu could not create the payment for this order. Please check your billing details and try again, or contact the store. ya da Khipu is temporarily unavailable. Please try again in a few minutes. Ayrıntılar kayda yazılır.

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

Eklenti yalnızca tek seferlik banka havalesi ödemelerini alır. WooCommerce üzerinden iadeler desteklenmez; abonelikler, kayıtlı ödeme yöntemleri veya ön yetkilendirmeler yoktur.

Siparişler

Sipariş durumları

Pending payment: müşteri Khipu'ya yönlendirildi ve henüz ödeme yapmadı ya da Khipu havaleyi henüz onaylamadı. Sipariş notu Khipu ödeme kimliğini gösterir.

Processing or Completed: Khipu ödemeyi onayladı. Durum, Status after payment ayarına göre belirlenir. Sipariş notu Khipu ödeme kimliğini gösterir ve işlem kimliği Khipu ödeme kimliğidir.

On hold: Khipu, tutarı veya para birimi siparişle eşleşmeyen bir ödeme bildirdi ya da ödeme sipariş iptal edildikten sonra geldi (örneğin stok tutma süresinden sonra). Sipariş notu bunu açıklar. Ödemeyi Khipu hesabınızda kontrol edin ve siparişi tamamlayın veya müşteriye iade yapın.

Ödemesi zaten alınmış veya ödemeden sonra kapatılmış bir sipariş için ödeme gelirse sipariş değiştirilmez. Bir not, bunun ikinci bir ödeme olması durumunda müşteriye iade yapmanızı ister.

İadeler

İadeler WooCommerce'ten Khipu'ya gönderilmez. Müşteriye Khipu hesabınızdan veya banka havalesiyle iade yapın, ardından iadeyi WooCommerce'te manuel olarak kaydedin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Payments > Khipu sayfasının üst kısmındadır. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bölüm, lisansın hangi tarihe kadar etkin olduğu ve alan adınız gibi durum bilgilerini gösterir. 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 düğmesini kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar tek bir alan adında çalışır. Anahtarı bir siteden kaldırmak, o alan adının yerini boşaltmaz. Yeri vibefox.net hesabınızdan boşaltın.

Etkin bir anahtar olmadan Khipu müşterilere ödeme sayfasında gösterilmez. Yine de bir ödeme başlatılırsa müşteri şunu görür: This payment method is not available. Please choose another one. Oturum açmış mağaza yöneticileri ödeme yöntemini görmeye devam eder, (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: başlatılmış ödemeler yine de onaylanır.

Lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Khipu ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu ve Receiver ID, API key ile Secret key alanlarının hepsinin doldurulduğunu kontrol edin. Mağaza para birimi CLP, ARS veya PEN olmalıdır. Bir şey eksikse ayarlar sayfası bir uyarı gösterir.

Ödeme geçti ama sipariş Ödeme bekleniyor olarak kalıyor: Khipu havaleyi banka doğruladıktan sonra onaylar. Sipariş, Khipu bildirimi geldiğinde veya müşteri sipariş alındı sayfasını açtığında güncellenir. Sitenize ayarlarda gösterilen bildirim URL'sinden internet üzerinden erişilebildiğinden emin olun (bakım modu, temel kimlik doğrulama veya Khipu'yu engelleyen güvenlik duvarı olmamalıdır) ve WooCommerce > Status > Logs bölümünde wcp_khipu_gateway kaynağına bakın.

Bildirim "Secret key not configured" yanıtı veriyor: Secret key boş. Girmeniz gerekir. Khipu bildirimi yeniden gönderir.

Bildirim "Invalid signature", "Missing signature" veya "Malformed signature" yanıtı veriyor: Secret key, anahtarlarını kullandığınız tahsilat hesabına ait değil ya da istek Khipu'dan gelmedi.

Bildirim "Payment does not belong to this order" yanıtı veriyor: ödeme başka bir Receiver ID'ye veya başka bir sipariş için yapıldı. Receiver ID ayarını kontrol edin.

Bildirim "Payment not final yet" veya "Verification unavailable" yanıtı veriyor: havale hâlâ doğrulanıyor ya da Khipu'ya ulaşılamadı. Khipu bildirimi yeniden gönderir.

Sipariş Beklemede durumunda: sipariş notunu okuyun. Tutar veya para birimi siparişle eşleşmedi ya da ödeme sipariş iptal edildikten sonra geldi.

Müşteri "Khipu payments are not available right now" mesajını görüyor: API anahtarı eksik veya yanlış. Khipu hesabınızdaki anahtarları kontrol edin.

Lisans bölümü bir hata gösteriyor: bölümdeki mesajı izleyin. Örneğin anahtar başka bir alan adında kullanılıyorsa vibefox.net hesabınızda bir yer boşaltı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 son bilinen durumla çalışmaya devam eder.

Khipu hesabınız başka bir para birimini kabul ediyorsa, örneğin Khipu İspanya için EUR, geliştiriciler bunu wc_khp_supported_currencies filtresiyle ekleyebilir.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için Plugins sayfasında eklentiyi devre dışı bırakıp silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları ve kayıtlar yalnızca Delete data on uninstall açıksa kaldırılır. Aksi halde daha sonraki bir yeniden kurulum için saklanırlar. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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