VibeFox 2C2P 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.

2C2P hesabı: 2C2P satıcı hesabınızın Merchant ID ve Secret Key değerlerine ihtiyacınız var. Bunları 2C2P, satıcı hesabınız açıldığında verir. Test (sandbox) ve canlı hesaplar farklı anahtarlara sahiptir. Geliştirici belgelerine ve sandbox test kartlarına developer.2c2p.com adresinden ulaşabilirsiniz.

Para birimi: sepet para birimi modül tarafından desteklenmeli ve 2C2P hesabınızda etkin olmalıdır. Desteklenenler arasında THB, SGD, MYR, PHP, IDR, VND, MMK, KHR, LAK, CNY, HKD, TWD, JPY, KRW, INR, AUD, NZD, USD, EUR ve GBP bulunur. Sepet para birimi desteklenmiyorsa ödeme yöntemi ödeme sayfasında gösterilmez.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar yalnızca bir alan adında çalışır.

Kurulum

1. Yönetim panelinde 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 2C2P 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 girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Sandbox Merchant ID ve Secret Key değerlerinizi girin, Enable/Disable seçeneğini açın, Save düğmesine tıklayın ve bir test siparişi verin.

5. Hazır olduğunuzda canlı bilgileri girin ve Sandbox Mode seçeneğini kapatın.

Kurulumda modül iki sipariş durumu oluşturur: Awaiting 2C2P payment ve 2C2P payment on hold. PrestaShop, yeni ödeme modülünü tüm para birimleri, ülkeler ve müşteri grupları için etkinleştirir. Bunu Payment > Preferences bölümünden sınırlayabilirsiniz. Dönüş ve bildirim adresleri her ödemeyle birlikte gönderilir. 2C2P portalında hiçbir şeyi yapılandırmanız gerekmez.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox 2C2P Payment > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanların üstünde, test modu açık olduğunda sayfa Sandbox mode is active. No real transactions will be processed. uyarısını gösterir. Ağ geçidi etkinken geçerli modun Merchant ID veya Secret Key değeri boşsa ve mağazanın varsayılan para birimi desteklenmiyorsa uyarır. Her iki durumda da ödeme yöntemi ödeme sayfasında gösterilmez. Sandbox Mode kapalıyken kaydederseniz ve bir canlı alan boşsa, modül Please enter your live Merchant ID. veya Please enter your live Secret Key. mesajını gösterir. Ayarlar yine de kaydedilir.

2C2P

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

Title: müşterinin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte de ödeme yöntemi adı olarak kaydedilir. Varsayılan: 2C2P Payment.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely via credit/debit card, e-wallet, or internet banking through 2C2P. Sandbox modunda metne (TEST MODE) eklenir.

Test modu (sandbox)

Sandbox Mode: ödemeleri aşağıdaki sandbox bilgileriyle 2C2P sandbox ortamına (demo2.2c2p.com) gönderir. Varsayılan: açık. Gerçek ödeme almak için kapatın.

Sandbox Merchant ID: 2C2P sandbox Merchant ID'niz.

Sandbox Secret Key: 2C2P sandbox Secret Key'iniz.

Canlı API bilgileri

Sandbox modu kapalıyken kullanılır.

Merchant ID: 2C2P canlı Merchant ID'niz.

Secret Key: 2C2P canlı Secret Key'iniz. Anahtar, tırnak işaretleri ve ters eğik çizgiler dahil, girdiğiniz gibi kaydedilir.

Kaydedilmiş Secret Key değerleri 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 bilgileri temizleme: kaldırmak için Sandbox Secret Key veya Secret Key kutusunu işaretleyin ve Save düğmesine tıklayın. Boş alan, kayıtlı değeri korur.

Sonuçlar her zaman ödemenin yapıldığı modun Merchant ID ve Secret Key değerleriyle doğrulanır. Sandbox modunda başlatılan bir ödeme, canlıya geçtikten sonra da sandbox anahtarıyla doğrulanmaya devam eder; diğer modun anahtarıyla imzalanmış bir sonuç reddedilir.

Ödeme sayfası

Sonuç URL'leri: bilgi amacıyla Frontend return URL ve Backend notification URL adreslerini gösterir. Dostça URL'ler etkinken şu biçimde görünürler: https://your-shop/module/wcp_2c2p_payment/return ve https://your-shop/module/wcp_2c2p_payment/notify; başlarında /en/ gibi bir dil kodu da olabilir. Her ödemeyle otomatik olarak gönderilirler.

Payment Page Language: 2C2P ödeme sayfasının dili. Varsayılan: English.

Redirect API version: 2C2P hesabınızın hâlâ eski 7.0 sürümünü (SHA-1 imzaları) kullandığını söylemediği sürece 8.5'te bırakın. Geçişten önce başlatılan ödemelerin sonuçları yine de doğrulanır.

Order ID prefix: isteğe bağlı, yalnızca harf ve rakam (en fazla 10), örneğin SHOP1. 2C2P, daha önce gördüğü bir sipariş kimliğini reddeder. Birden fazla mağaza aynı 2C2P hesabını paylaştığında ve test merchant hesaplarının paylaşıldığı sandbox ortamında benzersiz bir önek belirleyin. Diğer karakterler kaydetme sırasında uyarıyla birlikte silinir.

