VibeFox Pin Payments for WooCommerce — Yardım

Gereksinimler

WordPress: 6.2 veya üzeri.

WooCommerce: 7.1 veya üzeri, yüklü ve etkin. Eklenti WooCommerce olmadan etkinleştirilmez.

PHP: 8.0 veya üzeri.

HTTPS: ödeme sayfanızın, kart ödemesi kabul etmek için gerekli olduğu üzere HTTPS kullanması gerekir (PCI DSS). Kart bilgileri, müşterinin tarayıcısından Pin.js aracılığıyla doğrudan Pin Payments'a gönderilir ve hiçbir zaman sunucunuza ulaşmaz; bu nedenle mağazanız PCI SAQ A-EP kapsamına girer.

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: eklenti webhook kullanmaz.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar yalnızca 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_pinpayments_gateway klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

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

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

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

5. 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 etkinleştirin ve kaydedin.

6. 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.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Pin Payments. Sayfa, alanların üstünde; test modu açıkken bir bildirim, geçerli modun yayınlanabilir anahtarı veya gizli anahtarı boşken bir hata ve Pin Payments mağaza para birimini desteklemediğinde (desteklenen para birimlerinin listesiyle birlikte) bir hata gösterir. Son iki durumda ağ geçidi ödeme sayfasında gizlenir. Kaydettikten sonra bildirimler yeni modu ve anahtarları zaten yansıtır. Ödeme yöntemleri listesinde ağ geçidi, geçerli modda iki anahtar da girilene kadar kurulum gerektiren olarak işaretlenir.

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

Title: ödeme sayfasında gösterilen ödeme yönteminin başlığı. Varsayılan: Credit card (Pin Payments).

Description: ödeme sayfasında gösterilen ödeme yönteminin açıklaması. 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ındaki Pin.js tarafından kullanılır. Gizli anahtar hiçbir zaman sunucunuzdan ayrılmaz.

Test mode: Enable 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 formunda TEST MODU — gerçek tahsilat yapılmayacaktır. ifadesini görür. Kapalıyken canlı API (api.pinpayments.com) 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ı. Bu bir parola alanıdır.

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ı. Bu bir parola alanıdır.

Anahtarların çevresindeki boşluklar silinir. Geçerli modun her iki anahtarı da doldurulmalıdır; aksi halde ağ geçidi ödeme sayfasında gösterilmez.

Gelişmiş

Debug log: Log Pin Payments API calls — kayıtlar WooCommerce > Status > Logs altında, kaynak wcp_pinpayments_gateway olarak yazılır. Hatalar her zaman kaydedilir; her API çağrısını da kaydetmek için bunu açın. Kart verileri, API anahtarları ve müşterilerin kişisel verileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Siparişlerde saklanan ödeme verileri her zaman korunur. Varsayılan: kapalı.

Ödeme

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

Sipariş verildiğinde Pin.js, kart bilgilerini ve fatura adresini tarayıcıdan doğrudan Pin Payments'a gönderir ve tek kullanımlık bir kart jetonu alır. Sunucunuza yalnızca bu jeton gönderilir. Ardından sunucunuz, sipariş tutarı için sipariş para biriminde, <store name> - Order <number> açıklamasıyla yakalanmış bir tahsilat oluşturur. Pin Payments aynı istekte yanıt verir. Sipariş, yalnızca Pin Payments başarılı bir tahsilat bildirdiğinde ve yalnızca siparişin tam tutarı ve para birimi için ödendi olarak işaretlenir. Ardından müşteri sipariş alındı sayfasına yönlendirilir.

Her sipariş için aynı anda yalnızca bir ödeme denemesi yürütülü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. Zaten ödenmiş veya tahsil edilip beklemeye alınmış bir sipariş bir daha tahsil edilmez. 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.

Müşterinin görebileceği mesajlar: 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 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'ın nedeniyle birlikte; Kart bilgilerinizin süresi doldu. Lütfen bilgileri 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; Ödemenizi Pin Payments ile doğrulayamadık. Lütfen tekrar denemeden önce e-postanızı ve kart ekstrenizi kontrol edin veya bizimle iletişime geçin. Pin Payments yanıt vermediğinde. Teknik ayrıntılar sipariş notlarına ve günlüğe yazılır.

Ödeme yöntemi klasik ödeme sayfasında, Ödeme bloğunda (aynı kart alanlarıyla) ve Pay for order sayfasında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklentinin 3-D Secure akışı yoktur. Pin Payments hesabınız 3-D Secure gerektiriyorsa tahsilat beklemede kalır ve eklenti siparişi başarısız olarak işaretler; bu denemede bu nedenle para çekilmez. 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 tahsilat yapılan yalnızca yetkilendirme modu, kayıtlı kartlar, WooCommerce Subscriptions, Apple Pay veya Google Pay ve webhook yoktur.

Siparişler ve iadeler

Order statuses

Processing: Pin Payments, siparişin tam tutarı ve para birimi için başarılı, yakalanmış bir tahsilat bildirdi. Yalnızca sanal, indirilebilir ürün içeren siparişler, WooCommerce varsayılanı olan Tamamlandı durumuna geçer. Sipariş notunda tutar ve tahsilat jetonu gösterilir (test ödemeleri için TEST MODE da). İşlem kimliği, Pin Payments tahsilat jetonudur.

Failed: kart reddedildi, tahsilat beklemede kaldı (3-D Secure), Pin Payments gizli anahtarı veya isteği reddetti. Her başarısız deneme, Pin Payments hata koduyla ve mesajıyla birlikte siparişe bir not ekler; sipariş önceki bir denemeden dolayı zaten Başarısız durumdaysa da ekler. Müşteri aynı siparişle tekrar deneyebilir.

