VibeFox ePayco 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) veya ABD doları (USD). Diğer para birimleri için ödeme yöntemi ödeme sayfasında gösterilmez.

ePayco hesabı: ePayco hesabınızın dört anahtarına ihtiyacınız var: P_CUST_ID_CLIENTE, P_KEY, PUBLIC_KEY ve PRIVATE_KEY. Bunlar ePayco panelinde Integrations, API keys altında bulunur. Aynı anahtarlar test ve canlı modda çalışır. Müşterinin kullanabileceği ödeme yöntemleri (kartlar, PSE, nakit ödeme ağları, cüzdanlar), ePayco hesabınızda etkin olanlardır.

Herkese açık web sitesi: mağazanızın onay URL'si internetten erişilebilir olmalı ve bakım modu, güvenlik duvarı veya temel kimlik doğrulama tarafından engellenmemelidir.

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

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

3. Ayarları açın: WooCommerce > Settings > Payments > ePayco > Manage, ya da Eklentiler sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

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

5. Dört ePayco anahtarını girin ve ödeme sayfası türünü seçin (bkz. Yapılandırma).

6. Enable/Disable seçeneğini açın. ePayco test kartlarıyla Test Mode altında bir ödeme deneyin, ardından Test Mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfada: WooCommerce > Settings > Payments > ePayco. Alanların üzerinde sayfa, dört anahtarın tamamı girilmediğinde (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve mağaza para birimi COP veya USD değilse sizi uyarır; test modu açıkken de Test mode is on: customers pay with ePayco test cards and no real money is charged. mesajını gösterir. Ödeme yöntemleri listesinde, dört anahtar girilene kadar ePayco kurulum gerektiriyor olarak işaretlenir.

Genel

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

Title: müşterinin ödeme sayfasında gördüğü ödeme yöntemi adı. Varsayılan: ePayco.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely with ePayco.

ePayco hesap anahtarları

Dört anahtarı ePayco panelinde Integrations, API keys altında bulun. P_CUST_ID_CLIENTE ve P_KEY ödeme onaylarını doğrular; PUBLIC_KEY ve PRIVATE_KEY ödeme oturumlarını oluşturur. Aynı anahtarlar test ve canlı modda çalışır.

Customer ID (P_CUST_ID_CLIENTE): ePayco müşteri kimliğiniz (sayısal).

Secret Key (P_KEY): ePayco ödeme onaylarının imzasını doğrulamak için kullanılır. Gizli tutun.

Public Key (PUBLIC_KEY): ePayco genel API anahtarınız.

Private Key (PRIVATE_KEY): ePayco özel API anahtarınız. Gizli tutun.

Test Mode: Enable test mode ödeme oturumlarını test işlemleri olarak oluşturur. Müşteriler ePayco test kartlarıyla öder ve gerçek para tahsil edilmez. Test işlemleri canlı modda oluşturulan siparişleri hiçbir zaman ödemez. Varsayılan: kapalı.

Ödeme sayfası

Checkout Type: ePayco ödeme sayfasının nasıl açılacağı.

Onay URL'si

Onay URL'si, mağazanıza bir ödemenin sonucunu bildirir. Her ödemeyle birlikte otomatik olarak ePayco'ya gönderilir; bu nedenle ePayco panelinde yapılandırılacak bir şey yoktur. Bölüm URL'yi gösterir; şuna benzer: https://your-site/wc-api/epc_p/. İnternetten erişilebilir olmalı ve bakım modu, güvenlik duvarı veya temel kimlik doğrulama tarafından engellenmemelidir.

Her onay, P_CUST_ID_CLIENTE ve P_KEY ile oluşturulmuş geçerli bir imza taşımalıdır. Geçerli imzası olmayan onaylar reddedilir ve siparişi değiştirmez. Onay olmadan sipariş yalnızca müşteri ödeme yaptıktan sonra mağazaya döndüğünde güncellenir.

Gelişmiş

Logging: Enable logging, API hatalarını ve ödeme onaylarını WooCommerce > Status > Logs bölümüne, kaynak wcp_epayco_payment olarak yazar. Anahtarlar ve müşteri verileri kaydedilmez. Varsayılan: kapalı.

Delete Data on Uninstall: Remove the gateway settings and logs when the plugin is deleted. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Siparişlerde kayıtlı ePayco verileri korunur. Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak ePayco) ve siparişi verir. Eklenti, sipariş para biriminde sipariş toplamı için; sipariş vergileri, sipariş numarası ve fatura adı, adresi, e-posta ve telefonla birlikte bir ePayco ödeme oturumu oluşturur. Ödeme sayfasının dili, sitenin diline göre İspanyolca veya İngilizcedir. Müşteri ardından Thank you for your order. The secure ePayco checkout opens automatically; if it does not, click the button below. mesajını gösteren sipariş ödeme sayfasına gelir. ePayco ödeme sayfası, Checkout Type ayarına göre açılır pencere ya da yönlendirme olarak açılır. Sayfada ayrıca Pay with ePayco düğmesi ve Choose another payment method bağlantısı bulunur. Test modunda sayfa ve ödeme sayfası TEST MODE — use ePayco test cards, no real money is charged. mesajını gösterir.

