VibeFox Wompi for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. Eklenti, WooCommerce olmadan etkinleştirilmez.

PHP: 8.0 veya üzeri.

Mağaza para birimi: Kolombiya pesosu (COP). Wompi Colombia yalnızca COP ile tahsilat yapar ve diğer para birimlerindeki siparişlerde ödeme yöntemi gizlenir.

Wompi hesabı: bir Wompi Colombia satıcı hesabı. Her ortamın (sandbox ve canlı) dört anahtarı vardır: genel anahtar, özel anahtar, olay gizli anahtarı ve bütünlük gizli anahtarı. Bunları Wompi satıcı panelinde (comercios.wompi.co), geliştiriciler bölümünde bulursunuz. Wompi El Salvador ve Panama farklı API'ler kullanır ve desteklenmez.

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. Ayrıca wcp_wompi_payment klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

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

3. WooCommerce > Settings > General bölümünde mağaza para birimini Kolombiya pesosu (COP) olarak ayarlayın.

4. Ayarları açın: WooCommerce > Settings > Payments > Wompi veya Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

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

6. Wompi satıcı panelinden sandbox ve canlı anahtarlarını yapıştırın ve Wompi'de Events URL'yi ayarlayın (bkz. Yapılandırma).

7. Enable/Disable seçeneğini açın. Sandbox modunda bir ödeme deneyin, ardından gerçek ödemeleri kabul etmek için Sandbox mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Wompi. Alanların üstünde bir durum kutusu geçerli modu, SANDBOX veya PRODUCTION, gösterir. Bu moddaki bir anahtar eksikse kutu bunu listeler ve bu ortamın tüm anahtarları ayarlanana kadar ödeme yönteminin ödeme sayfasında gizli olduğunu belirtir. Tüm anahtarlar ayarlandığında gerçek ödemelerin tahsil edilip edilmeyeceğini söyler. Kaydettiğinizde eklenti, bir anahtarın bölümünün önekiyle başlamaması durumunda ve Wompi etkinse ancak anahtarlar eksik olduğu için ödeme sayfasında gizliyse sizi uyarır. Ödeme yöntemleri listesinde Wompi, geçerli modda dört anahtar tamamlanana kadar kurulum gerektiren olarak işaretlenir. Sürüm 1.0 anahtarları güncelleme sırasında ilgili Sandbox veya Production bölümüne otomatik olarak taşınır.

Genel

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

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely with Wompi: cards, PSE, Nequi, Bancolombia and more.

Wompi hesabı

Anahtarları Wompi satıcı panelinden (comercios.wompi.co), geliştiriciler bölümünden kopyalayın. Her ortamın kendi genel anahtarı, özel anahtarı, olay gizli anahtarı ve bütünlük gizli anahtarı vardır.

Sandbox mode: Use the Wompi sandbox (sandbox keys, no real money). Hem anahtarları hem de Wompi API'sini değiştirir (sandbox.wompi.co veya production.wompi.co). Siparişler ödendikleri ortamı korur. Varsayılan: açık. Gerçek ödemeleri kabul etmek için işaretini kaldırın.

Sandbox anahtarları

Wompi sandbox'ının dört anahtarı. Bunlar pub_test_, prv_test_, test_events_ ve test_integrity_ ile başlar.

Public key: sandbox genel anahtarı (pub_test_...). Wompi Web Checkout'taki hesabınızı tanımlar.

Private key: sandbox özel anahtarı (prv_test_...). Wompi API'sinden işlemleri okumak için kullanılır.

Events secret: sandbox olay gizli anahtarı (test_events_...). Wompi olaylarının imzasını doğrular.

Integrity secret: sandbox bütünlük gizli anahtarı (test_integrity_...). Web Checkout'a gönderilen ödeme isteğini imzalar.

Canlı anahtarlar

Wompi canlı ortamının dört anahtarı. Bunlar pub_prod_, prv_prod_, prod_events_ ve prod_integrity_ ile başlar.

Public key: canlı genel anahtar (pub_prod_...).

Private key: canlı özel anahtar (prv_prod_...).

Events secret: canlı olay gizli anahtarı (prod_events_...).

Integrity secret: canlı bütünlük gizli anahtarı (prod_integrity_...).

Events URL (webhook)

