VibeFox Wompi for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerine kurulmayı reddeder.

Para birimi: Kolombiya pesosu (COP). Wompi Colombia COP cinsinden tahsilat yapar ve diğer para birimlerindeki sepetler için ödeme yöntemi gizlenir. Ayarlar sayfası, mağazanın varsayılan para birimi COP değilse sizi uyarır.

Wompi hesabı: bir Wompi Colombia satıcı hesabı. Her ortamın (sandbox ve canlı ortam) 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 bir alan adında çalışır.

Kurulum

1. Back office'te Modules > Module Manager bölümüne gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Wompi Payment modülünü bulup Configure düğmesine tıklayın.

3. VibeFox lisans anahtarınızı Configure sayfasının üstündeki lisans bloğunda License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Wompi satıcı panelinden sandbox ve canlı ortam anahtarlarını yapıştırın ve Wompi'de Olay URL'sini ayarlayın (bkz. Yapılandırma).

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Sandbox modunda bir ödeme deneyin, ardından gerçek ödemeleri kabul etmek için Sandbox mode seçeneğini kapatın.

Kurulumda modül iki sipariş durumu oluşturur: Awaiting Wompi payment ve Wompi payment on hold. PrestaShop, o anda var olan para birimleri, ülkeler ve müşteri grupları için yeni bir ödeme modülü sunar. Payment > Preferences bölümünde COP'un izinli olduğunu kontrol edin. Daha sonra eklediğiniz bir ülke, o ülkedeki müşterilerin Wompi'yi görebilmesi için orada işaretlenmelidir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Wompi Payment > Configure. Alan içeren her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanların üstündeki durum kutusu, geçerli modu gösterir: SANDBOX veya PRODUCTION. Bu moda ait bir anahtar eksikse kutu eksik anahtarı 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 modül, bir anahtarın bulunduğu bölümün önekiyle başlamaması durumunda ve Wompi etkin olduğu halde anahtarlar eksik olduğu için ödeme sayfasında gizliyse sizi uyarır.

Wompi

Enable/Disable: Enable Wompi ödeme yöntemini açar veya kapatır. Varsayılan: off.

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Wompi. Boş bırakırsanız modül adı kullanılır.

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: Wompi sandbox'ını kullanır (sandbox anahtarları, gerçek para yok). Hem anahtarları hem de Wompi API'sini değiştirir (sandbox.wompi.co veya production.wompi.co). Ödeme denemeleri, yapıldıkları ortamı korur. Varsayılan: on. Gerçek ödemeleri kabul etmek için kapatın. Açıkken müşteriler ödeme yönteminin altında Sandbox modu: gerçek bir ödeme yapılmaz. mesajını görür.

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_...). Hesabınızı Wompi Web Checkout üzerinde 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ı ortam 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ı ortam genel anahtarı (pub_prod_...).

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

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

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

Genel anahtarlar alanlarında gösterilir. Kayıtlı özel anahtarlar ve gizli anahtarlar bir daha asla gösterilmez. Alan boş kalır ve Kayıtlı: Korumak için boş bırakın. yazısını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Clear saved secrets: iki ortamdan birinin özel anahtarını veya gizli anahtarını işaretleyin ve kaldırmak için Save düğmesine tıklayın. Boş alan kayıtlı değeri korur.

Olay URL'si (webhook)

Wompi olayları, mağazanıza bir işlemin değiştiğini bildirir. Wompi satıcı panelinde, geliştiriciler bölümünde, bu bölümde gösterilen Olay URL'sini hem sandbox hem de canlı ortam için ayarlayın. Dostça URL'lerle şöyle görünür: https://your-shop/module/wcp_wompi_payment/webhook, belki /es/ gibi bir dil kodu ile. URL'yi ayarların gösterdiği gibi birebir kopyalayın.

Modül bu olayı kullanır:

transaction.updated: bir işlem onaylandı, reddedildi, iptal edildi, başarısız oldu veya beklemede.