ePayco ödeme sayfasında müşteri, ePayco hesabınızda etkin olan yöntemlerden biriyle öder. Ardından ePayco onayı mağazanıza gönderir ve müşteriyi geri yönlendirir. Sipariş yalnızca ePayco onayladıktan sonra ödenmiş olarak işaretlenir: imzalı onayla ya da müşteri döndüğünde sunucu tarafından ePayco'ya yapılan bir sorgu ile. Müşterinin dönüşü tek başına hiçbir zaman sipariş ödemez.

Ödeme henüz onaylanmamışsa sipariş alındı sayfası We are waiting for ePayco to confirm your payment. This page does not need to stay open. mesajını gösterir. Bekleyen bir ödeme için (örneğin PSE veya nakit) Your ePayco payment is being confirmed. We will e-mail you as soon as it is approved. mesajını gösterir.

Ödeme reddedilirse müşteri, Your ePayco payment was declined or could not be completed. You can try again or choose another payment method. mesajıyla Pay for order sayfasına geri döner. Müşteri ödeme yapmadan dönerse mesaj The ePayco payment was not completed. If you already paid, the order will be updated as soon as ePayco confirms it; otherwise you can try again. olur.

ePayco ödemeyi başlatamazsa müşteri kısa bir mesaj görür, örneğin We could not connect to ePayco. Please try again in a moment or choose another payment method. Neden sipariş notlarına ve günlüğe eklenir.

Ö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. Müşteriye gösterilen metinler İspanyolcaya çevrilmiştir.

Eklenti yalnızca tek seferlik ödemeleri destekler. WooCommerce'den iade, kayıtlı kart, abonelik veya bölünmüş ödeme yoktur ve bekleyen işlemler için ePayco sorgulanmaz: siparişler ePayco onayı ve müşterinin geri dönüşüyle güncellenir.

Siparişler

Sipariş durumları

Pending payment: müşteri ePayco'ya yönlendirildi ve henüz ödeme yapmadı ya da ePayco ödemeyi henüz onaylamadı.

Processing: ödeme kabul edildi (yalnızca sanal, indirilebilir ürün içeren siparişler WooCommerce varsayılanı olarak Tamamlandı durumuna geçer). Sipariş notu ePayco referansını, durumu, tutarı, ödeme yöntemini ve onay kodunu gösterir. Siparişin işlem kimliği ePayco referansıdır (ref_payco).

On hold, payment pending: ePayco ödemeyi bekliyor veya tutuluyor olarak bildirdi; örneğin bir PSE havalesi ya da nakit ödeme. ePayco ödemeyi onayladığında ya da reddettiğinde sipariş otomatik olarak değişir.

On hold, amount/currency mismatch: ePayco, tutarı veya para birimi siparişten farklı olan bir ödemeyi onayladı. Kargoya vermeden önce işlemi ePayco panelinde kontrol edin.

On hold, payment for a cancelled order: ePayco, sipariş iptal edildikten sonra bir ödemeyi onayladı. Siparişi geri yükleyin veya ödemeyi ePayco'da iade edin.

