VibeFox ePayco for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül eski PHP sürümlerinde kurulmayı reddeder.

Para birimi: Kolombiya pesosu (COP) veya ABD doları (USD). Diğer para birimlerindeki sepetlerde ödeme yöntemi ödeme sayfasında gizlenir.

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 da çalışır. Müşterinin kullanabileceği ödeme yöntemleri (kartlar, PSE, nakit ödeme ağları, cüzdanlar), ePayco hesabınızda etkin olan yöntemlerdir.

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

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 bittiğinde Configure düğmesine tıklayın ya da daha sonra modül listesinde VibeFox ePayco Payment öğesini 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 girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

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

5. Enable/Disable seçeneğini etkinleştirin ve Save düğmesine tıklayın. Test Mode açıkken ve ePayco test kartlarıyla bir ödeme deneyin, ardından Test Mode seçeneğini kapatın.

Kurulumda modül iki sipariş durumu oluşturur: Awaiting ePayco payment ve ePayco payment on hold. PrestaShop, yeni ödeme modülünü tüm para birimleri, ülkeler ve müşteri grupları için sunar. Bunu Payment > Preferences bölümünden sınırlayabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox ePayco Payment > Configure. Her bölümün kendi Save düğmesi vardır ve tüm sayfayı kaydeder. Alanların üstünde sayfa, dört anahtar girilmediğinde (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve mağazanızın varsayılan para birimi COP veya USD değilse uyarır; test modu açıkken de Test mode is on: customers pay with ePayco test cards and no real money is charged. ifadesini gösterir.

ePayco

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yönteminin adı. Siparişte kaydedilen ödeme yöntemi adı da budur. 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 bulabilirsiniz. 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 da ç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 herkese açık API anahtarınız.

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

Kayıtlı gizli anahtarlar bir daha gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Kayıtlı gizli anahtarları temizleme: Secret Key (P_KEY) veya Private Key (PRIVATE_KEY) kutusunu işaretleyin ve anahtarı kaldırmak için Save düğmesine tıklayın. Boş bir alan kayıtlı değeri korur.

Test Mode: ödeme oturumları test işlemleri olarak oluşturulur. Müşteriler ePayco test kartlarıyla öder ve gerçek para tahsil edilmez. Test işlemleri, canlı modda oluşturulmuş siparişleri asla ödemez. Varsayılan: kapalı. Açıkken müşteriler ödeme yönteminin altında ve ödeme sayfasında TEST MODE — use ePayco test cards, no real money is charged. ifadesini görür.

Ödeme sayfası

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

Onay URL'si

Onay URL'si, bir ödemenin sonucunu mağazanıza bildirir. Her ödemede ePayco'ya otomatik olarak gönderilir; bu yüzden ePayco panelinde yapılandırılacak bir şey yoktur. Bu bölüm URL'yi gösterir. Kullanıcı dostu URL'lerle şu biçimdedir: https://your-shop/module/wcp_epayco_payment/confirmation, başında /en/ gibi bir dil kodu da olabilir. İnternetten erişilebilir olmalı ve bir güvenlik duvarı veya temel kimlik doğrulama tarafından engellenmemelidir. Mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez.

Her onayın, P_CUST_ID_CLIENTE ve P_KEY bilgilerinizle oluşturulmuş geçerli bir imzası olmalıdır. Geçerli imzası olmayan onaylar reddedilir ve hiçbir şeyi değiştirmez. Onay olmadan bir sipariş yalnızca müşteri ödemeden sonra mağazaya döndüğünde oluşturulur.

Gelişmiş

Logging: API hatalarını ve ödeme onaylarını modül klasöründeki logs/epc_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Anahtarlar ve müşteri verileri kaydedilmez. Varsayılan: kapalı. Hatalar, kapalıyken bile her zaman kaydedilir.

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

Delete Data on Uninstall: açıkken modülü kaldırmak, modül ayarlarını ve günlüğü siler. Siparişler için kaydedilen ePayco verileri ve modülün sipariş durumları her zaman kalır, böylece mevcut siparişler çalışmaya devam eder. Varsayılan: kapalı.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini (varsayılan olarak ePayco) seçer ve onaylar. Modül, sepet toplamı için sepet para biriminde bir ePayco ödeme oturumu oluşturur; vergiler, sepet numarası ile fatura adı, adres, e-posta ve telefon bilgileri de eklenir. Ödeme ePayco'da Cart # ve sepet numarası olarak görünür. Ödeme sayfası dili, mağaza diline göre İspanyolca veya İngilizcedir. Bu noktada henüz bir sipariş yoktur.

Ardından müşteri, ePayco payment sayfasını görür; sayfada Thank you for your order. The secure ePayco checkout opens automatically; if it does not, click the button below. ifadesi yer alır. ePayco ödeme sayfası, Checkout Type ayarına bağlı olarak açılır pencere veya yönlendirme olarak açılır. Sayfada ayrıca Pay with ePayco düğmesi ve Choose another payment method bağlantısı bulunur. Ödeme düğmesine her tıklamada yeni bir ePayco oturumu oluşturulur.

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ığında ödenmiş olarak işaretlenir: imzalı onayla ya da müşteri döndüğünde ePayco'ya yapılan sunucu tarafı bir sorguyla. Müşterinin geri dönmesi tek başına hiçbir zaman bir siparişi ödemez. Sipariş bundan sonra oluşturulur ve müşteri standart sipariş onay sayfasını görür.

Bekleyen bir ödeme için (örneğin PSE veya nakit) sipariş Awaiting ePayco payment durumunda oluşturulur ve onay sayfasında Your ePayco payment is being confirmed. We will e-mail you as soon as it is approved. ifadesi görünür. Bekleyen ödeme daha sonra reddedilir veya süresi dolarsa sayfada Your ePayco payment was not completed. Please contact us about this order. görünür. Müşteri geri döndüğünde ePayco ödemeyi henüz onaylamadıysa, Payment confirmation sayfasında We are waiting for ePayco to confirm your payment. This page does not need to stay open. ifadesi ve Check again düğmesi gösterilir.

Ödeme reddedildiyse müşteri, Your ePayco payment was declined or could not be completed. You can try again or choose another payment method. mesajıyla ödeme sayfasına döner. Müşteri ödeme yapmadan geri dönerse mesaj şudur: 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. Sepet korunur ve sipariş oluşturulmaz.

ePayco ödemeyi başlatamazsa müşteri ödeme sayfasında kalır ve örneğin We could not connect to ePayco. Please try again in a moment or choose another payment method. gibi kısa bir mesaj görür. Teknik neden günlüğe yazılır.

Modül yalnızca tek seferlik ödemeleri destekler. Mağazadan iade, kayıtlı kart, abonelik veya bölünmüş ödeme desteği yoktur ve bekleyen işlemler için ePayco periyodik olarak sorgulanmaz: siparişler ePayco onayı ve müşterinin geri dönüşüyle güncellenir.

Siparişler

Sipariş durumları

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

Payment accepted: ePayco ödemeyi onayladı. Ödeme, ePayco referansı (ref_payco) ile işlem kimliği olarak kaydedilir; bir not referansı, durumu, tutarı, ödeme yöntemini ve onay kodunu gösterir.

Awaiting ePayco payment: ePayco ödemeyi beklemede veya tutuluyor olarak bildirdi; örneğin bir PSE havalesi veya nakit ödeme. ePayco ödemeyi onayladığında veya reddettiğinde sipariş otomatik olarak değişir.

ePayco payment on hold: ePayco, tutarı veya para birimi siparişten farklı olan bir ödemeyi onayladı (örneğin ödeme başladıktan sonra sepet değiştirildi) ya da sipariş iptal edildikten sonra bir ödemeyi onayladı. Para birimi eşleşiyorsa gerçekte ödenen tutar siparişe kaydedilir. Ürünü göndermeden önce ePayco panelinde işlemi kontrol edin.

Payment error: bekleyen bir ödeme reddedildi, başarısız oldu, süresi doldu veya iptal edildi. Not, ePayco'nun nedenini gösterir. Sepet için yeni bir onaylı ödeme hâlâ siparişi öder. Geç gelen bir başarısızlık, ödenmiş bir siparişi hiçbir zaman değiştirmez.

Refunded: ePayco, bu siparişin ödemesini geri aldı.

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

ePayco ödeme bloğu

Sipariş sayfasında ePayco payment bloğu bulunur; bu blokta ePayco referansı (ref_payco), işlem kimliği, durum, ödeme yöntemi, onay kodu, işlem tarihi, test ödemeleri için Test mode rozeti ve siparişin ePayco notes bilgileri gösterilir. ePayco payment on hold durumundaki bir sipariş için blok, göndermeden önce işlemi kontrol etme uyarısı gösterir.

İadeler

Mağazadan yapılan iadeler desteklenmez. Ödemeyi ePayco panelinde iade edin, ardından gerekirse siparişi PrestaShop'ta elle güncelleyin. ePayco'nun bildirdiği ödeme işleminin tersine çevrilmesi siparişi Refunded durumuna getirir.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu License — VibeFox ePayco Payment, Modules > Module Manager > VibeFox ePayco Payment > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin 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 şu düğmeleri gösterir: durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key, anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-payment-epayco satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure izni olan çalışanlar değiştirebilir. Bloktaki metinler 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 veya 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 tek 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ı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. PrestaShop vitrini, 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, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: başlatılmış ödemeler yine de onaylanır.

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

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 sepet para biriminin COP veya USD olduğunu kontrol edin. Ayarlar sayfası, anahtarlar eksik olduğunda 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 gerçekleşti ama sipariş oluşturulmadı: ePayco onayı mağazanıza ulaşmıyor. Ayarlarda gösterilen onay URL'sinin internetten açıldığını ve bir güvenlik duvarı, güvenlik modülü veya temel kimlik doğrulama tarafından engellenmediğini kontrol edin. Modül sayfasındaki Log alanına bakın; her onayı görmek için Logging seçeneğini açın. Müşteri ödemeden sonra mağazaya döndüğünde sipariş de oluşturulur.

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. Her ikisini de ePayco panelinden yeniden kopyalayın.

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

Onay «Order not found» yanıtı veriyor: onay, bu mağazaya ait bir ePayco ödemesi olmayan bir sepeti ifade ediyor.

Onay «Busy, retry later» yanıtı veriyor: sipariş tam o sırada başka bir istek tarafından güncelleniyordu veya sipariş oluşturulamadı (örneğin modül devre dışı). ePayco onayı yeniden dener. Neden günlükte yazılıdır.

Müşteri «We could not connect to ePayco» mesajını görüyor: ePayco, PUBLIC_KEY ve PRIVATE_KEY'i reddetti. Günlük, ePayco yanıtını gösterir. Her iki anahtarı yeniden kopyalayın.

Müşteri «ePayco could not start the payment» mesajını görüyor: ePayco ödeme oturumunu oluşturmadı. Hata için günlükteki ePayco hatasını 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 sayfası betiği, ödeme sayfasında yüklenemedi. Müşteri sayfayı yenileyebilir veya Choose another payment method seçeneğini kullanabilir.

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

Sipariş ePayco payment on hold durumunda: ePayco payment bloğundaki notları okuyun (bkz. Sipariş durumları) ve göndermeden önce işlemi ePayco panelinde kontrol edin.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox ePayco 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 tüm ayarlar sonraki bir yeniden kurulum için saklanır. Siparişler için kaydedilen ePayco verileri ile Awaiting ePayco payment ve ePayco payment on hold sipariş durumları her zaman korunur. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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