Diğer olaylara Ignored yanıtı verilir. Her olay, kendi ortamının (sandbox veya canlı ortam) olay gizli anahtarıyla kontrol edilir. Geçerli imzası olmayan webhook'lar reddedilir. Kontrolden sonra işlem, o ortamın özel anahtarıyla Wompi API'sinden okunur ve yalnızca bu veriler kullanılır. Olay URL'si yoksa sipariş, ancak müşteri ödeme yaptıktan sonra mağazaya döndüğünde oluşturulur.

Gelişmiş

Debug log: ödeme ve webhook etkinliğini modül klasöründeki logs/wompi_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar ve uyarılar, bu seçenek kapalı olsa bile her zaman kaydedilir. Anahtarlar, gizli anahtarlar ve müşteri verileri hiçbir zaman kaydedilmez. Varsayılan: off.

Log: günlüğün boyutunu ve son kayıtlarını gösterir. Boşaltmak için Clear log düğmesine tıklayın.

Delete data on uninstall: açıkken modül kaldırıldığında modül ayarları ve günlük silinir. Wompi ödeme denemeleri ve modülün sipariş durumları her zaman korunur, böylece mevcut siparişler Wompi verilerini saklamaya devam eder. Varsayılan: off.

Ödeme

Ödeme adımında müşteri ödeme yöntemini (varsayılan olarak Wompi) seçer ve onaylar. Modül, kendi referansıyla (PS-, sepet numarası ve bir zaman damgası) bir ödeme denemesi oluşturur, bunu bütünlük gizli anahtarıyla imzalar ve müşteriyi sepet toplamı COP cinsinden olacak şekilde Wompi Web Checkout'a gönderir. Müşterinin e-posta adresi ve fatura adresinin adı Wompi'ye iletilir. Bu noktada henüz bir sipariş yoktur.

Wompi sayfasında müşteri, Wompi hesabınızda etkin olan herhangi bir ödeme yöntemiyle öder. Ardından Wompi, müşteriyi mağazanıza geri yönlendirir. Sipariş, yalnızca Wompi onayladıktan sonra ödenmiş olarak işaretlenir: imzalı bir olayla veya müşteri geri döndüğünde Wompi API'sine sunucu tarafı bir istekle. Dönüş adresindeki işlem numarasına güvenilmez; yalnızca denemenin ortamında o sepet için oluşturulmuş işlemler kabul edilir. Sayfa yenilendiğinde işlem en fazla 20 saniyede bir yeniden kontrol edilir.

İşlem onaylandığında sipariş oluşturulur ve müşteri standart sipariş onay sayfasını görür. Bekleyen bir ödeme için (örneğin PSE, Nequi veya nakit ödeme) sayfa Wompi ödemeniz onay bekliyor (örneğin PSE, Nequi veya nakit ödeme). Wompi ödemeyi onaylar onaylamaz siparişi işleme alacağız. gösterir. Beklemede olan bir sipariş için Wompi ödemenizi aldık ve inceliyoruz. Bir şey gerekirse sizinle iletişime geçeceğiz. gösterir. Bekleyen bir ödeme daha sonra reddedilirse sayfa Wompi ödemeniz onaylanmadı. Lütfen bizimle iletişime geçin. gösterir. İptal edilirse sayfa Wompi ödemeniz iptal edildi ve bu sipariş iptal edildi. Lütfen bizimle iletişime geçin. gösterir.

Müşteri geri döndüğünde Wompi işlemi henüz onaylamadıysa, Ödemenizin Wompi tarafından onaylanmasını bekliyoruz. Onaylandığında e-posta alacaksınız. mesajını ve bir Check again düğmesini gösteren bir sayfa açılır. Wompi olayı gelir gelmez siparişi oluşturur.

Ödeme reddedilirse sipariş oluşturulmaz ve sepet korunur. Müşteri ödeme sayfasına Wompi ödemeniz onaylanmadı (...). Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. mesajıyla, Wompi'nin verdiği nedenle geri döner. İptal edilen bir ödeme Wompi ödemeniz iptal edildi. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. mesajını gösterir. Müşteri ödeme yapmadan Web Checkout'tan ayrılırsa mesaj Wompi ödemeniz tamamlanmadı. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. olur. Her yeni denemeye yeni bir referans verilir. Sepetin bir siparişi olduktan sonra (ödendi, beklemede, Ödeme hatası veya İptal edildi), tekrar ödenemez: müşteri sipariş onay sayfasına yönlendirilir.

