VibeFox Conekta for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

Para birimi: sepet para birimi MXN veya USD olmalıdır. Diğer para birimleri için ödeme yöntemi gizlenir.

Conekta hesabı: Conekta hesabınızın özel API anahtarlarına (test ve canlı) ve Conekta panelinde bir webhook'a ihtiyacınız vardır (bkz. Yapılandırma). Yalnızca özel anahtarlar kullanılır. Ödeme, Conekta tarafından barındırılan ödeme sayfasında gerçekleştiği için genel anahtara gerek yoktur.

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 Conekta Gateway öğesini bulup Configure düğmesine tıklayın.

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

4. Test ve canlı özel anahtarlarınızı girin, modu seçin ve Conekta panelinde webhook'u ekleyin (bkz. Yapılandırma).

5. Enable / Disable seçeneğini açın ve Save düğmesine tıklayın. Test modunda bir ödeme deneyin, ardından Test mode seçeneğini kapatın.

Kurulum sırasında modül iki sipariş durumu oluşturur: Awaiting Conekta payment ve Conekta payment on hold. PrestaShop, tüm para birimleri, ülkeler ve müşteri grupları için yeni bir ödeme modülü sunar. Bunları Payment > Preferences bölümünden sınırlandırabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Conekta Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanların üstünde sayfa, Conekta etkinken geçerli modun özel anahtarı boşsa (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve mağazanın varsayılan para birimi MXN veya USD değilse sizi uyarır. Test modu açıkken sayfada Test modu açık: ödemeler test özel anahtarıyla simüle edilir. uyarısı görünür. Geçerli modun anahtarı olmadan etkin bir ağ geçidini kaydettiğinizde, bir uyarı sizden bunu girmenizi ister.

Conekta

Enable / Disable: Enable Conekta payments ödeme yöntemini açar veya kapatır. Varsayılan: kapalı.

Title: müşterinin ödeme sayfasında gördüğü ödeme yönteminin adı. Ayrıca siparişte kaydedilen ödeme yöntemi adıdır. Varsayılan: Conekta. Zorunlu.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely with card, OXXO cash or SPEI transfer. You will be redirected to Conekta to complete your payment.

Payment methods: Conekta ödeme sayfasında sunulan yöntemler. Varsayılan: card, cash and bank transfer. Nakit, SPEI ve BNPL yalnızca MXN siparişler için kullanılabilir (USD siparişlerinde yalnızca kart kabul edilir) ve Conekta hesabınızda etkinleştirilmelidir. Hiçbiri seçilmezse kart kullanılır ve kaydettiğinizde sayfa sizi uyarır.

Credit / debit card: kartla ödeme.

Cash (OXXO and other stores): müşteri bir referans alır ve bir mağazada nakit öder.

Bank transfer (SPEI): müşteri bir referans alır ve banka havalesiyle öder.

Buy now, pay later (BNPL): Conekta hesabınızda etkinse, bir BNPL seçeneğiyle ödeme.

API anahtarları

Özel anahtarlarınızı Conekta panelinde Developers > API keys altından kopyalayın. Test ve canlı anahtarlar farklıdır.

Test mode: test özel anahtarını kullanır. Gerçek para tahsil edilmez ve ödeme sayfasında ödeme yönteminin altında bir TEST MODE rozeti ile Gerçek bir tahsilat yapılmayacaktır. bildirimi gösterilir. İadeler her zaman, ödemenin yapıldığı modun anahtarını kullanır. Varsayılan: açık.

Test private key: Conekta hesabınızın test modundaki özel API anahtarı.

Live private key: Conekta hesabınızın canlı (production) modundaki özel API anahtarı. Gizli tutun.

Kayıtlı anahtarlar bir daha asla gösterilmez. Alan boş kalır ve Kaydedildi — korumak için boş bırakın. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Clear saved keys: bir anahtarı işaretleyin ve kaldırmak için Save düğmesine tıklayın. Boş bir alan, kayıtlı değeri korur.

Her Conekta siparişi kendi modunu hatırlar: bildirimler ve iadeler eşleşen anahtarı kullanır. Eski test siparişleri açık kaldığı sürece iki anahtarı da dolu tutun.

Webhook

Webhook, mağazanıza ödemeler hakkında bilgi verir; örneğin müşteri Conekta sayfasından ayrıldıktan sonra yapılan OXXO veya SPEI ödemeleri gibi. Conekta panelinde Developers > Webhooks bölümüne gidin ve API keys bölümündeki Webhook alanında gösterilen URL'yi hem test hem de canlı mod için ekleyin. Dostça URL'ler etkinse şöyle görünür: https://your-shop/module/wcp_conekta_gateway/webhook; başında /en/ gibi bir dil kodu da olabilir. URL'yi ayarların gösterdiği gibi birebir kopyalayın.

Şu olayları seçin (ayarlarda da listelenirler):

order.paid: sipariş ödendi.

order.pending_payment: sipariş ödeme bekliyor; örneğin bir OXXO veya SPEI referansı düzenlendiğinde.

order.declined: ödeme reddedildi.

order.expired: ödeme sayfası veya ödeme referansının süresi doldu.

order.canceled: Conekta siparişi iptal edildi.

order.refunded: ödeme iade edildi; örneğin Conekta panelinde.

order.charged_back: müşteri ödemeye itiraz etti (chargeback); modül siparişe bir not ekler.

Webhook içeriği yalnızca modüle hangi Conekta siparişinin değiştiğini bildirir. Her bildirim, siparişin kendi modunun özel anahtarıyla Conekta API'sinden yeniden okunarak doğrulanır; webhook'un Digest imza başlığı kullanılmaz. Bu mağazanın o sepet için oluşturmadığı Conekta siparişlerine ait bildirimler onaylanır ve yok sayılır. Webhook olmadan bir sipariş yalnızca müşteri ödemeden sonra mağazaya döndüğünde veya aynı sepet için bir sonraki ödeme denemesinde oluşturulur.

Gelişmiş

Debug log: API çağrılarını ve bildirimleri modül klasöründeki logs/wc_ckt_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Hatalar ve uyarılar bu anahtar kapalı olsa bile her zaman kaydedilir. Günlükler hiçbir zaman API anahtarlarını veya müşteri iletişim bilgilerini içermez. Varsayılan: kapalı.

Log: günlüğün boyutunu ve en son girişlerini gösterir. Temizlemek için Clear log düğmesine tıklayın.

Delete data on uninstall: açıksa, modül kaldırıldığında ayarlar ve günlük silinir. Conekta işlemleri ve iadeleri, sipariş durumları ve siparişler her zaman korunur; böylece eski siparişler yeniden kurulumdan sonra da onaylanabilir ve iade edilebilir. Varsayılan: kapalı.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Conekta) ve onaylar. Modül, sepet tutarı için sepet para biriminde bir Conekta siparişi oluşturur; ürünler, hediye paketi, indirimler, vergi ve kargo bu siparişe dahil edilir ve müşteri Conekta tarafından barındırılan ödeme sayfasına gönderilir. Ödeme, Conekta sayfasında Order # ve sepet numarası olarak görünür. Müşteri burada izin verilen yöntemlerden biriyle öder. Bu noktada henüz bir sipariş yoktur.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş, yalnızca Conekta ödemeyi onayladıktan sonra ödenmiş olarak işaretlenir: modül, webhook geldiğinde ve müşteri geri döndüğünde siparişi Conekta API'sinden okur. Sipariş o zaman oluşturulur ve müşteri Conekta ile ödemeniz alındı. mesajıyla standart sipariş onay sayfasını görür. Müşteri OXXO veya SPEI seçtiyse ve bir ödeme referansı aldıysa, sipariş Awaiting Conekta payment olarak oluşturulur ve sayfa Conekta ödeme referansınız oluşturuldu. Ödeme alınır alınmaz sipariş onaylanacaktır. mesajını gösterir. Referans daha sonra süresi dolarsa sipariş iptal edilir ve onay sayfası Conekta ile ödemeniz tamamlanmadı. Bu sipariş hakkında bizimle iletişime geçin. mesajını gösterir.