Wompi olayları, mağazanıza bir işlemin değiştiğini bildirir. Wompi satıcı panelinde, geliştiriciler bölümünde, ayarların bu bölümünde gösterilen Events URL'yi hem sandbox hem de canlı ortam için ayarlayın. Şu biçimdedir: https://your-site/wc-api/wompi_p/. URL'yi ayarlarda gösterildiği gibi aynen kopyalayın.

Eklenti bu olayı kullanır:

Diğer olaylara Ignored yanıtı verilir. Her olay, kendi ortamının (sandbox veya canlı) olay gizli anahtarıyla kontrol edilir. Geçerli imzası olmayan olaylar reddedilir. Kontrolden sonra işlem Wompi API'sinden okunur ve yalnızca bu veriler kullanılır. Events URL olmadan bir sipariş, müşteri ödemeden sonra mağazaya döndüğünde onaylanır.

Gelişmiş

Debug log: Log payment and webhook activity, ödeme ve olay etkinliklerini WooCommerce > Status > Logs sayfasına, kaynak wcp_wompi_payment olarak yazar. Bu seçenek kapalı olsa bile hatalar her zaman kaydedilir. Anahtarlar, gizli anahtarlar ve müşteri verileri asla kaydedilmez. Varsayılan: kapalı.

Delete data on uninstall: Remove the plugin settings and logs when the plugin is deleted. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Sipariş verileri her zaman korunur. Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak Wompi) ve siparişi verir. Sandbox modunda ödeme sayfası açıklamanın altında Sandbox mode: no real payment is made. gösterir. Eklenti, kendi referansıyla (WC-, sipariş numarası ve bir zaman damgası) bir ödeme denemesi oluşturur, bunu bütünlük gizli anahtarıyla imzalar ve müşteriyi COP cinsinden sipariş tutarıyla Wompi Web Checkout'a yönlendirir. Müşterinin fatura e-postası ve adı Wompi'ye iletilir. Siparişteki bir not ortamı, referansı ve tutarı kaydeder.

Wompi sayfasında müşteri, Wompi hesabınızda etkin olan herhangi bir ödeme yöntemiyle öder. Ardından Wompi, müşteriyi mağazanızın sipariş alındı sayfasına geri gönderir. Sipariş, yalnızca Wompi onayladıktan sonra ödenmiş olarak işaretlenir: imzalı bir olayla ya da müşteri bu sayfaya ulaştığında sunucudan Wompi API'sine yapılan bir istekle. Dönüş adresindeki işlem numarasına güvenilmez. Sayfa yeniden yüklendiğinde işlem, en fazla 20 saniyede bir yeniden kontrol edilir.

Bir siparişi yalnızca o sipariş için oluşturulan işlemler ödeyebilir ve yalnızca denemenin ortamında. Müşteri, ödenmemiş bir siparişi yeniden ödeyebilir; örneğin Pay for order sayfasından. Her deneme yeni bir referans alır.

Ödeme yöntemi yalnızca lisans etkin olduğunda, geçerli modun dört anahtarı ayarlandığında, sipariş para birimi COP olduğunda ve toplam en az COP 1.500 olduğunda gösterilir. Ödeme başlatılamazsa müşteri kısa bir mesaj görür ve başka bir ödeme yöntemi seçebilir:

Ö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. Kolombiya ve İspanya için İspanyolca çeviriler dahildir.

Eklenti WooCommerce üzerinden iade yapmaz. Sitenizde kayıtlı kart, abonelik ve kart alanı yoktur: tüm ödeme bilgileri Wompi'ye girilir.

Siparişler

Sipariş durumları

Pending payment: müşteri Wompi'ye yönlendirildi ve henüz ödeme yapmadı ya da Wompi işlemi henüz onaylamadı.

On hold (pending payment): Wompi işlemi beklemede olarak bildirir; örneğin onay bekleyen PSE, Nequi veya nakit ödemeler. Sipariş, Wompi onaylayana veya reddedene kadar beklemede kalır.

Processing or Completed: işlem onaylandı. WooCommerce standardı geçerlidir: İşleniyor veya yalnızca sanal indirilebilir ürünler içeren siparişler için Tamamlandı. Sipariş notu Wompi işlemini, ödeme yöntemi türünü (örneğin kart, PSE veya Nequi) ve referansı gösterir. Siparişin işlem kimliği, Wompi işlem kimliğidir.