Ödeme yöntemi yalnızca lisans etkinse, geçerli modun dört anahtarının tümü ayarlıysa, sepet para birimi COP ise ve modül için izinliyse ve toplam en az COP 1.500 ise gösterilir. Ödeme başlatılamazsa müşteri, kısa bir mesajla ödeme sayfasında kalır:

Wompi şu anda kullanılamıyor. Lütfen başka bir ödeme yöntemi seçin.: geçerli modun anahtarları eksik.

Wompi ödemeleri yalnızca COP cinsinden kabul eder; bu sipariş ...: sepet başka bir para biriminde.

Wompi ödemeleri için asgari tutar ...: sepet toplamı COP 1.500'ün altında.

Bu ödeme yöntemi kullanılamıyor.: modül devre dışı veya sepetin ülkesi, para birimi ya da müşteri grubu için izinli değil.

Olay URL'si, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez.

Modül PrestaShop üzerinden iade yapmaz. Sitenizde kayıtlı kart, abonelik veya kart alanı yoktur: tüm ödeme bilgileri Wompi'de girilir.

Siparişler

Sipariş durumları

Henüz sipariş yok: müşteri Wompi'ye yönlendirildi ve ödeme yapmadı, ödeme reddedildi veya Wompi işlemi henüz onaylamadı. Yalnızca sepet vardır.

Awaiting Wompi payment: Wompi, işlemi bekleyen olarak bildirir; örneğin onay bekleyen PSE, Nequi veya nakit ödemeler. Sipariş, Wompi onaylayana veya reddedene kadar bekler. Onaylandığında ödeme kaydedilir ve sipariş Payment accepted durumuna geçer.

Payment accepted: işlem, sepet tutarı için COP cinsinden onaylandı. Ödeme, Wompi işlem kimliğiyle kaydedilir ve bir not işlemi, ödeme yöntemi türünü (örneğin CARD, PSE veya NEQUI), referansı, tutarı ve ortamı gösterir.

Wompi payment on hold: Wompi, sipariş toplamından farklı bir tutar veya para birimi onayladı (örneğin ödeme başladıktan sonra sepet değiştirildi) ya da ödeme, sipariş iptal edildikten sonra onaylandı. Sipariş ödenmiş olarak işaretlenmez. Not durumu açıklar. Ödemeyi Wompi panelinde kontrol edin ve ardından siparişi tamamlayın veya ödemeyi iade edin.

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

Canceled: son ödeme denemesinin bekleyen bir işlemi Wompi'de iptal edildi.

Zaten ödenmiş bir sipariş için ikinci bir onaylı ödeme gelirse sipariş değişmez. Bir not, kopyayı Wompi panelinden 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 geri dönüşler hiçbir zaman notları, e-postaları veya ödemeleri çoğaltmaz.

Wompi ödeme bloğu

Sipariş sayfasında referansı, işlem kimliğini, durumu (Wompi durumuyla birlikte), istenen tutarı, işlem tutarını, ödeme yöntemini, Wompi mesajını, sandbox ödemeleri için bir SANDBOX rozetini, birden fazla varsa sepetin Payment attempts kayıtlarını ve siparişin Wompi notes notlarını içeren bir Wompi payment bloğu gösterilir.

İadeler

İadeler PrestaShop'tan gönderilmez. Ödemeyi Wompi satıcı panelinde iade edin veya iptal edin, ardından iadeyi PrestaShop'ta elle kaydedin. Wompi'de yapılan ödeme işleminin iptali siparişe not olarak eklenir.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Wompi Payment lisans bloğu, Modules > Module Manager > VibeFox Wompi Payment > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu son tarih ve alan adınız) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: presta-payment-wompi satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure izni olan çalışanlar değiştirebilir. Bloğun metinleri back office dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir; örneğin Key not found, This key belongs to another product, Domain limit reached veya License expired on ve bir tarih. Mağaza adresi değiştikten sonra ya da hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: ana mağazanın alan adında, çok mağazalı kurulumda da. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızda serbest bırakın.