Müşteri geri döndüğünde ödeme henüz onaylanamıyorsa, Ödeme onayı sayfası Ödemenizi Conekta ile onaylıyoruz. Sipariş otomatik olarak güncellenecektir — lütfen tekrar ödeme yapmayın. mesajını ve bir Check again düğmesini gösterir. Webhook geldiği anda siparişi oluşturur.

Ödeme reddedilirse sipariş oluşturulmaz ve müşteri ödeme sayfasına Conekta ödemesi tamamlanmadı. Lütfen tekrar deneyin veya başka bir ödeme yöntemi seçin. mesajıyla döner. Ödeme sayfasının süresi dolmuş veya iptal edilmişse mesaj Conekta ödemesinin süresi doldu veya iptal edildi. Lütfen tekrar deneyin. olur. Sepet korunur. Müşteri tekrar ödeme yaptığında, aynı tutardaki açık bir Conekta ödeme sayfası yeniden kullanılır; aksi halde önceki sayfa, yenisi oluşturulmadan önce Conekta'da iptal edilir, böylece eski bir bağlantı iki kez ödenemez. Önceki sayfa zaten ödenmişse, tekrar tahsilat yapmak yerine sipariş oluşturulur.

Conekta ödemeyi başlatamazsa müşteri, ödeme sayfasında kısa bir mesajla kalır; örneğin Ödeme başlatılamadı. Lütfen birazdan tekrar deneyin veya başka bir ödeme yöntemi seçin. Conekta'nın gönderdiği asgari tutar gibi doğrulama mesajları, Conekta'nın gönderdiği şekilde gösterilir. Teknik neden günlüğe yazılır.