Gelişmiş ayarlar

Enable Logging: 2C2P olaylarını modül klasöründeki logs/tc2p_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Kart verileri, gizli anahtarlar, müşteri e-postaları veya ödeme belirteçleri günlüğe yazılmaz. Varsayılan: kapalı. Kapalıyken hatalar dahil hiçbir şey yazılmaz.

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

Delete Data on Uninstall: açıksa modül kaldırıldığında ağ geçidi ayarları ve günlük silinir. 2C2P işlemleri, siparişler ve modülün sipariş durumları her zaman korunur; böylece modül yeniden kurulduktan sonra da eski bir ödemenin geç gelen sonucu işlenir. Varsayılan: kapalı.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak 2C2P Payment) ve onaylar. Sonraki sayfa Thank you for your order. You will be redirected to 2C2P to complete your payment. mesajını gösterir ve kısa bir süre sonra müşteriyi 2C2P ödeme sayfasına yönlendirir. Bu gerçekleşmezse müşteri Pay via 2C2P düğmesine tıklar. Sayfada ayrıca bir Back to checkout düğmesi bulunur. Bu noktada henüz bir sipariş yoktur.

2C2P sayfasında müşteri, 2C2P hesabınızda etkin olan herhangi bir yöntemle öder; örneğin kartlar, e-cüzdanlar, QR ödemeleri, internet bankacılığı veya nakit ödemeler. Modül, sepet toplamını sepet para biriminde, müşterinin e-postasını ve sepetteki ürün adlarını iletir. Ödeme 24 saat içinde tamamlanabilir. Her ödeme denemesi kendi 2C2P sipariş kimliğini alır (isteğe bağlı önekten sonra sepet numarası ve deneme numarası), çünkü 2C2P aynı sipariş kimliğini iki kez kabul etmez.

2C2P sonucu iki kez bildirir: müşterinin tarayıcısı mağazaya döner ve 2C2P sunucudan sunucuya bir bildirim gönderir. İkisi de aynı şekilde işlenir. Sipariş, yalnızca 2C2P geçerli bir imzayla onayladığında ödenmiş olarak işaretlenir. Sonuç ayrıca ödemeye ait olmalıdır: 2C2P sipariş kimliği mağazanız tarafından verilmiş olmalı, denemenin Merchant ID'si ve rastgele belirteci kontrol edilir. Geçerli imzası olmayan sonuçlar reddedilir. Bildirim, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasından etkilenmez.

Başarılı bir ödemeden sonra sipariş oluşturulur ve müşteri Your 2C2P payment has been received. mesajının yer aldığı standart sipariş onay sayfasını görür. Bekleyen bir ödemede sayfa Your 2C2P payment is pending (for example a cash or bank payment that is not made yet). The order will be processed as soon as 2C2P confirms the payment. mesajını gösterir. Beklemeye alınmış bir sipariş için Your payment was received and is being reviewed by the shop. gösterilir. Bekleyen bir ödeme daha sonra iptal edilirse Your 2C2P payment was not completed. Please contact us about this order. görünür.

Ödeme tamamlanmadıysa sipariş oluşturulmaz. Müşteri Payment was not completed. Please try again or choose a different payment method. mesajıyla ödeme sayfasına döner. Sepet korunur ve müşteri yeniden ödeme yapabilir veya başka bir ödeme yöntemi seçebilir. Sonuç doğrulanamazsa müşteri We could not confirm the payment result. If your account was charged, please contact us before paying again. mesajını görür. Ödeme başlatılamazsa, örneğin sepet para birimi desteklenmediği için, mesaj This payment method is currently unavailable for this order. Please contact us or choose another payment method. olur.

Sepetin zaten bir siparişi varsa (ödenmiş veya bekleyen bir ödeme için beklemede), ikinci bir ödeme formu oluşturulmaz. Müşteri sipariş onay sayfasına yönlendirilir.

Modülde PrestaShop'tan iade, kayıtlı kart, yinelenen ödeme veya abonelik, sitenizde kart alanı ve 2C2P PGW 4.x API desteği yoktur.

Siparişler

Sipariş durumları

No order yet: müşteri 2C2P'ye gönderildi ve henüz bir sonuç gelmedi ya da ödeme başarısız oldu. Yalnızca sepet mevcuttur.

Payment accepted: 2C2P başarılı bir ödeme bildirdi (durum 000). Ödeme, 2C2P işlem referansı işlem kimliği olarak kaydedilir. Siparişteki özel bir not; 2C2P işlemini, onay kodunu, tarihi ve ödeme kanalını gösterir.

Awaiting 2C2P payment: ödeme 2C2P'de beklemededir (durum 001), örneğin müşterinin henüz yapmadığı bir nakit ödeme. 2C2P ödemeyi bildirdiğinde sipariş Payment accepted durumuna geçer.

