VibeFox Conekta for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

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

PHP: 8.0 veya üzeri.

Para birimi: mağaza para birimi MXN veya USD olmalıdır. Diğer para birimlerinde ödeme yöntemi gizlenir.

Conekta hesabı: Conekta hesabınızın Private Key'lerine (test ve canlı) ve Conekta panelinde bir webhook'a ihtiyacınız vardır (bkz. Yapılandırma). Yalnızca Private Key'ler kullanılır. Ödeme Conekta tarafından barındırılan ödeme sayfasında gerçekleştiği için Public Key gerekli değildir.

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 yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. wcp_conekta_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 > Conekta > Manage ya da 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. Test ve canlı Private Key'lerinizi girin, modu seçin ve Conekta panelinde webhook'u ekleyin (bkz. Yapılandırma).

6. Enable / Disable seçeneğini açın ve kaydedin. Test modunda bir ödeme deneyin, ardından Test mode onay kutusunun işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > Conekta. Alanların üzerinde sayfa, Conekta etkin olduğu halde geçerli modun Private Key'i boşsa (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve mağaza para birimi MXN veya USD değilse sizi uyarır. Test modu açıkken sayfa Test mode is on: payments are simulated with the test private key. ifadesini gösterir. Geçerli modun anahtarı olmadan etkin bir ağ geçidini kaydettiğinizde, anahtarı girmenizi isteyen bir hata mesajı görüntülenir.

Genel

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ı. Varsayılan: Conekta.

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: kart, nakit ve banka havalesi. 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.

API anahtarları

Conekta panelinde Developers > API keys bölümünden Private Key'lerinizi kopyalayın. Test ve canlı anahtarlar farklıdır.

Test mode: Enable test mode test Private Key'ini kullanır. Gerçek para tahsil edilmez ve ödeme sayfasında bir TEST MODE rozeti 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 Private Key'i.

Live private key: Conekta hesabınızın canlı (production) modundaki Private Key'i. Gizli tutun.

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

Webhook

Webhook, müşteri Conekta sayfasından ayrıldıktan sonra yapılan ödemeleri (örneğin OXXO veya SPEI ödemeleri) mağazanıza bildirir. Conekta panelinde Developers > Webhooks bölümüne gidin ve bu bölümde gösterilen URL'yi hem test hem de canlı mod için ekleyin. Şuna benzer görünür: https://your-site/wc-api/webhook_wc_conekta/.

Şu olayları seçin:

Webhook içeriği, eklentiye yalnızca hangi Conekta siparişinin değiştiğini bildirir. Her bildirim, o modun Private Key'iyle Conekta API'sinden siparişin yeniden okunmasıyla doğrulanır; webhook Digest imza başlığı kullanılmaz. Bu mağaza tarafından o sipariş için oluşturulmamış Conekta siparişlerine ait bildirimler kabul edilir ve yok sayılır. Webhook olmadan bir sipariş yalnızca müşteri ödemeden sonra mağazaya döndüğünde veya aynı sipariş için bir sonraki ödeme denemesinde onaylanır.

Gelişmiş

Debug log: Log API calls and notifications ayrıntıları WooCommerce > Status > Logs bölümüne, kaynak wcp_conekta_gateway olarak yazar. Hatalar her zaman günlüğe kaydedilir. Günlükler hiçbir zaman API anahtarı veya müşteri iletişim bilgisi içermez. Varsayılan: kapalı.

Delete data on uninstall: Remove the settings, Conekta order references and logs when the plugin is deleted. Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak Conekta) ve siparişi verir. Eklenti, sipariş tutarı için sipariş para biriminde bir Conekta siparişi oluşturur; sipariş kalemleri, kargo, vergiler ve indirimler de dahil edilir ve müşteriyi Conekta tarafından barındırılan ödeme sayfasına yönlendirir. Müşteri burada izin verilen yöntemlerden biriyle öder.

Ödemeden sonra müşteri mağazanıza döner. Sipariş, yalnızca Conekta onayladıktan sonra ödenmiş olarak işaretlenir: eklenti, webhook geldiğinde ve müşteri döndüğünde siparişi Conekta API'sinden okur. Ödeme henüz onaylanamıyorsa, sipariş alındı sayfasında We are confirming your payment with Conekta. The order will be updated automatically — please do not pay again. mesajı gösterilir. Müşteri OXXO veya SPEI seçip bir ödeme referansı aldıysa, sipariş «Beklemede» durumuna geçer ve sayfada Your Conekta payment reference has been issued. The order will be confirmed as soon as the payment is received. mesajı görünür.

Ödeme reddedilirse sipariş «Başarısız» olarak işaretlenir ve müşteri Pay for order sayfasına döner; sayfada The Conekta payment was not completed. Please try again or choose another payment method. mesajı yer alır. Ödeme sayfasının süresi dolduysa veya iptal edildiyse, müşteri The Conekta payment has expired or was cancelled. Please place the order again. mesajını görür. Müşteri bir siparişi yeniden öderse, aynı tutarla açık bir Conekta ödeme sayfası yeniden kullanılır; aksi halde yenisi oluşturulmadan önce önceki sayfa Conekta'da iptal edilir, böylece eski bir bağlantı iki kez ödenemez. Önceki ödeme sayfası zaten ödenmişse, tekrar tahsilat yapmak yerine ödeme kaydedilir.

