VibeFox Pin Payments for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

Pin Payments hesabı: bir Pin Payments satıcı hesabı (Avustralya veya Yeni Zelanda'daki işletmeler için; müşteriler dünyanın her yerinden ödeme yapabilir). Canlı ortam için yayınlanabilir anahtarına ve gizli anahtarına, test için ise test ortamının anahtarlarına ihtiyacınız vardır. Webhook gizli anahtarı gerekmez: modül webhook kullanmaz. Kart bilgileri müşterinin tarayıcısından Pin.js aracılığıyla doğrudan Pin Payments'a gönderilir ve mağazanıza hiçbir zaman ulaşmaz; bu nedenle mağaza PCI SAQ A-EP kapsamına girer.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek 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 tamamlanınca Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Pin Payments Gateway 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. Pin Payments panelinde Account > API Keys bölümünü açın ve test anahtarlarınızı Test publishable key ve Test secret key alanlarına kopyalayın. Test mode seçeneğini açık bırakın, Enable/Disable seçeneğini açın ve Save düğmesine tıklayın.

5. Bir Pin Payments test kartıyla deneme siparişi verin. Her şey çalıştığında canlı anahtarları girin, Test mode seçeneğini kapatın ve kaydedin.

Kurulumda modül Pin Payments payment on hold sipariş durumunu oluşturur. PrestaShop, kurulum sırasında etkin olan para birimleri, müşteri grupları ve ülkeler için yeni bir ödeme modülü sunar. Bunu Payment > Preferences bölümünde değiştirebilirsiniz; daha sonra etkinleştirdiğiniz ülkelerin orada işaretlenmesi gerekir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Pin Payments 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; test modu açıkken bir uyarı, geçerli modun yayınlanabilir anahtarı veya gizli anahtarı boşsa bir hata, ve Pin Payments mağazanın varsayılan para birimini desteklemiyorsa bir hata gösterir (desteklenen para birimlerinin listesiyle birlikte). Geçerli modun iki anahtarı olmadan ödeme yöntemi ödeme sayfasında gizlenir. Boş bir Title kaydedilmez: sayfa Enter a title for the payment method. mesajını gösterir.

Pin Payments

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Credit card (Pin Payments). Zorunlu.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay with your credit card via Pin Payments.

API anahtarları

Anahtarlarınızı Pin Payments panelinde Account > API Keys altında bulabilirsiniz. Test anahtarları yalnızca test API'siyle, canlı anahtarlar yalnızca canlı API'yle çalışır. Yayınlanabilir anahtar, müşterinin tarayıcısında Pin.js tarafından kullanılır. Gizli anahtar sunucunuzdan asla ayrılmaz.

Test mode: Pin Payments test ortamını (test-api.pinpayments.com) ve test anahtarlarını kullanır. Gerçek tahsilat yapılmaz; müşteriler ödeme yönteminin altında TEST MODE — no real charges will be made. ifadesini görür. Kapalıyken canlı API ve canlı anahtarlar kullanılır. Varsayılan: açık.

Test publishable key: Pin Payments test hesabınızın yayınlanabilir anahtarı.

Test secret key: Pin Payments test hesabınızın gizli anahtarı.

Live publishable key: Pin Payments canlı hesabınızın yayınlanabilir anahtarı.

Live secret key: Pin Payments canlı hesabınızın gizli anahtarı.

Anahtarların çevresindeki boşluklar kaldırılır. Kaydedilmiş 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.

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

Gelişmiş

Debug log: modül klasöründeki logs/wc_ppg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar her zaman günlüğe yazılır; her API çağrısını da kaydetmek için bunu açın. Kart verileri, API anahtarları ve müşteri kişisel verileri hiçbir zaman günlüğe yazılmaz. Varsayılan: kapalı.

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 gateway ayarları ve günlük silinir. Siparişlerin ödeme verileri (tahsilatlar ve iadeler) ile Pin Payments payment on hold sipariş durumu her zaman korunur. Varsayılan: kapalı.

Ödeme sayfası

Ödeme yöntemi; etkinleştirildiğinde, geçerli modun iki anahtarı da girildiğinde, sepet para birimi desteklenen 14 para biriminden biri olduğunda (AUD, USD, NZD, SGD, EUR, GBP, CAD, HKD, JPY, MYR, THB, PHP, ZAR, IDR) ve modül Payment > Preferences bölümünde sepete izin verildiğinde gösterilir.

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit card (Pin Payments), Visa, Mastercard ve American Express simgeleriyle) ve Card number, Expiry (MM / YY), CVC ve Name on card alanlarını doldurur. Gönderimden önce form; kart numarasının uzunluğunu, son kullanma ayını ve yılını, 3 veya 4 haneli CVC'yi ve adı kontrol eder.