Pending payment: Pin Payments net bir yanıt vermedi (zaman aşımı, sunucu hatası, okunamayan yanıt). Tahsilat yine de oluşmuş olabileceği için sipariş başarısız olarak işaretlenmez. Not, müşteri tekrar ödeme yapmadan veya sipariş gönderilmeden önce Pin Payments panelinde tahsilat açıklamasını aramanızı söyler. Bu durum Ödeme bekleniyor olarak adlandırılır.

On hold: Pin Payments, siparişten farklı bir tutar veya para birimi tahsil etti (not, beklenen ve tahsil edilen tutarı gösterir) ya da tahsilat yetkilendirildi ama yakalanmadı. Siparişi yerine getirmeden önce Pin Payments panelinde tahsilatı kontrol edin.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Credit card (Pin Payments) düğmesine tıklayın (düğmede Title değeriniz görünür). Tam ve kısmi iadeler desteklenir. İade, siparişin ödendiği ortama (test veya canlı) gönderilir; bu nedenle o modun gizli anahtarı girilmiş olmalıdır. Başarılı bir istek, siparişe tutarı, Pin Payments iade jetonunu ve durumunu içeren bir not ekler. Pin Payments iadeleri eşzamansız işler, bu nedenle durum genellikle Pending olur. Pin Payments iadeyi reddeder veya yanıt vermezse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez.

Pin Payments panelinde yapılan iadeler WooCommerce ile senkronize edilmez; bu nedenle iadeleri WooCommerce üzerinden yapın.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Pin Payments 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 yalnızca bir alan adında çalışır. Anahtarı bir siteden kaldırmak, o alan adı yuvasını boşaltmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

Etkin bir anahtar olmadan Pin Payments ödeme sayfasında müşterilere 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. Oturum açmış mağaza yöneticileri, bir anahtar satın almadan önce eklentiyi kurup test edebilmeniz için ödeme yöntemini (lisanssız — yalnızca yöneticilere görünür) olarak işaretlenmiş şekilde görmeye devam eder. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: iadeler çalışmaya devam eder.

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

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 (test modunda Test publishable key ve Test secret key, diğer durumda canlı anahtarlar) doldurulduğunu ve sepet para biriminin desteklenen 14 para biriminden biri olduğunu kontrol edin. Pay for order sayfasında sipariş para birimi geçerlidir. Ayarlar sayfası, eksik anahtarlar ve desteklenmeyen para birimi için hata gösterir.

Ödeme sayfasında «Ödemenizi doğrulayamadık» yazıyor: Pin Payments zamanında yanıt vermedi. Sipariş, bir notla birlikte Ödeme bekleniyor durumunda kalır. Müşteri tekrar ödeme yapmadan veya sipariş gönderilmeden önce Pin Payments panelinde <store name> - Order <number> açıklamalı bir tahsilat arayın. Eklenti böyle bir tahsilatı otomatik olarak aramaz ve yeni bir deneme yeni bir tahsilat oluşturur.

Müşteriler «Kart ödemeleri geçici olarak kullanılamıyor» mesajını görüyor: Pin Payments gizli anahtarı reddetti. Sipariş notu, geçerli modun anahtarlarını kontrol etmenizi söyler. Test anahtarları yalnızca test modunda, canlı anahtarlar yalnızca canlı modda çalışır.

Siparişler «ek doğrulama gerekiyor» hatasıyla başarısız oluyor: Pin Payments hesabınız, eklentinin desteklemediği 3-D Secure gerektiriyor. Pin Payments'tan zorunlu 3-D Secure'u kapatmasını isteyin.

Bir sipariş «does not match» notuyla On hold durumunda: Pin Payments, siparişten farklı bir tahsilat tutarı veya para birimi bildirdi. Pin Payments panelinde tahsilatı kontrol edin ve siparişi manuel olarak iade edin veya tamamlayın.

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

İade başarısız: mesajı okuyun. TEST veya LIVE modu hakkında bir mesaj, siparişin ödendiği modun gizli anahtarının boş olduğu anlamına gelir. Pin Payments iadeyi onaylamadı mesajı yanıt gelmediği anlamına gelir; tekrar denemeden önce Pin Payments panelinde tahsilatı kontrol edin.

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

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ı) veya 4100 0000 0000 0001 (reddedilen), gelecekteki herhangi bir son kullanma tarihi ve herhangi bir CVC ile. Siparişler ödendikleri modu korur; bu nedenle modu değiştirdikten sonra iadeler doğru ortama gider.

Hataları nerede bulabilirsiniz: hatalar her zaman WooCommerce > Status > Logs altına, kaynak wcp_pinpayments_gateway olarak yazılır. Her API çağrısını görmek için Debug log seçeneğini açın.

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 boşaltı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: wc_ppg_supported_currencies filtresi para birimi listesini, wc_ppg_icon filtresi ise WooCommerce ödeme yöntemleri listesindeki simgeyi değiştirir.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman silinir. Ağ geçidi ayarları, eklentinin sürüm seçenekleri ve günlükleri (döndürülmüş olanlar dahil günlük dosyaları ve veritabanı günlük kayıtları), yalnızca Delete data on uninstall açıksa silinir. Aksi halde sonraki bir yeniden kurulum için saklanır. Pin Payments tahsilat jetonu gibi siparişlerde saklanan ödeme verileri hiçbir zaman silinmez. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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