Conekta ödemeyi başlatamazsa, müşteri kısa bir mesaj görür, örneğin The payment could not be started. Please try again in a moment or choose another payment method. Teknik neden günlüğe yazılır.

Ö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. Metinler İspanyolca (Meksika) diline çevrilmiştir.

Eklenti ödemeleri yalnızca Conekta sayfasında alır. Ödeme sayfanızda kart formu, kayıtlı kart, abonelik, ön provizyon ve tahsilat ya da aylık taksit (MSI) desteği yoktur.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri Conekta'ya yönlendirildi ve henüz ödeme yapmadı. Sipariş notu, Conekta siparişini ve modu gösterir.

Processing: Conekta, ödemeyi aynı tutar ve para birimiyle onayladı (yalnızca sanal, indirilebilir ürün içeren siparişler WooCommerce varsayılanı olarak «Tamamlandı» durumuna geçer). Sipariş notu, ödeme yöntemini (örneğin kart markası ve son dört hane, OXXO / nakit veya SPEI banka havalesi), Conekta siparişini ve tahsilatı gösterir. Siparişin işlem kimliği, Conekta tahsilat kimliğidir (charge ID).

On hold, waiting for OXXO or SPEI: müşteri bir ödeme referansı aldı. Conekta ödemeyi bildirdiğinde sipariş «Hazırlanıyor» durumuna geçer.

On hold after payment: Conekta'dan alınan tutar veya para birimi siparişle eşleşmiyor; mağaza canlı moddayken test modu ödemesi geldi (gerçek para tahsil edilmedi) veya ödeme zaten iptal edilmiş bir sipariş için geldi. Sipariş notu bunu açıklar. Ödemeyi kontrol edin, ardından siparişi tamamlayın veya iade edin. Conekta'da yalnızca ön provizyonlu olan bir sipariş de «Beklemede» durumuna alınır; Conekta panelinde tahsil etmek veya iptal etmek için bir notla birlikte.

Failed: ödeme reddedildi. Not nedeni gösterir. Müşteri tekrar ödeme yapabilir.

Cancelled: geçerli Conekta ödeme sayfasının süresi doldu veya iptal edildi.

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

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Conekta düğmesine tıklayın (düğme ödeme yönteminin başlığını gösterir). Tam ve kısmi iadeler desteklenir. İ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 WooCommerce 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 sipariş notlarına eklenir.

Conekta panelinde yapılan iadeler webhook aracılığıyla gelir ve Conekta'da ve WooCommerce'de iade edilen tutarla birlikte bir not olarak eklenir. Bunlar otomatik olarak WooCommerce iadeleri olarak kaydedilmez. Refund via Conekta kullanmadan manuel olarak kaydedin. Conekta'nın bildirdiği bir chargeback de not olarak eklenir.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu, WooCommerce > Settings > Payments > Conekta sayfasının üst kısmındadır. 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 ve 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 yalnızca bir alan adında çalışır. Anahtarı bir siteden kaldırmak, o sitenin alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan 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 This payment method is not available. Please choose another one. mesajını görür. Oturum açmış mağaza yöneticileri, bir anahtar satın almadan önce eklentiyi kurup test edebilmeniz için ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder ve iadeler çalışır.

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

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 Private Key'inin dolu olduğunu (test modunda Test private key, canlı modda Live private key) ve mağaza para biriminin MXN veya USD olduğunu kontrol edin. Ayarlar sayfası, bu koşulların her biri için bir uyarı gösterir.

Ödeme gerçekleşti, ancak sipariş Pending payment durumunda kalıyor: 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 tam olarak aynı olduğunu ve olayların seçili olduğunu kontrol edin. Her bildirim bu anahtarla doğrulandığı için o modun Private Key'inin ayarlı olduğunu kontrol edin. Müşteri mağazaya döndüğünde veya aynı siparişi tekrar ödemeye çalıştığında sipariş de onaylanır.

Webhook, Temporarily unavailable yanıtını veriyor: Conekta API'sine ulaşılamadı, siparişin modunun Private Key'i eksik veya sipariş başka bir istek tarafından işleniyordu. Conekta webhook'u yeniden dener.

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

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

Müşteri, We could not check the status of your previous payment attempt mesajını görüyor: siparişin önceki Conekta ödeme sayfası okunamadı; bu yüzden çifte ödemeyi önlemek için yenisi oluşturulmuyor. Birazdan tekrar deneyin.

Müşteri, Payment gateway is not configured mesajını görüyor: geçerli modun Private Key'i eksik.

Sipariş On hold durumunda: sipariş notlarını okuyun. Müşteri henüz OXXO veya SPEI referansını ödemedi, tutar veya para birimi eşleşmedi ya da mağaza canlı moddayken test modu ödemesi geldi.

İade, test veya canlı modla ilgili bir mesajla başarısız oluyor: ödeme o modda yapılmıştır ve o modun Private Key'i ayarlı değildir. 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 yuva serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse, yeni alan adı için anahtarı etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Geliştiriciler için: readme, para birimlerinin listesi için wc_ckt_supported_currencies filtresini belirtir.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasında silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları, siparişlerde saklanan Conekta referansları ve günlükler yalnızca Delete data on uninstall seçeneği açıksa kaldırılır. Aksi halde, sonraki bir yeniden kurulum için saklanmaya devam ederler. Mevcut siparişler, ödeme notlarını ve işlem kimliklerini korur.

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