VibeFox PayPal for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 – 9.x.

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

PayPal hesabı: PayPal Developer Dashboard'da REST API uygulaması bulunan bir PayPal Business hesabı. Uygulamanın Client ID ve Secret değerlerine ihtiyacınız vardır. Sandbox ve canlı uygulamaların kimlik bilgileri farklıdır. Webhook gerekli değildir: modül, müşteri ödeme sayfasındayken her ödemeyi sunucunuzda onaylar.

Para birimi: PayPal'ın desteklediği para birimlerinden biri: AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, ILS, JPY, MXN, MYR, NOK, NZD, PHP, PLN, SEK, SGD, THB, TWD veya USD.

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 yolunu açın 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 veya daha sonra modül listesinde VibeFox PayPal Gateway öğesini bulup Configure düğmesine tıklayın.

3. Configure sayfasının üstündeki lisans bloğunda, License key alanına VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. PayPal Developer Dashboard'da bir REST API uygulaması (sandbox ve/veya canlı) oluşturun ve Client ID ile Secret değerlerini kopyalayın.

5. Kullandığınız modun kimlik bilgilerini girin, Capture veya Authorize seçeneğini seçin, Enable/Disable seçeneğini açın ve Save düğmesine tıklayın.

6. Bir PayPal sandbox alıcı hesabıyla test edin; ardından Sandbox mode seçeneğini kapatın ve canlı kimlik bilgilerini girin.

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

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox PayPal 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; ödeme yöntemi etkin olduğu halde seçili modun Client ID'si veya Secret'ı boşsa ve PayPal mağazanın varsayılan para birimini desteklemiyorsa sizi uyarır. Her iki durumda da ödeme yöntemi ödeme sayfasında gizlenir. Sandbox modu açıkken sayfa Sandbox mode is on: payments go to the PayPal sandbox, no real money is moved. mesajını gösterir. Ayarları kaydetmek önbelleğe alınmış PayPal erişim jetonlarını siler; böylece yeni kimlik bilgileri hemen kullanılır.

General

Enable/Disable: Enable PayPal Gateway ö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: PayPal. Zorunlu.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay with your PayPal account or a card via PayPal.

API kimlik bilgileri

PayPal Developer Dashboard'da bir REST API uygulaması oluşturun ve Client ID ile Secret değerlerini kopyalayın. Bu bölümde sandbox uygulamalarına ve canlı uygulamalara bağlantılar bulunur. Yalnızca seçili modun alanları gösterilir; her iki modun kimlik bilgileri kayıtlı kalır.

Sandbox mode: ödemeler sandbox kimlik bilgileriyle PayPal sandbox'ına gider; gerçek para hareket etmez. Varsayılan: açık. Gerçek ödemeleri kabul etmek için kapatın. Tahsilatlar, iptaller ve iadeler her zaman siparişin ödendiği ortamı kullanır. Açıkken müşteriler ödeme yönteminin altında Sandbox mode: pay with a PayPal sandbox buyer account — no real money is charged. mesajını görür.

Sandbox Client ID: sandbox REST API uygulamanızın Client ID değeri.

Sandbox Secret: sandbox REST API uygulamanızın Secret değeri.

Live Client ID: canlı REST API uygulamanızın Client ID değeri.

Live Secret: canlı REST API uygulamanızın Secret değeri.

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

Clear saved secrets: bir secret'ı işaretleyip Save düğmesine tıklayarak kaldırın. Boş alan kayıtlı değeri korur.

Ödeme

Payment action: müşteri ödemeyi onayladığında ne olacağı. Varsayılan: Capture.

Gelişmiş

Debug log: API isteklerini modül klasöründeki logs/wc_plg_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Hatalar ve uyarılar bu anahtar kapalıyken bile her zaman kaydedilir. Kimlik bilgileri, jetonlar ve alıcı verileri hiçbir zaman kaydedilmez. 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 modül kaldırıldığında ağ geçidi ayarları, önbelleğe alınmış jetonlar ve günlük silinir. Sipariş ödeme verileri (siparişlerin PayPal kimlikleri, iadeler) ve sipariş durumları her zaman korunur. Varsayılan: kapalı.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak PayPal) ve ödeme formu yerine PayPal düğmesi görünür. Düğmeye tıklandığında sunucunuzda, sepet tutarı ve sepet para biriminde bir PayPal siparişi oluşturulur. Tutar her zaman tarayıcıda değil sunucuda hesaplanır. Bu noktada henüz bir sipariş yoktur.

Müşteri ödemeyi PayPal penceresinde bir PayPal hesabı veya PayPal'ın sunduğu başka bir ödeme kaynağıyla onaylar. Ödeme sayfası bunun ardından PayPal payment approved. Completing your order… mesajını gösterir ve siparişi oluşturur. Hizmet koşulları henüz kabul edilmemişse ödeme sayfası PayPal payment approved. Click "Place order" to complete it. mesajını gösterir. Müşteri bir ödemeyi onaylamadan Place order düğmesine tıklarsa mesaj Please click the PayPal button and approve the payment first. olur.