Etkin bir lisans 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. PrestaShop vitrini, back office'e giriş yaptığınızı bilmez; bu yüzden ödeme yöntemi sizden de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma çıkar. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler Wompi olaylarıyla ve müşteri dönüşleriyle onaylanmaya devam eder.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, back office'te çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron job gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

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 tümünün ayarlı olduğunu kontrol edin (ayarlar sayfasındaki durum kutusu eksik anahtarları listeler). Ayrıca sepet para biriminin COP olduğunu ve toplamın en az COP 1.500 olduğunu kontrol edin. Payment > Preferences bölümünde modülün COP, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Ödeme geçti ama sipariş oluşturulmadı: Olay URL'si çalışmıyor. Wompi panelinde, kullandığınız ortam (sandbox veya canlı ortam) için Olay URL'sinin ayarlı olduğunu ve ayarlarda gösterilenle tam olarak aynı olduğunu kontrol edin. Bu ortamın olay gizli anahtarının ilgili bölümde olduğunu kontrol edin. Müşteri ödeme yaptıktan sonra mağazaya döndüğünde de sipariş oluşturulur.

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

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

Olay URL'si Transaction lookup failed yanıtı veriyor: Wompi API işlemi döndürmedi; örneğin yanlış bir özel anahtar veya bir ağ sorunu nedeniyle. Wompi olayı daha sonra yeniden gönderir.

Olay URL'si Retry yanıtı veriyor: sipariş aynı anda başka bir istekle onaylanıyordu veya sipariş oluşturulamadı (örneğin modül devre dışı). Wompi olayı daha sonra yeniden gönderir. Nedeni görmek için Log alanına bakın.

Olay URL'si Environment mismatch yanıtı veriyor: bir sandbox işlemi canlı ortam ödeme denemesi için geldi ya da tersi. Sandbox ödemeleri hiçbir zaman canlı ortam siparişlerini onaylamaz.

Olay URL'si Unknown reference yanıtı veriyor: işlem referansı bu mağaza tarafından verilmedi; örneğin aynı Wompi hesabı başka bir mağaza tarafından kullanılıyor. Diğer sistemlerin referansları Ignored yanıtı alır.

Webhook URL'si tarayıcıda Method not allowed gösteriyor: bu normaldir. URL yalnızca Wompi'den gelen isteklerleri kabul eder.

Kaydederken anahtarın ... ile başlamadığını gösteren uyarı: bir anahtar yanlış bölüme yapıştırılmış. Sandbox anahtarları pub_test_, prv_test_, test_events_ ve test_integrity_ ile; canlı ortam anahtarları pub_prod_, prv_prod_, prod_events_ ve prod_integrity_ ile başlar.

Sipariş Wompi payment on hold durumunda: Wompi payment bloğundaki notları okuyun (bkz. Sipariş durumları), ardından siparişi tamamlayın veya ödemeyi Wompi panelinden iade edin.

Diğer hatalar: modül sayfasındaki Log alanına ve siparişin Wompi notes notlarına bakın. Hatalar her zaman kaydedilir. Daha fazla ayrıntı için Debug log seçeneğini açın.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Wompi Payment yanındaki menüyü açın ve Uninstall seçeneğini seçin. Bu modülün lisans anahtarı ve lisans durumu her zaman kaldırılır. Delete data on uninstall açıksa modül ayarları ve günlük silinir. Kapalıysa, daha sonra yeniden kurulum için tüm ayarlar saklanır. Wompi ödeme denemeleri ve Awaiting Wompi payment ile Wompi payment on hold sipariş durumları her zaman saklanır; böylece eski bir ödemenin geç gelen olayı yeniden kurulumdan sonra da tanınır. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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