Webhook, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlaması tarafından engellenmez.

Modül yalnızca Conekta sayfasında ödeme kabul eder. Ödeme sayfanızda kart formu yoktur; kayıtlı kart, abonelik, ön provizyon ve tahsilat ya da aylık taksit (MSI) desteği de yoktur.

Siparişler ve iadeler

Sipariş durumları

No order yet: müşteri Conekta'ya yönlendirildi ve ödeme yapmadı, ödeme reddedildi veya Conekta henüz ödemeyi onaylamadı. Yalnızca sepet mevcut.

Payment accepted: Conekta ödemeyi aynı tutar ve para birimiyle onayladı. Ödeme, Conekta tahsilat kimliği işlem kimliği olarak kaydedilir; bir not ödeme yöntemini (örneğin kart markası ve son dört hane, OXXO / nakit veya SPEI havalesi), Conekta siparişini ve tahsilatı gösterir.

Awaiting Conekta payment: müşteri bir OXXO veya SPEI ödeme referansı aldı. Conekta ödemeyi bildirdiğinde sipariş Payment accepted durumuna geçer.

Conekta payment on hold: Conekta'dan alınan tutar veya para birimi sepetle eşleşmiyor (örneğin ödeme başladıktan sonra sepet değiştirildi), mağaza canlı moddayken bir test modu ödemesi geldi (gerçek para tahsil edilmedi) veya ödeme zaten iptal edilmiş bir sipariş için geldi. Not durumu açıklar ve ödeme gerçekte ödenen tutarla kaydedilir. Siparişi kontrol edin, ardından yerine getirin veya ödemeyi iade edin. Conekta'da yalnızca ön provizyonlu olan bir sipariş de beklemeye alınır; Conekta panelinde tahsil etmek veya iptal etmek için bir not eklenir.

Canceled: beklemedeki bir siparişin OXXO veya SPEI referansının süresi doldu veya Conekta siparişi iptal edildi.

Refunded: ödeme modül üzerinden tamamen iade edildi.

Ödenmiş veya iade edilmiş bir sipariş asla geri alınmaz veya yeniden açılmaz. Zaten ödenmiş bir sipariş için başka bir Conekta ödemesi gelirse, bir WARNING notu sizden bunu Conekta panelinde iade etmenizi ister.

Conekta ödeme bloğu

Sipariş sayfasında Conekta siparişini, tahsilatı, ödeme durumunu, ödenen ve iade edilen tutarı, test ödemeleri için bir Test mode rozetini, iade geçmişini ve siparişin Conekta notes bölümünü gösteren bir Conekta payment bloğu bulunur.

İadeler

Conekta payment bloğuna tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via Conekta düğmesine tıklayın. Bu tutar Conekta üzerinden iade edilsin mi? Bu işlem geri alınamaz. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Siparişleri düzenleme yetkisine sahip olmanız gerekir. İadeler, Conekta'nın gerçekte tahsil ettiği tutar ve para birimiyle sınırlıdır; dolayısıyla bir tutar uyuşmazlığından sonra sipariş toplamına değil, müşterinin ödediği tutara kadar iade yapabilirsiniz. İade, ödemeyi içeren Conekta siparişine gönderilir ve ödemenin yapıldığı modun anahtarını kullanır; bu nedenle o anahtarın ayarlanmış olması gerekir. Conekta iadeyi kabul etmezse blok hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade; tutar, mod, Conekta siparişi, iade kimliği ve neden bilgileriyle birlikte iade geçmişine ve notlara eklenir. Tam iade siparişi Refunded durumuna alır. Kısmi iade durumu değiştirmez. İadeler, Conekta ödemeyi bildirdikten sonra kullanılabilir hale gelir.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Conekta üzerinden para göndermez.

Conekta panelinde yapılan iadeler webhook ile gelir ve Conekta'da ve PrestaShop'ta iade edilen tutarla birlikte bir not olarak eklenir. Otomatik olarak kaydedilmezler. Siparişi Refund via Conekta kullanmadan elle güncelleyin. Conekta'nın bildirdiği bir chargeback de not olarak eklenir.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Conekta Gateway lisans bloğu, Modules > Module Manager > VibeFox Conekta Gateway > 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ı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu mağazadan kaldırmak için Remove key düğmelerini gösterir. Bunların altında Product: presta-payment-conekta satırı ve vibefox.net hesabınızı açan Lisansları ve alan adlarını hesabınızda yönetin bağlantısı bulunur. Anahtarı yalnızca modül için Configure yetkisine sahip ç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 bir tarihle birlikte License expired on. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa modül son bilinen durumla çalışmaya devam eder.