Müşteri siparişi verdiğinde Pin.js kart bilgilerini ve sepetin fatura adresini tarayıcıdan doğrudan Pin Payments'a gönderir ve tek kullanımlık bir kart jetonu alır. Mağazanıza yalnızca bu jeton gönderilir. Ardından modül, sepet para biriminde sepet toplamı için müşterinin e-postası ve <shop name> - Cart <cart number> açıklamasıyla yakalanmış bir tahsilat oluşturur. Pin Payments aynı istekte yanıt verir. Bu yanıttan önce sipariş yoktur.

Başarılı bir tahsilattan sonra sipariş oluşturulur ve müşteri standart sipariş onay sayfasını görür: Your card payment has been received. Sipariş Pin Payments payment on hold durumuna geçtiyse sayfa Your card payment has been received and is being reviewed. We will update your order as soon as the review is complete. mesajını gösterir.

Pin Payments yanıt vermezse (zaman aşımı, sunucu hatası, okunamayan yanıt), yine de bir tahsilat oluşmuş olabilir. Bu durumda sipariş ödeme olmadan Pin Payments payment on hold durumunda oluşturulur ve onay sayfası We could not confirm your payment with Pin Payments. Please check your e-mail and card statement before paying again, or contact us. mesajını gösterir. Aynı sepetin yeniden gönderilmesi asla ikinci bir tahsilat oluşturmaz.

Sepet başına aynı anda yalnızca bir ödeme denemesi çalışır. İkinci bir gönderim This order is already being paid. Please wait a moment and check your e-mail before trying again. mesajını alır. Zaten siparişi olan bir sepet veya parayı tahsil etmiş ya da etmiş olabilecek önceki bir deneme yeniden tahsil edilmez; bunun yerine sipariş o denemeden oluşturulur. Bir kart jetonu yalnızca bir kez kullanılabilir: başarısız bir denemeden sonra veya müşteri kart bilgilerini değiştirdiğinde yeni bir jeton oluşturulur.

Ödeme başarısız olduğunda sipariş oluşturulmaz. Müşteri ödeme adımında kalır, sepet korunur ve şu mesajlardan biri gösterilir: Your card was declined. Please use another card or contact your bank.; Your card has insufficient funds. Please use another card.; Your card has expired. Please use another card.; The card security code (CVC) is incorrect.; This card type is not accepted. Please use Visa, Mastercard or American Express.; Payment failed: Pin Payments'in reddedilen bilgiler için verdiği nedenle birlikte; Your card details have expired. Please enter them again and retry. jeton kullanılamadığında; The secure card form could not be loaded. Please reload the page or choose another payment method. Pin.js yüklenmediğinde; Card payments are temporarily unavailable. Please try again later or choose another payment method. Pin Payments gizli anahtarı reddettiğinde; Your payment could not be processed. Please try again or choose another payment method. diğer hatalarda. Teknik neden günlüğe yazılır.

Modülün 3-D Secure akışı yoktur. Pin Payments hesabınız 3-D Secure gerektiriyorsa tahsilat beklemede kalır, sipariş oluşturulmaz ve müşteri Your card payment could not be completed (additional verification is required). Please try another card or another payment method. mesajını görür. Tahsilatın sonradan yapıldığı yalnızca yetkilendirme modu, kayıtlı kart, abonelik, Apple Pay veya Google Pay ve webhook yoktur.