Sunucunuz ardından PayPal siparişini okur ve onaylı olduğunu, bu sepet için oluşturulduğunu, başka bir sepet tarafından kullanılmadığını ve tutarının ile para biriminin sepetle eşleştiğini kontrol eder. Ancak bundan sonra ödeme tahsil edilir (veya yetkilendirilir), sipariş oluşturulur ve müşteri standart sipariş onay sayfasını görür.

Onaydan sonra sepet toplamı değişirse hiçbir tutar tahsil edilmez. Müşteri The order total changed after you approved the payment in PayPal. Please click the PayPal button again to approve the new total. mesajını görür. PayPal ödemeyi reddederse müşteri ödeme adımına döner ve PayPal düğmesine tıklayıp başka bir ödeme yöntemi seçmesi istenir. Sipariş oluşturulmaz. Müşteri PayPal penceresini kapatırsa ödeme sayfası You cancelled the PayPal payment. mesajını gösterir.

Tahsilat sırasında PayPal yanıt vermezse müşteri We could not confirm your PayPal payment yet. Please try again in a moment — you will not be charged twice. mesajını görür. Onay, sayfa yenilense bile saklanır ve Place order bunu yeniden kullanır. PayPal önceki denemeyi tamamladıysa o ödeme kullanılır ve yeni bir onay tahsil edilmez. Ödeme alınmış ama sipariş oluşturulamamışsa müşteri Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again. mesajını görür. Sonraki deneme, kayıtlı ödemeden siparişi oluşturur ve yeniden tahsilat yapmaz.

PayPal komut dosyası yalnızca ödeme sayfasında ve kendi ad alanında yüklenir; böylece sayfadaki başka bir PayPal modülüyle çakışmaz. Modül Classic ve Hummingbird temalarıyla çalışır.

Modülün PayPal webhook'ları, Pay Later mesajları, kart alanları, Venmo, Apple Pay, Google Pay veya Fastlane, kayıtlı ödeme yöntemleri ya da abonelikleri ve ürün veya sepet sayfalarında düğmeleri yoktur. PrestaShop ödeme sayfasında girilen adresler kullanılır; PayPal'dan gelen bir adres kullanılmaz.

Siparişler ve iadeler

Sipariş durumları

No order yet: müşteri ödemeyi onaylamadı veya PayPal reddetti. Yalnızca sepet vardır.

Payment accepted: tahsilat tamamlandı. Sipariş, yalnızca PayPal onayladıktan sonra ödenmiş olarak işaretlenir. Ödeme, işlem kimliği olarak PayPal tahsilat kimliğiyle kaydedilir ve bir not tutarı, PayPal siparişini ve tahsilatı gösterir.

PayPal payment authorized: ödeme yetkilendirildi ve tahsilat bekliyor (ödeme işlemi Authorize).

Awaiting PayPal payment: tahsilat PayPal tarafında PENDING durumda, örneğin ödeme incelemesinde.

PayPal payment on hold: ödenen tutar veya para birimi siparişle eşleşmiyor ya da ödeme PayPal yanıtından okunamadı. Not nedenini açıklar. PayPal siparişin para biriminde tahsilat yaptığında, gerçekte ödenen tutar ödeme olarak kaydedilir. Siparişi kontrol edin ve tamamlayın ya da ödemeyi iade edin.

Canceled: yetkilendirme Void PayPal authorization ile iptal edildi.

Payment error: bekleyen bir tahsilat reddedildi veya başarısız oldu.

Refunded: ödeme modül üzerinden tamamen iade edildi.

Zaten siparişi olan bir sepet için ikinci bir ödeme gelirse sipariş değişmez. Bir not, bunu PayPal hesabınızda kontrol edip iade etmenizi ister.

PayPal ödeme bloğu

Sipariş sayfasında, PayPal sipariş kimliği ve intent, tahsilat kimliği (PayPal hesabınızdaki ödemeye bağlantılı, sandbox veya canlı), yetkilendirme kimliği, ödeme durumu, tutar, ödenen ve iade edilen tutarlar, sandbox ödemeleri için bir Sandbox rozeti, iade geçmişi ve siparişin PayPal notes bölümünü içeren PayPal payment bloğu gösterilir. Bloğun düğmeleri sipariş düzenleme yetkisi gerektirir, ancak modül sayfalarına erişim gerektirmez. Her işlemin sonucu blokta gösterilir.

İadeler