Bir anahtar yalnızca bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda 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 anahtar olmadan Conekta, ödeme sayfasında müşterilere gösterilmez. Yine de bir ödeme başlatılırsa müşteri Bu ödeme yöntemi kullanılamıyor. Lütfen başka birini seçin. mesajını görür. PrestaShop mağaza ön yüzü, back office'e giriş yaptığınızı bilmez; bu yüzden ödeme yöntemi sizin için de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ama ödeme sayfasında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır ve iadeler çalışır.

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, ardından haftada bir. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Conekta ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu, geçerli modun özel anahtarının doldurulduğunu (test modunda Test private key, canlı modda Live private key) ve sepet para biriminin MXN veya USD olduğunu kontrol edin. Ayarlar sayfası, anahtar eksikse veya mağaza para birimi desteklenmiyorsa bir uyarı gösterir. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Ödeme yapıldı ama sipariş oluşturulmadı: webhook çalışmıyor. Conekta panelinde, kullandığınız mod (test veya canlı) için webhook'un var olduğunu, URL'sinin ayarlarda gösterilenle birebir aynı olduğunu ve olayların seçili olduğunu kontrol edin. Her bildirim bu anahtarla doğrulandığı için o modun özel anahtarının ayarlanmış olduğunu kontrol edin. Müşteri mağazaya döndüğünde ya da aynı sepeti yeniden ödemeye çalıştığında da sipariş oluşturulur.

Webhook Temporarily unavailable yanıtı veriyor: Conekta API'sine ulaşılamadı, siparişin modunun özel anahtarı eksik, sepet başka bir istek tarafından işleniyordu veya sipariş oluşturulamadı (örneğin modül devre dışıysa). Conekta webhook'u yeniden dener. Nedeni görmek için Log alanına bakın.

Webhook Verification failed, Invalid payload veya Invalid order id yanıtı veriyor: Conekta API siparişi onaylamadı veya bildirim geçerli bir Conekta sipariş olayı değildi.

Webhook Ignored yanıtı veriyor: bildirim, bu mağazanın o sepet için oluşturmadığı bir Conekta siparişine (örneğin başka bir mağazaya veya aynı hesaptaki bir ödeme bağlantısına) ya da siparişten başka bir nesneye ait.

Webhook URL'si tarayıcıda Method not allowed gösteriyor: Bu normaldir. URL yalnızca Conekta'dan gelen istekleri kabul eder.

Müşteri Önceki ödeme denemenizin durumu kontrol edilemedi mesajını görüyor: sepetin önceki Conekta ödeme sayfası okunamadı; çift ödemeyi önlemek için yeni bir sayfa oluşturulmuyor. Birazdan tekrar deneyin.

Müşteri Ödeme ağ geçidi yapılandırılmamış mesajını görüyor: geçerli modun özel anahtarı eksik.

Müşteri Ödeme doğrulanamadı mesajını görüyor: Conekta'dan gelen dönüş bağlantısı sepetle eşleşmedi. Siparişi Conekta panelinde kontrol edin; webhook gerçek bir ödemeyi yine onaylar.

Sipariş Awaiting Conekta payment veya Conekta payment on hold durumunda: sipariş bloğundaki Conekta notes bölümünü okuyun. Müşteri OXXO veya SPEI referansını henüz ödemedi, tutar veya para birimi eşleşmedi, mağaza canlı moddayken bir test modu ödemesi geldi ya da ödeme yalnızca ön provizyonlu.

İade, test veya canlı modla ilgili bir mesajla başarısız oluyor: ödeme bu modda yapıldı ve o modun özel anahtarı ayarlanmamış. Anahtarı girin ve tekrar deneyin.

Geliştiriciler için README, actionWcpConektaSupportedCurrencies, actionWcpConektaOrderRequest, actionWcpConektaAllowedPaymentMethods ve actionWcpConektaRefundReason kancalarını listeler.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Conekta Gateway 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 ayarlar ve günlük silinir. Kapalıysa, daha sonra yeniden kurmak için tüm ayarlar korunur. Conekta işlemleri ve iadeleri ile Awaiting Conekta payment ve Conekta payment on hold sipariş durumları her zaman korunur; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler, ödeme notlarını ve işlem kimliklerini korur.

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