Siparişler ve iadeler

Sipariş durumları

No order yet: kart reddedildi, tahsilat 3-D Secure gerektirdi veya müşteri ödeme yapmadı. Yalnızca sepet vardır.

Payment accepted: Pin Payments, sepet tutarı ve para birimiyle tam olarak eşleşen, başarılı ve yakalanmış bir tahsilat bildirdi. Ödeme, Pin Payments tahsilat jetonu işlem kimliği olarak kaydedilir; bir not tutarı ve tahsilat jetonunu gösterir (test ödemeleri için TEST MODE de).

Pin Payments payment on hold: tahsilatın incelemenize ihtiyacı var. Not nedenini açıklar: Pin Payments sepetten farklı bir tutar veya para birimi tahsil etti (tahsil edilen tutarın ödemesi kaydedilir), ödeme sırasında sepet değişti, tahsilat yetkilendirildi ama yakalanmadı (Pin Payments panelinde yakalayın, sonra siparişi Ödeme kabul edildi durumuna getirin) veya Pin Payments açık bir yanıt vermedi (ödeme kaydedilmez; sipariş kargoya verilmeden önce Pin Payments panelinde tahsilat açıklamasını arayın).

Refunded: tahsilat modül üzerinden tamamen iade edildi.

Zaten siparişi olan bir sepet için ikinci bir tahsilat yapılırsa sipariş değişmez. Bir not, bunu kontrol edip Pin Payments panelinden iade etmenizi ister.

Pin Payments bloğu

Sipariş sayfasında, test ödemeleri için bir Test mode rozeti, tahsilat jetonu, durum, kart markası ve son dört hane, tahsil edilen tutar, sipariş toplamı ve iade edilen tutar, Description at Pin Payments, iade geçmişi ve siparişin Pin Payments notes bölümünü içeren bir Pin Payments bloğu görünür.

İadeler