2C2P payment on hold: 2C2P, sipariş toplamından farklı bir tutar veya para birimi bildirdi. Not, alınan ve beklenen değerleri gösterir. Siparişi ve işlemi 2C2P portalında kontrol edin.

Canceled: bekleyen bir ödeme daha sonra reddedildi, iptal edildi veya başarısız oldu (durum 002, 003, 999). Not, durumu ve nedeni gösterir. Daha eski bir denemenin başarısız sonucu, başka bir denemenin oluşturduğu siparişi iptal etmez.

Ödenmiş bir sipariş sonraki bir sonuçla hiçbir zaman değiştirilmez ve iptal edilmiş bir sipariş, tekrarlanan eski bir sonuçla yeniden açılmaz. Zaten ödenmiş bir sipariş için ikinci bir ödeme gelirse sipariş değişmez. Bir not, bunu kontrol etmenizi ve mükerrer ödemeyi 2C2P satıcı portalından iade etmenizi ister.

2C2P ödeme bloğu

Sipariş sayfasında 2C2P sipariş kimliği, işlem, ödeme durumu, kanal, onay kodu, maskelenmiş kart numarası, tarih, kanal yanıtı ve alınan tutarı içeren bir 2C2P payment bloğu ile sandbox ödemeleri için bir Sandbox rozeti gösterilir.

İadeler

PrestaShop'tan yapılan iadeler desteklenmez. Ödemeyi 2C2P satıcı portalından iade edin, ardından iadeyi PrestaShop'ta elle kaydedin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox 2C2P Payment lisans bloğu, Modules > Module Manager > VibeFox 2C2P 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ı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) gösterir ve şu düğmeleri içerir: 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. Bunların altında Product: presta-payment-2c2p 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. Bloğun metinleri yönetim paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini belirtir, örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihli License expired on. 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 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ızdan serbest bırakın.

Etkin bir anahtar olmadan 2C2P, ö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, yönetim paneline giriş yaptığınızı bilmez; bu nedenle ödeme yöntemi sizden de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager içinde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır.

Bir lisansın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

2C2P ö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 bir Merchant ID ile Secret Key'e sahip olduğunu kontrol edin: sandbox modunda sandbox alanları, canlı modda canlı alanlar. Sepet para biriminin desteklendiğini kontrol edin. Ayarlar sayfası her iki durumda da 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ı, ancak sipariş oluşturulmadı: mağazanıza geçerli bir sonuç ulaşmadı. Ödemenin yapıldığı modun Merchant ID ve Secret Key değerlerinin 2C2P hesabınızla eşleştiğini ve Redirect API version ayarının hesabınızla uyumlu olduğunu kontrol edin. Yanlış imzalı veya başka bir Merchant ID'ye ait sonuçlar reddedilir. Enable Logging seçeneğini açın ve Log alanında hash veya Merchant ID mesajlarını arayın. Sunucunuzun 2C2P'den backend bildirim adresine gelen istekleri kabul ettiğini de kontrol edin.

Backend bildirimi 400 FAIL yanıtı veriyor: sonuçta eksik alanlar, yanlış imza, başka bir Merchant ID veya yanlış bir belirteç var. 404 FAIL, 2C2P sipariş kimliğinin bu mağaza tarafından verilmediği anlamına gelir. 503 RETRY, siparişin aynı anda başka bir istek tarafından onaylandığı veya siparişin oluşturulamadığı anlamına gelir (örneğin modül devre dışıysa); 2C2P daha sonra yeniden dener. Nedenini görmek için Enable Logging seçeneğini açın.

Bildirim adresi tarayıcıda FAIL gösteriyor: bu normaldir. Adres yalnızca 2C2P'den gelen POST isteklerini kabul eder.

2C2P, sipariş kimliğinin zaten var olduğunu söylüyor: 2C2P aynı sipariş kimliğini iki kez kabul etmez. Bu, birden fazla mağaza aynı 2C2P hesabını paylaştığında veya demo satıcı hesaplarının birçok geliştirici tarafından paylaşıldığı sandbox ortamında olur. Benzersiz bir Order ID prefix belirleyin.

Ödeme yapıldı, ancak sipariş Awaiting 2C2P payment veya 2C2P payment on hold durumunda: ya ödeme hâlâ 2C2P'de beklemededir (örneğin müşterinin henüz yapmadığı bir nakit ödeme), ya da ödenen tutar veya para birimi siparişle eşleşmemiştir. Sipariş notlarını ve işlemi 2C2P portalında kontrol edin.

Müşteri This payment method is currently unavailable for this order mesajını görüyor: sepet para birimi desteklenmiyor, geçerli modun Merchant ID veya Secret Key değeri boş ya da sepet toplamı sıfır.

Kaydederken Please enter your live Merchant ID veya Please enter your live Secret Key görünüyor: sandbox modu kapalı ve bir canlı alan boş. Canlı bilgileri girin veya Sandbox Mode seçeneğini açık bırakın.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox 2C2P 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 ağ geçidi ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. 2C2P işlemleri ile Awaiting 2C2P payment ve 2C2P payment on hold sipariş durumları her zaman saklanır. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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