Failed: ödeme reddedildi, başarısız oldu, süresi doldu, terk edildi, iptal edildi veya dolandırıcılık önleme sistemi tarafından durduruldu. Not, ePayco'nun nedenini gösterir. Müşteri yeniden deneyebilir. Geç gelen bir başarısızlık, ödenmiş bir siparişi asla değiştirmez.

Refunded: ePayco bu siparişin ödemesini iade etti.

Ödenmiş bir sipariş için ePayco başka bir onaylı ödeme bildirirse durum değişmez. Bir not, çift tahsilatı kontrol etmenizi ve gerekirse ePayco'da iade etmenizi ister. Canlı modda verilmiş bir sipariş için yapılan test işlemi ve zaten başka bir siparişe ait olan bir işlem, bir notla yok sayılır.

İadeler: WooCommerce'den yapılan iadeler desteklenmez. Ödemeyi ePayco panelinde iade edin, ardından iadeyi WooCommerce'de Refund manually ile kaydedin.

Lisans anahtarı

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

Etkin bir anahtar olmadan ePayco, ö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 (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece bir 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: zaten başlatılmış ödemeler yine 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

ePayco ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, dört anahtarın girildiğini ve mağaza para biriminin COP veya USD olduğunu kontrol edin. Pay for order sayfasında sipariş para birimi kontrol edilir. Ayarlar sayfası eksik bir şey olduğunda uyarı gösterir.

Ödeme geçti ama sipariş Pending payment durumunda kalıyor: ePayco onayı mağazanıza ulaşmıyor. Ayarlarda gösterilen onay URL'sinin internetten açıldığını ve bakım modu, güvenlik duvarı, bir güvenlik eklentisi ya da temel kimlik doğrulama tarafından engellenmediğini kontrol edin. Logging seçeneğini açın ve WooCommerce > Status > Logs bölümüne, kaynak wcp_epayco_payment olarak bakın. Sipariş, müşteri ödeme yaptıktan sonra mağazaya döndüğünde de güncellenir.

Onay Invalid signature yanıtı veriyor: Customer ID (P_CUST_ID_CLIENTE) veya Secret Key (P_KEY), ödemeyi alan ePayco hesabıyla eşleşmiyor. İkisini de ePayco panelinden yeniden kopyalayın.

Onay Gateway not configured yanıtı veriyor: P_CUST_ID_CLIENTE veya P_KEY boş. Ayarlarda girin.

Onay Busy, retry later yanıtı veriyor: sipariş o anda başka bir istek tarafından güncelleniyordu. ePayco onayı yeniden dener.

Müşteri We could not connect to ePayco mesajını görüyor: ePayco, PUBLIC_KEY ve PRIVATE_KEY'i reddetti. Sipariş notu ePayco'nun yanıtını gösterir. İki anahtarı yeniden kopyalayın.

Müşteri ePayco could not start the payment mesajını görüyor: ePayco ödeme oturumunu oluşturmadı. ePayco hatası için sipariş notunu okuyun.

ePayco ödeme sayfası açılmıyor: müşteri The ePayco checkout could not be loaded. Please reload the page or choose another payment method. mesajını görür. ePayco ödeme betiği sipariş ödeme sayfasında yüklenemedi. Müşteri sayfayı yenileyebilir ya da Choose another payment method seçeneğini kullanabilir.

Bir test ödemesi siparişi ödemedi: test işlemleri canlı modda verilmiş siparişleri hiçbir zaman ödemez. Test siparişini Test Mode açıkken verin.

Sipariş On hold durumunda: sipariş notunu okuyun. ePayco ödemeyi bekliyor olarak bildirdi, onaylanan tutar veya para birimi siparişten farklıydı ya da ödeme sipariş iptal edildikten sonra geldi. Kargoya vermeden önce işlemi ePayco panelinde kontrol edin.

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

Geliştiriciler için: eklenti belgeleri epc_p_supported_currencies (yöntemin sunulduğu para birimleri), epc_p_session_payload (ePayco'ya gönderilen veriler) ve epc_p_icon (ödeme sayfası simgesi) filtrelerini listeler.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları ve günlükler yalnızca Delete Data on Uninstall açıksa kaldırılır. Aksi halde yeniden kurulum için saklanırlar. Siparişlerde kayıtlı ePayco verileri her zaman korunur. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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