Pin Payments bloğunda tutarı girin (henüz iade edilmeyen tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via Pin Payments düğmesine tıklayın. Refund this amount through Pin Payments? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Siparişleri düzenleme yetkisine sahip olmanız gerekir. İadeler, Pin Payments'ın gerçekte tahsil ettiği tutar ve para birimiyle sınırlıdır; bu nedenle tutar veya para birimi uyuşmazlığından sonra sipariş toplamına değil, müşterinin ödediği tutara kadar iade yapabilirsiniz. İade, siparişin ödendiği ortama (test veya canlı) gönderilir; bu nedenle o modun gizli anahtarı girilmiş olmalıdır. Pin Payments iadeleri eşzamansız işler, bu yüzden durum genellikle Beklemede olur. Başarılı bir istek, Pin Payments iade jetonu ve durumuyla birlikte iade geçmişine ve notlara eklenir. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez. Pin Payments iadeyi reddeder veya yanıt vermezse blok hatayı gösterir ve iade kaydedilmez.

Siparişte kayıtlı bir tahsilat yoksa (Pin Payments açık bir yanıt vermedi), blokta iade formu gösterilmez ve Pin Payments panelinde hangi açıklamayı aramanız gerektiği bildirilir.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Pin Payments üzerinden para geri göndermez. Pin Payments panelinde yapılan iadeler PrestaShop'a geri senkronize edilmez; bu nedenle iadeleri sipariş sayfasından yapın.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu License — VibeFox Pin Payments Gateway başlığıyla, Modules > Module Manager > VibeFox Pin Payments Gateway > 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 hangi tarihe kadar etkin olduğunu ve alan adınızı) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: presta-payment-pinpayments 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 gösterir; örneğin Key not found, This key belongs to another product, Domain limit reached veya License expired on ile birlikte bir tarih. 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 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 Pin Payments ö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ü anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında deneyemezsiniz. Modules > Module Manager içinde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: iadeler, daha önce ödenmiş siparişler için çalışmaya devam eder.

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

Sorun giderme

Pin Payments ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modun iki anahtarının da doldurulduğunu (test modunda Test publishable key ve Test secret key, aksi halde canlı anahtarlar) ve sepet para biriminin desteklenen 14 para biriminden biri olduğunu kontrol edin. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşteri grubu için izinli olduğunu kontrol edin. Ayarlar sayfası, eksik anahtarlar ve desteklenmeyen mağaza para birimi için bir hata gösterir.

Ödeme gerçekleşti, ancak sipariş Pin Payments payment on hold durumunda: Pin Payments bloğundaki notları okuyun (bkz. Sipariş durumları). Pin Payments açık bir yanıt vermediyse, Pin Payments panelinde <shop name> - Cart <cart number> açıklamasına sahip bir tahsilat arayın, ardından siparişi kargoya verin veya tahsilatı panelden iade edin.

Müşteri şunu görür: Your payment was received, but the order could not be completed automatically: kart tahsil edildi, ancak PrestaShop siparişi oluşturamadı (örneğin bu arada modül devre dışı bırakıldığı için). Neden günlükte. Müşteriden tekrar ödeme yapmaması istenir; aynı sepetin yeniden gönderilmesi, yeni bir tahsilat olmadan siparişi oluşturur.

Müşteriler şunu görür: Card payments are temporarily unavailable: Pin Payments gizli anahtarı reddetti veya geçerli modun anahtarı eksik. Test anahtarları yalnızca test modunda, canlı anahtarlar yalnızca canlı modda çalışır. Günlük nedeni gösterir.

Siparişler şu hatayla başarısız oluyor: additional verification is required: Pin Payments hesabınız, modülün desteklemediği 3-D Secure gerektiriyor. Pin Payments'tan zorunlu 3-D Secure'u kapatmasını isteyin.

Güvenli kart formu yüklenemedi: Pin Payments CDN'inden gelen Pin.js tarayıcıda yüklenmedi; örneğin bir script engelleyici veya betikleri birleştiren ya da değiştiren bir modül nedeniyle. Ödeme sayfasını bu tür optimizasyonların dışında tutun.

Pin Payments yanıt vermedi: kart jetonu tarayıcıda 30 saniye içinde oluşturulmadı. Müşteri bağlantıyı kontrol edip yeniden deneyebilir; hiçbir şey tahsil edilmedi.

Ödeme, bir Pin Payments nedeniyle başarısız oldu: Pin Payments tahsilat bilgilerini reddetti; örneğin tutar, para birimi için minimum tahsilatın altında. Müşteri nedeni görür, günlükte ise hata kodu bulunur.

İade başarısız oluyor: bloktaki mesajı okuyun. TEST veya LIVE modu hakkındaki bir mesaj, siparişin ödendiği modun gizli anahtarının boş olduğu anlamına gelir. Pin Payments did not confirm the refund yanıt gelmediği anlamına gelir; tekrar denemeden önce Pin Payments panelinde tahsilatı kontrol edin. at most tahsilattan hâlâ iade edilebilecek tutarı gösterir.

Test ödemeleri: test modu test ortamını ve test anahtarlarını kullanır. Pin Payments geliştirici dokümantasyonundaki test kartlarını kullanın; örneğin 4200 0000 0000 0000 (başarılı) veya 4100 0000 0000 0001 (reddedilen), gelecekteki herhangi bir son kullanma tarihi ve herhangi bir CVC ile. Siparişler ödendikleri modu korur; bu nedenle modları değiştirdikten sonra iadeler doğru ortama gider.

Hataları nerede bulabilirsiniz: hatalar her zaman günlüğe yazılır; modül sayfasındaki Log alanına bakın. Her API çağrısını görmek için Debug log seçeneğini açın.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Pin Payments 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 silinir. Delete data on uninstall açıksa gateway ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için korunur. Pin Payments tahsilatları ve iadeleri ile Pin Payments payment on hold sipariş durumu 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.

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