On hold after payment: Wompi, sipariş toplamından farklı bir tutar veya para birimi onayladı (örneğin ödeme başladıktan sonra sipariş düzenlendi) ya da ödeme, sipariş iptal edildikten sonra onaylandı. Sipariş ödenmiş olarak işaretlenmez. Sipariş notu bunu açıklar. Ödemeyi Wompi panelinde kontrol edin ve siparişi tamamlayın ya da ödemeyi iade edin.

Failed: son ödeme denemesinin işlemi reddedildi ya da bir hatayla sonlandı. Wompi mesajı nota eklenir. Önceki denemelerin sonuçları siparişi değiştirmez.

Cancelled: son ödeme denemesinin işlemi, sipariş ödenmeden önce Wompi'de iptal (void) edildi.

Zaten ödenmiş bir sipariş için ikinci bir onaylı ödeme gelirse sipariş değişmez. Bir not, kopyayı Wompi panelinde iade etmenizi ister. Ödeme işlemi Wompi'de iptal edilirse bir not siparişi incelemenizi ister. İade edilmiş bir sipariş için geç gelen bir ödeme yalnızca bir not ekler. Tekrarlanan olaylar ve müşteri dönüşleri hiçbir zaman not, e-posta veya stok değişikliğini çoğaltmaz.

İadeler

İadeler WooCommerce'ten gönderilmez. Ödemeyi Wompi satıcı panelinde iade edin veya iptal (void) edin, ardından WooCommerce'te manuel bir iade kaydedin. Wompi'de yapılan bir iptal (void), siparişe not olarak eklenir.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Wompi 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 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, alan adı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Wompi, ö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) ibaresiyle işaretlenir, böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Plugins sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler, Wompi olayları ve müşteri dönüşleriyle onaylanmaya 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

Wompi ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve geçerli modun dört anahtarının da ayarlandığını kontrol edin (ayarlar sayfasındaki durum kutusu eksik anahtarları listeler). Ayrıca sipariş para biriminin COP olduğunu ve sipariş toplamının en az COP 1.500 olduğunu kontrol edin.

Ödeme geçti ama sipariş Pending payment durumunda kaldı: Events URL çalışmıyor. Wompi panelinde, kullandığınız ortam (sandbox veya canlı) için Events URL'nin ayarlı olduğunu ve ayarlarda gösterilenle tam olarak aynı olduğunu kontrol edin. O ortamın olay gizli anahtarının ilgili bölümde olduğunu doğrulayın. Müşteri ödemeden sonra mağazaya döndüğünde sipariş de onaylanır.

Events URL Not configured yanıtı veriyor: olayın ortamının olay gizli anahtarı boş. Ayarlara yapıştırın.

Events URL Invalid signature yanıtı veriyor: olay gizli anahtarı başka bir ortama veya başka bir hesaba ait. Wompi panelinden yeniden kopyalayın.

Events URL Transaction lookup failed yanıtı veriyor: Wompi API işlemi döndürmedi; örneğin özel anahtar yanlış ya da bir ağ sorunu olduğu için. Wompi olayı daha sonra yeniden gönderir.

Events URL Busy, retry yanıtı veriyor: sipariş aynı anda başka bir istek tarafından güncelleniyordu. Wompi olayı daha sonra yeniden gönderir.

Events URL Environment mismatch yanıtı veriyor: bir sandbox işlemi, canlı bir ödeme denemesi için geldi ya da tersi. Sandbox ödemeleri asla canlı siparişleri onaylamaz.

Kaydederken «The key does not start with ...» uyarısı: bir anahtar yanlış bölüme yapıştırılmış. Sandbox anahtarları pub_test_, prv_test_, test_events_ ve test_integrity_ ile; canlı anahtarlar ise pub_prod_, prv_prod_, prod_events_ ve prod_integrity_ ile başlar.

Sipariş tutarla ilgili bir notla On hold durumunda: onaylanan tutar veya para birimi sipariş toplamından farklı. Ödemeyi Wompi panelinde kontrol edin ve siparişi elle tamamlayın ya da iade edin.

Diğer hatalar: sipariş notlarını ya da WooCommerce > Status > Logs sayfasını açın, kaynak wcp_wompi_payment. Hatalar her zaman kaydedilir. Daha fazla ayrıntı için Debug log seçeneğini açın. Geliştiriciler, Wompi hesabı kabul ediyorsa wompi_p_supported_currencies filtresiyle başka bir para birimine izin verebilir.

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

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi 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 eklenti günlükleri yalnızca Delete data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Mevcut siparişler ödeme notlarını, Wompi verilerini ve işlem kimliklerini korur.

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