PayPal payment bloğunda tutarı girin (henüz iade edilmeyen tutar otomatik doldurulur), isterseniz bir neden yazın ve Refund via PayPal düğmesine tıklayın. Refund this amount through PayPal? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Neden, alıcıya bir not olarak PayPal'a iletilir. İadeler, PayPal'ın tahsil ettiği tutar ve para biriminde yapılır; bu nedenle tutar veya para birimi uyuşmazlığından sonra sipariş toplamına değil, müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı PayPal ortamına (sandbox veya canlı) gönderilir; bu nedenle o ortamın kimlik bilgileri girilmiş olmalıdır. PayPal iadeyi kabul etmezse blok hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, PayPal iade kimliği ve durumuyla birlikte iade geçmişine ve notlara eklenir; PENDING durumundaki bir iadeyi PayPal daha sonra tamamlar. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez.

Yalnızca yetkilendirilmiş bir ödeme iade edilemez: bunun yerine Void PayPal authorization kullanın. Modül kredi notu oluşturmaz. Sipariş sayfasındaki PrestaShop'un standart iade düğmeleri PayPal üzerinden para geri göndermez. PayPal hesabınızda yapılan iadeler, itirazlar ve geri ödemeler PrestaShop ile senkronize edilmez.

Lisans anahtarı

Modül, vibefox.net üzerinden alınmış bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu License — VibeFox PayPal Gateway, Modules > Module Manager > VibeFox PayPal Gateway > Configure sayfasının en üstündeki ilk bloktur ve ayarların üstündedir. 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 tarihi 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-paypal satırı ile Manage licenses and domains in your account bağlantısı bulunur; bu bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisi olan çalışanlar değiştirebilir. Bloğun metinleri 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 ya da hesabınızda bir alan adı yuvasını boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül son bilinen durumla çalışmaya devam eder.

Bir anahtar 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ı boşaltmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

Etkin bir anahtar olmadan PayPal ödeme sayfasında müşterilere gösterilmez. Yine de bir ödeme başlatılırsa mağaza PayPal siparişi oluşturmayı reddeder ve müşteri An error occurred during PayPal checkout. Please try again. mesajını görür. PrestaShop vitrini back office'e giriş yaptığınızı bilmez; bu nedenle ö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: iadeler ve PayPal bloğundaki işlemler ç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, back office'te çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

PayPal does not appear at checkout: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, seçili modun Client ID ve Secret değerlerinin girildiğini, sepet para biriminin PayPal tarafından desteklendiğini ve sepet toplamının sıfırdan büyük olduğunu kontrol edin. Sorun kimlik bilgileri veya para birimindeyse ayarlar sayfası 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. www.paypal.com adresini engelleyen bir tarayıcı eklentisi de düğmeyi gizler.

The payment went through, but no order was created: modülün webhook'u yoktur, bu nedenle ödeme yalnızca ödeme sayfası sırasında onaylanır. Bu, tahsilat sırasında PayPal yanıt vermediğinde veya sipariş oluşturulamadığında olur. Debug log seçeneğini açıp Log alanına bakın, ödemeyi PayPal hesabınızda kontrol edin veya müşterinin yeniden denemesine izin verin: yeniden deneme hiçbir zaman iki kez tahsilat yapmaz ve siparişi kayıtlı ödemeden oluşturur.

PayPal could not be loaded: PayPal komut dosyası tarayıcıda yüklenemedi; örneğin bir engelleyici veya ağ sorunu nedeniyle.

PayPal is not available right now: kimlik bilgileri yanlış veya diğer moda ait. Doğru uygulamanın Client ID ve Secret değerlerini yeniden kopyalayın.

Your PayPal approval could not be matched to this checkout: PayPal siparişi, örneğin oturumun süresi dolduğu için bu sepet için oluşturulmadı. Müşteri PayPal düğmesine yeniden tıklar.

This payment is already being processed: aynı sepet aynı anda iki kez gönderildi. Müşteri bir an bekler ve yeniden denemeden önce e-postayı kontrol eder.

The order is on hold after payment: PayPal payment bloğundaki notları okuyun. Ödeme yetkilendirildi (Capture PayPal payment ile tahsil edin), tahsilat PayPal'da PENDING durumda (daha sonra Check PayPal payment status kullanın) veya ödenen tutar ya da para birimi siparişle eşleşmedi (siparişi tamamlayın veya ödenen tutarı iade edin).

Capture of an authorization fails: yetkilendirme 29 günden eski olabilir veya zaten iptal edilmiş olabilir. Blok ve notlar PayPal hatasını gösterir.

Refund fails: siparişin PayPal tahsilatı yok (yalnızca yetkilendirme var), tutar iade edilebilecek kalan tutardan fazla veya ödemenin yapıldığı ortamın kimlik bilgileri eksik. Blok hangisinin geçerli olduğunu belirtir.

Kaldırma

Modules > Module Manager yolunu açın, VibeFox PayPal 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 kaldırılır. Delete data on uninstall açıksa ağ geçidi ayarları, önbelleğe alınmış PayPal erişim jetonları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. PayPal işlemleri ve iadeleri ile PayPal payment authorized, Awaiting PayPal payment ve PayPal payment on hold sipariş durumları her zaman korunur; bu sayede daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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