VibeFox Pin Payments for OpenCart — Yardım
Gereksinimler
OpenCart: 3.0.x (3.0.5.0 sürümünde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 sürümünde test edildi).
PHP: 8.0 veya üzeri.
Pin Payments hesabı: bir Pin Payments satıcı hesabı (Avustralya veya Yeni Zelanda'daki işletmeler için; müşteriler dünyanın neresinden olursa olsun ödeme yapabilir). Canlı mod için ve testler için test ortamı için yayımlanabilir anahtarına (publishable key) ve gizli anahtarına (secret key) ihtiyacınız vardır. Webhook gizli anahtarı gerekmez: uzantı webhook kullanmaz. Kart bilgileri Pin.js aracılığıyla müşterinin tarayıcısından doğrudan Pin Payments'e gönderilir ve mağazanıza hiçbir zaman ulaşmaz; bu nedenle mağaza PCI SAQ A-EP kapsamına girer.
Para birimi: AUD, USD, NZD, SGD, EUR, GBP, CAD, HKD, JPY, MYR, THB, PHP, ZAR veya IDR. Sipariş kendi para biriminde tahsil edilir.
VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek bir alan adında çalışır.
Kurulum
İndirme dosyası, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_pinpayments_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_pinpayments_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüz için olan paketi kurun. Lisans anahtarı her iki sürüm için de aynıdır.
OpenCart 3
1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_pinpayments_gateway-oc3-(version).ocmod.zip dosyasını seçin. Uzantının OCMOD değişikliği yoktur, bu yüzden Extensions > Modifications bölümünü yenilemeniz gerekmez. Yükleyici yerine, bu paketin upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.
2. Extensions > Extensions bölümüne gidin ve Payments türünü seçin. VibeFox Pin Payments Gateway öğesini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme uzantıları listesini değiştirme iznine sahip olması gerekir.
3. Ayarlar sayfasını açmak için Edit düğmesine (kalem simgeli düğme) tıklayın. VibeFox lisans anahtarınızı, sayfanın üst kısmındaki lisans bloğunda License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. License key).
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 tutun, Enable/Disable seçeneğini açın ve Save düğmesine tıklayın.
5. Bir Pin Payments test kartıyla test siparişi verin. Her şey çalıştığında canlı anahtarları girin, Test mode seçeneğini kapatın ve kaydedin.
OpenCart 4
1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_pinpayments_gateway.ocmod.zip dosyasını seçin. Dosya adını değiştirmeyin: OpenCart 4 uzantı kodunu dosya adından alır ve adı değiştirilmiş bir paket çalışmaz.
2. Paket, aynı sayfadaki kurulu uzantılar listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.
3. Extensions > Extensions bölümüne gidin ve Payments türünü seçin. VibeFox Pin Payments Gateway öğesini bulun, Install düğmesine (yeşil + düğmesi) tıklayın, ardından Edit düğmesine (kalem simgeli düğme) tıklayın.
4. Lisans anahtarını ve Pin Payments anahtarlarını OpenCart 3 için 3 ila 5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır.
Yeni bir kurulum, ödeme yöntemi kapalı ve test modu açık olarak başlar.
Yapılandırma
Tüm ayarlar uzantı sayfasındadır: Extensions > Extensions > Payments > VibeFox Pin Payments Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa, test modu açıkken Pin Payments TEST MODUNDA: test API'si ve test anahtarları kullanılır, gerçek tahsilat yapılmaz. mesajını gösterir; geçerli modun yayımlanabilir veya gizli anahtarı boşken bir hata gösterir (bu durumda ödeme yöntemi ödeme sayfasında gizlenir); ve Pin Payments mağazanın varsayılan para birimini desteklemediğinde bir hata gösterir (desteklenen para birimlerinin listesiyle birlikte). Uzantıyı değiştirme izniniz yoksa sayfa ayarları gösterir ama kaydedemez.
Kaydetme sırasında bir alan hatalıysa hiçbir şey kaydedilmez: Title boş olamaz (Ödeme yöntemi için bir başlık girin (en fazla 128 karakter).), Sort Order tam sayı olmalıdır (negatif değerlere izin verilir), Total 0 veya daha büyük bir sayı olmalıdır ve Geo Zone ile sipariş durumları mevcut olmalıdır.
Pin Payments
Enable/Disable: Enable Pin Payments ö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 kaydedilen ödeme yöntemi adı da budur. Varsayılan: Credit card (Pin Payments). Zorunlu, en fazla 128 karakter.
Description: müşterinin Confirm Order adımında kart formunun üstünde gördüğü metin. Varsayılan: Pay with your credit card via Pin Payments.
Sort Order: Pin Payments'in ödeme sayfasındaki ödeme yöntemleri arasındaki konumu. Boş bırakın veya bir tam sayı girin.
Geo Zone: kart formunu yalnızca seçilen coğrafi bölgedeki ödeme adresleri için gösterir. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde ayarlanır.
Total: ödeme yönteminin sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde sepet tutarı. Herhangi bir tutar için sunmak üzere boş bırakın.
API anahtarları
Anahtarlarınızı Pin Payments panelinde (sayfa dashboard.pinpayments.com adresine bağlantı verir) Account > API Keys altında bulun. Test anahtarları yalnızca test API'si ile, canlı anahtarlar yalnızca canlı API ile çalışır. Yayımlanabilir anahtar, müşterinin tarayıcısında Pin.js tarafından kullanılır. Gizli anahtar sunucunuzdan asla çıkmaz.
Test mode: Pin Payments test ortamını (test-api.pinpayments.com) ve test anahtarlarını kullanır. Gerçek tahsilat yapılmaz ve müşteriler kart formunun üstünde TEST MODU — gerçek tahsilat yapılmayacak. mesajını görür. Kapalıyken canlı API ve canlı anahtarlar kullanılır. Bir siparişin iadeleri her zaman siparişin ödendiği ortamın anahtarlarını kullanır. Varsayılan: açık.
Test publishable key: Pin Payments test hesabınızın yayımlanabilir anahtarı.
Test secret key: Pin Payments test hesabınızın gizli anahtarı.
Live publishable key: Pin Payments canlı hesabınızın yayımlanabilir anahtarı.
Live secret key: Pin Payments canlı hesabınızın gizli anahtarı.
Anahtarların etrafındaki boşluklar kaldırılır. Kaydedilmiş gizli anahtarlar bir daha asla gösterilmez. Alan boş kalır ve Kaydedildi — korumak için boş bırakın. yazısını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı bir gizli anahtarı kaldırmak için alanın altındaki Clear the saved value on save seçeneğini işaretleyin ve Save düğmesine tıklayın.
Siparişler
OpenCart siparişi Confirm Order adımında durum olmadan oluşturur (eksik sipariş). Sipariş, Pin Payments tahsilata yanıt verdikten sonra bir durum alır. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.
Order Status After Payment: kart, tam olarak sipariş tutarı ve para birimiyle tahsil edildi. Varsayılan: Processing.
On Hold (Review) Status: tahsil edilen tutar veya para birimi siparişten farklı, tahsilat yetkilendirildi ama yakalanmadı ya da Pin Payments net bir yanıt vermedi (zaman aşımı, sunucu hatası), bu yüzden bir tahsilat var olabilir. Bir not, Pin Payments panelinde neyi kontrol etmeniz gerektiğini söyler. Varsayılan: Pending, çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturup burada seçebilirsiniz.
Refunded Status: ödeme, sipariş sekmesinden tamamen iade edildikten sonra ayarlanır. Varsayılan: Refunded.
Gelişmiş
Debug log: Pin Payments API çağrılarını OpenCart günlükler klasöründeki (storage/logs) wc_ppg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz; 5 MB'a ulaştığında wc_ppg_debug.old.log.php dosyasına taşınır. Hatalar ve uyarılar her zaman günlüğe yazılır; her API çağrısını da günlüğe yazmak için bunu açın. Kart verileri, API anahtarları ve müşterilerin kişisel verileri asla günlüğe yazılmaz. Varsayılan: kapalı.
Log: günlüğün boyutunu ve en son girişlerini gösterir. Temizlemek için Clear log düğmesine tıklayın.
Delete data on uninstall: açıksa uzantı kaldırıldığında ağ geçidi ayarları ve günlük silinir. Siparişlerin ödeme verileri (tahsilatlar ve iadeler) her zaman saklanır. Varsayılan: kapalı.
İçe / Dışa Aktarma
Export: Download JSON ayarları bir JSON dosyasına kaydeder. Gizli anahtarlar dışa aktarılmaz.
Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın. Kayıtlı gizli anahtarlar korunur.
Ödeme
Ödeme yöntemi; etkinleştirildiğinde, geçerli modun iki anahtarı da girildiğinde, sipariş para birimi desteklenen 14 para biriminden biri olduğunda, ödeme adresi seçilen Geo Zone içindeyse ve sipariş Total tutarına ulaştığında gösterilir.
Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit card (Pin Payments)). OpenCart siparişi Confirm Order adımında, hâlâ durum olmadan oluşturur. Müşteri orada açıklamanızı, Visa, Mastercard ve American Express simgelerini ve kart formunu görür: Card number, Expiry (MM / YY), CVC ve Name on card. OpenCart 4'te müşteri ödeme yöntemini, ödeme yöntemi bloğundaki Choose düğmesiyle ve Payment method options penceresinde seçer; kart formu bu durumda ödeme sayfasının altındaki onay bloğunda, Confirm Order düğmesinin üstünde görünür. Gönderilmeden önce form, kart numarasının uzunluğunu, son kullanma ayını ve yılını, 3 veya 4 haneli bir CVC'yi ve adı kontrol eder.
Müşteri Confirm Order düğmesine tıkladığında Pin.js, kart bilgilerini ve siparişin ödeme adresini (OpenCart 4'te, ödeme sayfası ödeme adresi istemiyorsa teslimat adresini) tarayıcıdan doğrudan Pin Payments'e gönderir ve tek kullanımlık bir kart jetonu alır. Mağazanıza yalnızca bu jeton gelir. Ardından uzantı, sipariş para biriminde sipariş toplamı için müşterinin e-posta adresi ve IP adresiyle birlikte <store name> - Order <order number> açıklamalı, yakalanmış bir tahsilat oluşturur. Pin Payments aynı istekte yanıt verir.
Başarılı bir tahsilattan sonra sipariş, OpenCart'ın standart yöntemiyle durum alır; olağan sipariş e-postaları ve stok güncellemesi yapılır, sepet boşaltılır ve müşteri Your card payment has been received. mesajıyla OpenCart sipariş başarı sayfasını görür. Sipariş inceleme durumuna geçtiyse sayfa Kart ödemeniz alındı ve inceleniyor. İnceleme tamamlanır tamamlanmaz siparişinizi güncelleyeceğiz. mesajını gösterir.
Pin Payments yanıt vermezse (zaman aşımı, sunucu hatası, okunamayan yanıt), bir tahsilat yine de oluşturulmuş olabilir. Bu durumda sipariş bir notla inceleme durumuna alınır ve başarı sayfası Pin Payments ile ödemenizi doğrulayamadık. Lütfen tekrar ödeme yapmadan önce e-postanızı ve kart ekstrenizi kontrol edin veya bizimle iletişime geçin. mesajını gösterir. Aynı sepeti yeniden göndermek hiçbir zaman ikinci bir tahsilat oluşturmaz.
Sepet başına aynı anda yalnızca bir ödeme denemesi çalışır. İkinci bir gönderim Bu sipariş zaten ödeniyor. Lütfen bir süre bekleyin ve tekrar denemeden önce e-postanızı kontrol edin. mesajını alır. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise ödeme sayfasındaki siparişi günceller (reddedilen bir karttan sonra müşteri aynı siparişi öder); bu yüzden başka bir siparişle zaten ödenmiş bir sepet doğrudan başarı sayfasına gider ve para tahsil etmiş (ya da etmiş olabilecek) önceki bir deneme, yeni bir tahsilat yerine durumunu siparişe aktarır. Bir kart jetonu yalnızca bir kez kullanılabilir: başarısız bir denemeden sonra ya da müşteri kart bilgilerini değiştirdiğinde yeni bir jeton oluşturulur.
OpenCart 4 siparişi, başarı sayfası gösterilene kadar ödeme sayfasında tutar. Müşteri yeni bir satın almayı onayladığında bu siparişin zaten bir durumu varsa (örneğin ödenmiş ama başarı sayfası hiç açılmamış ya da siz iptal etmişsiniz), müşteri ödeme sayfasına geri gönderilir ve bir sonraki Confirm Order mevcut sepetin yeni bir siparişini öder. Ödeme sayfasının üstünde müşteri, sipariş kapatıldıysa Mağaza önceki siparişinizi iptal etti veya iade etti. Yeni bir siparişle ödemek için lütfen siparişi yeniden onaylayın. mesajını; sipariş önceki bir sepet için oluşturulduysa Önceki siparişiniz #(number) zaten verildi. Sepetiniz değişti: bunu ödemek için yeni siparişi onaylayın. mesajını görür. Ödenmiş bir sipariş, başka bir sepet için asla ödenmiş gibi gösterilmez.
Ödeme başarısız olduğunda sipariş durumsuz kalır. Müşteri Confirm Order adımında kalır, sepet korunur ve kart formunun üstünde şu mesajlardan biri gösterilir: Kartınız reddedildi. Lütfen başka bir kart kullanın veya bankanızla iletişime geçin.; Kartınızda yeterli bakiye yok. Lütfen başka bir kart kullanın.; Kartınızın son kullanma tarihi geçmiş. Lütfen başka bir kart kullanın.; Kartın güvenlik kodu (CVC) hatalı.; Bu kart türü kabul edilmiyor. Lütfen Visa, Mastercard veya American Express kullanın.; Ödeme başarısız: reddedilen bilgiler için Pin Payments'in nedeniyle birlikte; Kart bilgilerinizin süresi dolmuş. Lütfen bunları yeniden girip tekrar deneyin., jeton kullanılamadığında; Güvenli kart formu yüklenemedi. Lütfen sayfayı yenileyin veya başka bir ödeme yöntemi seçin., Pin.js yüklenmediğinde; Kart ödemeleri geçici olarak kullanılamıyor. Lütfen daha sonra tekrar deneyin veya başka bir ödeme yöntemi seçin., Pin Payments gizli anahtarı reddettiğinde; Ödemeniz işlenemedi. Lütfen tekrar deneyin veya başka bir ödeme yöntemi seçin., diğer hatalarda. Teknik neden günlüğe yazılır.
Uzantının 3-D Secure akışı yoktur. Pin Payments hesabınız 3-D Secure gerektiriyorsa tahsilat beklemede kalır, sipariş durum almaz ve müşteri Kart ödemeniz tamamlanamadı (ek doğrulama gerekiyor). Lütfen başka bir kart veya başka bir ödeme yöntemi deneyin. mesajını görür. Sonradan yakalamalı yalnızca yetkilendirme modu, kayıtlı kart, abonelik, Apple Pay veya Google Pay ve webhook yoktur.
Siparişler ve iadeler
Sipariş durumları
Durum yok (eksik sipariş): kart reddedildi, tahsilat 3-D Secure gerektirdi veya müşteri ödeme yapmadı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında görünür.
Order Status After Payment (varsayılan Processing): Pin Payments, sipariş tutarı ve para birimiyle tam olarak eşleşen başarılı ve yakalanmış bir tahsilat bildirdi. Bir not tutarı ve tahsilat jetonunu gösterir (test ödemeleri için ayrıca TEST MODU).
On Hold (Review) Status (varsayılan Pending): tahsilatın sizin incelemenize ihtiyacı var. Not nedenini açıklar: Pin Payments siparişten farklı bir tutar ya da para birimi tahsil etti, tahsilat yetkilendirildi ama yakalanmadı (Pin Payments panelinde yakalayın, ardından sipariş durumunu değiştirin) ya da Pin Payments net bir yanıt vermedi (siparişi göndermeden önce Pin Payments panelinde tahsilat açıklamasını arayın).
Refunded Status (varsayılan Refunded): tahsilat uzantı üzerinden tamamen iade edildi.
Zaten ödenmiş bir sepet için ikinci bir tahsilat yapılırsa ödenmiş sipariş değişmez. Bir not, bunu kontrol edip Pin Payments panelinde iade etmenizi ister.
Notlar, müşterinin görmediği sipariş History kayıtlarıdır.
VibeFox Pin Payments Gateway tab
Sales > Orders bölümünde Pin Payments ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox Pin Payments Gateway sekmesi; test ödemeleri için Test etiketli Charge jetonunu, Status değerini, Card markasını ve son dört hanesini, Charged / order / refunded (tahsil edilen / sipariş / iade edilen) tutarlarını, Charge description bilgisini, iade formunu, iade geçmişini ve siparişin Pin Payments notes kayıtlarını gösterir. Sekme, uzantıya erişimi olan kullanıcılara gösterilir.
İadeler
VibeFox Pin Payments Gateway sekmesinde Amount alanını girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) yazın ve Refund via Pin Payments düğmesine tıklayın. Bu tutar Pin Payments üzerinden iade edilsin mi? Bu işlem geri alınamaz. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Uzantıyı değiştirme izniniz olmalıdır (System > Users > User Groups bölümünde ayarlanır). İadeler, Pin Payments'in gerçekten tahsil ettiği tutar ve para birimiyle sınırlıdır; bu nedenle tutar veya para birimi uyuşmazlığından sonra sipariş toplamını 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ının girilmiş olması gerekir. Pin Payments iadeleri eşzamansız işler, bu nedenle durum genellikle Pending olur. Başarılı bir istek, Pin Payments iade jetonu ve durumuyla birlikte iade geçmişine ve notlara eklenir. Tam iade, siparişi müşteriye bildirilmeden ve ürünler stoğa geri alınmadan Refunded Status durumuna getirir; tıpkı elle yapılan bir durum değişikliği gibi. Kısmi iade durumu değiştirmez. Pin Payments iadeyi reddeder veya yanıt vermezse sekme hatayı gösterir ve hiçbir iade kaydedilmez.
Sipariş için kayıtlı bir tahsilat yoksa (Pin Payments net bir yanıt vermediyse) sekme iade formunu göstermez ve Pin Payments panelinde aranacak açıklamayı söyler.
Sales > Returns bölümündeki ürün iadeleri Pin Payments üzerinden para geri göndermez. Pin Payments panelinde yapılan iadeler OpenCart'a geri senkronize edilmez; bu yüzden iadeleri sipariş sayfasından yapın.
Lisans anahtarı
Uzantı, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Pin Payments Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Pin Payments Gateway > Edit sayfasının ayarların üstündeki ilk bloğudur. Anahtarı License key alanına yapıştırın 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ı) ve 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 düğmelerini gösterir. Bunların altında Product: opencart-payment-pinpayments satırı ile vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca uzantı için Modify iznine sahip yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici 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 tarihle birlikte 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 uzantı son bilinen durumla çalışmaya devam eder.
Bir anahtar tek bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. 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 müşterilere ödeme sayfasında gösterilmez. Yine de bir ödeme başlatılırsa müşteri Bu ödeme yöntemi kullanılamıyor. Lütfen başka birini seçin. mesajını görür. Aynı tarayıcıda yönetim paneline giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada hâlâ (lisanssız — yalnızca yöneticilere görünür) işaretiyle görür; böylece bir anahtar satın almadan önce uzantıyı kurabilir ve test edebilirsiniz. OpenCart 4'te bu önizleme yoktur: mağaza yönetici girişini görmez, bu yüzden etkin bir anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetim paneli Dashboard sayfasında bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: daha önce ödenmiş siparişlerin iadeleri çalışmaya devam eder.
Bir lisansın süresi dolduğunda uzantı çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetim paneli Dashboard veya Edit sayfası açıldığında otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Uzantıyı kaldırmak lisans anahtarını ve lisans durumunu her zaman 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 sipariş para biriminin desteklenen 14 para biriminden biri olduğunu kontrol edin. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total tutarına ulaştığını kontrol edin. Ayarlar sayfası, eksik anahtarlar ve desteklenmeyen mağaza para birimi için bir hata gösterir.
Ödeme gerçekleşti ama sipariş inceleme durumunda: VibeFox Pin Payments Gateway sekmesindeki notları okuyun (bkz. Sipariş durumları). Pin Payments net bir yanıt vermediyse Pin Payments panelinde <store name> - Order <order number> açıklamalı bir tahsilat arayın, ardından siparişi tamamlayın veya tahsilatı panelde iade edin.
Müşteri «Your payment was received, but the order could not be completed automatically» mesajını görüyor: kart tahsil edildi, ancak sipariş durumu ayarlanamadı (örneğin sipariş bu arada silindi). Nedeni günlüktedir. Müşteriden tekrar ödeme yapmaması istenir; aynı sepeti yeniden göndermek, yeni bir tahsilat yapmadan siparişe durum verir.
Müşteri «This payment method is not available. Please reload the checkout page.» mesajını görüyor: ödeme oturumu artık siparişle eşleşmiyor ya da ödeme yöntemi bu arada kapatıldı. Müşteri ödeme sayfasını yeniden yükler.
Müşteriler «Card payments are temporarily unavailable» mesajını görüyor: Pin Payments gizli anahtarı reddetti ya da 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 «additional verification is required» mesajıyla başarısız oluyor: Pin Payments hesabınız, uzantının desteklemediği 3-D Secure gerektiriyor. Pin Payments'ten zorunlu 3-D Secure'u kapatmasını isteyin.
Güvenli kart formu yüklenemedi: Pin Payments CDN'inden Pin.js tarayıcıda yüklenmedi; örneğin bir betik engelleyici veya betikleri birleştiren ya da değiştiren bir tarayıcı uzantısı 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şturulamadı. Müşteri bağlantıyı kontrol edip tekrar deneyebilir; hiçbir tahsilat yapılmadı.
Ödeme, bir Pin Payments nedeniyle başarısız oldu: Pin Payments tahsilat bilgilerini reddetti; örneğin tutar, para birimi için minimum tahsilat tutarının altında. Müşteri nedeni görür ve günlükte hata kodu bulunur.
İade başarısız oluyor: sekmedeki mesajı okuyun. TEST veya LIVE moduyla ilgili 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 belgelerindeki test kartlarını kullanın; örneğin 4200 0000 0000 0000 (başarılı), herhangi bir gelecek son kullanma tarihi ve herhangi bir CVC ile. Siparişler ödendikleri modu korur; bu nedenle modları değiştirdikten sonra da iadeler doğru ortama gider.
Hataları nerede bulabilirsiniz: hatalar her zaman günlüğe yazılır; uzantı 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
Extensions > Extensions bölümüne gidin, Payments türünü seçin ve VibeFox Pin Payments Gateway yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu uzantının lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, uzantının kendi ayarlarını her zaman kaldırır: Enable/Disable, Sort Order, Geo Zone, Total ve Siparişler bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılanlarına döner. Uzantının OpenCart olayı da kaldırılır (OpenCart 4'te iki olay da kaldırılır; bunlar başarı sayfasında ve ödeme sayfasının üstünde mesajları gösterir). Delete data on uninstall açıksa diğer ağ geçidi ayarları (başlık, açıklama, test modu, anahtarlar, hata ayıklama günlüğü anahtarı) ve günlük kaldırılır. Kapalıysa sonraki bir yeniden kurulum için saklanır. Pin Payments tahsilatları ve iadeleri her zaman saklanır; bu sayede daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.
OpenCart 4'te uzantının dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu uzantılar listesinde VibeFox Pin Payments Gateway yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi kaldırmak için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.
Pin Payments, ilgili sahibinin ticari markasıdır. Bu uzantı Pin Payments ile bağlantılı değildir ve Pin Payments tarafından onaylanmamıştır.