VibeFox PayPal for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, yüklü ve etkin. WooCommerce olmadan eklenti etkinleştirilmez.

PHP: 8.0 veya üzeri.

HTTPS: canlı ödemeler için sitenizin HTTPS kullanması gerekir.

PayPal hesabı: PayPal Developer Dashboard'da bir REST API uygulaması bulunan bir PayPal Business hesabı. Uygulamanın Client ID ve Secret bilgilerine ihtiyacınız vardır. Sandbox ve canlı uygulamaların kimlik bilgileri farklıdır. Webhook gerekmez: eklenti, 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. 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_paypal_gateway klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

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

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

4. Ayarları açın: WooCommerce > Settings > Payments > PayPal (Smart Buttons) > Manage, ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

5. Sayfanın üst kısmındaki lisans bölümüne VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

6. Kullandığınız modun kimlik bilgilerini girin, Capture veya Authorize seçeneğini belirleyin, Enable/Disable seçeneğini açın ve kaydedin.

7. Bir PayPal sandbox alıcı hesabıyla test edin, ardından Sandbox mode seçeneğinin işaretini kaldırın ve canlı kimlik bilgilerini girin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > PayPal (Smart Buttons). Alanların üzerinde sayfa; ödeme yöntemi etkinken seçili modun Client ID veya Secret bilgisi boşsa ve PayPal mağazanın para birimini desteklemiyorsa sizi uyarır. Her iki durumda da ödeme yöntemi ödeme sayfasında gizlenir. Ödeme yöntemleri listesinde PayPal, sandbox modunda Test mode rozeti gösterir ve seçili modun kimlik bilgileri girilene kadar kurulum gerektiren olarak işaretlenir.

Genel

Enable/Disable: Enable PayPal Gateway ödeme yöntemini açar veya kapatır. Varsayılan: off.

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Varsayılan: PayPal.

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 bilgilerini kopyalayın. Bu bölümde sandbox uygulamalarına ve canlı uygulamalara bağlantılar bulunur. Yalnızca seçili modun alanları gösterilir.

Sandbox mode: Enable sandbox (test) mode. Ödemeler sandbox kimlik bilgileriyle PayPal sandbox'ına gönderilir; gerçek para hareket etmez. Varsayılan: on. Gerçek ödemeleri kabul etmek için işaretini kaldırın.

Sandbox Client ID: sandbox REST API uygulamanızın Client ID bilgisi.

Sandbox Secret: sandbox REST API uygulamanızın Secret bilgisi.

Live Client ID: canlı REST API uygulamanızın Client ID bilgisi.

Live Secret: canlı REST API uygulamanızın Secret bilgisi.

Ödeme

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

Gelişmiş

Debug log: Log API requests (errors are always logged). Kayıtlar WooCommerce > Status > Logs bölümünde, wcp_paypal_gateway kaynağıyla saklanır. Kimlik bilgileri ve alıcı verileri hiçbir zaman günlüğe yazılmaz. Varsayılan: off.

Delete data on uninstall: Delete the gateway settings when the plugin is deleted. Siparişlerdeki ödeme verileri (siparişlerdeki PayPal kimlikleri) her zaman saklanır. Varsayılan: off.

Ödeme sayfası

Müşteri PayPal'ı seçtiğinde (varsayılan olarak PayPal), PayPal düğmesi Place order düğmesinin yerini alır. Sandbox modunda ödeme sayfasında Sandbox modu: PayPal sandbox alıcı hesabıyla ödeyin; gerçek para tahsil edilmez. mesajı görünür. Düğmeye tıklandığında sunucunuzda sepet toplamı için (ya da Pay for order sayfasında sipariş toplamı için) bir PayPal siparişi oluşturulur. Tutar her zaman sunucuda hesaplanır, tarayıcıda asla.

Müşteri, ödemeyi PayPal penceresinde bir PayPal hesabı veya PayPal'ın sunduğu başka bir ödeme kaynağıyla onaylar. Ödeme sayfasında ardından PayPal ödemesi onaylandı. Siparişiniz tamamlanıyor… mesajı görünür ve sipariş gönderilir. Sunucunuz PayPal siparişini okuyarak onaylandığını, bu ödeme sayfasında oluşturulduğunu, başka bir sipariş tarafından kullanılmadığını ve tutarının ile para biriminin siparişle eşleştiğini kontrol eder. Ancak bundan sonra ödeme tahsil edilir (veya yetkilendirilir) ve müşteri sipariş alındı sayfasına yönlendirilir.

Onaydan sonra sepet toplamı değişirse hiçbir tutar tahsil edilmez. Müşteri PayPal'da ödemeyi onayladıktan sonra sipariş toplamı değişti. Yeni toplamı onaylamak için lütfen PayPal düğmesine yeniden tıklayın. mesajını görür. Bir ödeme sayfası alanı eksikse onay saklanır: düzeltmeden sonra müşteri ödemeyi tamamlamak için Place order düğmesine tıklar. PayPal ödemeyi reddederse müşteriden PayPal düğmesine tıklaması ve başka bir ödeme yöntemi seçmesi istenir. Müşteri PayPal penceresini kapatırsa ödeme sayfasında PayPal ödemesini iptal ettiniz. mesajı görünür.

Tahsilat sırasında PayPal yanıt vermezse müşteri PayPal ödemenizi henüz doğrulayamadık. Lütfen birkaç dakika içinde tekrar deneyin; iki kez ücretlendirilmeyeceksiniz. mesajını görür. Yeniden deneme aynı onayı kullanır; PayPal önceki denemeyi tamamladıysa o ödeme kullanılır ve yeni onay tahsil edilmez.

Ödeme yöntemi klasik ödeme sayfasında, Ödeme bloğunda ve Pay for order sayfasında çalışır. PayPal komut dosyası kendi ad alanında yüklenir, bu nedenle sayfadaki başka bir PayPal eklentisiyle çakışmaz. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklentinin PayPal webhook'ları, Pay Later mesajları, kart alanları, Venmo, Apple Pay, Google Pay veya Fastlane ayarları, kayıtlı ödeme yöntemleri veya abonelikleri ve ürün ya da sepet sayfalarında düğme yoktur. PayPal'daki bir adres değil, WooCommerce ödeme sayfasında girilen teslimat adresi kullanılır.

Siparişler ve iadeler

Order statuses

Pending payment: sipariş oluşturuldu, ancak ödeme henüz tahsil edilmedi; örneğin PayPal'dan bilinmeyen bir yanıt alındıktan sonra.

Processing: tahsilat tamamlandı. Yalnızca indirilebilir sanal ürün içeren siparişler, WooCommerce varsayılanı olan Tamamlandı durumuna geçer. Sipariş notu tutarı, PayPal siparişini ve tahsilatı gösterir. İşlem kimliği PayPal tahsilat kimliğidir ve sipariş ekranında PayPal hesabınızdaki ödemeye bağlanır (sandbox veya canlı).

On hold: ödeme yetkilendirildi ve tahsilat bekliyor (ödeme işlemi Authorize); veya tahsilat, örneğin ödeme incelemesi nedeniyle PayPal'da PENDING durumunda; veya ödenen tutar ya da para birimi siparişle eşleşmiyor; veya ödeme PayPal yanıtından okunamadı. Sipariş notu nedenini açıklar.

Failed: PayPal tahsilatı veya yetkilendirmeyi reddetti.

Cancelled: yetkilendirme Void PayPal authorization ile iptal edildi.

Sipariş işlemleri

Siparişi açın, Order actions altından bir işlem seçin ve oka tıklayın.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via PayPal düğmesine tıklayın (düğmede ödeme yönteminizin başlığı görünür). Tam ve kısmi iadeler desteklenir. İade, ödemenin yapıldığı PayPal ortamına (sandbox veya canlı) gönderilir; bu nedenle o ortamın kimlik bilgilerinin girilmiş olması gerekir. İade nedeni, alıcıya bir not olarak PayPal'a iletilir. PayPal iadeyi kabul etmezse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, PayPal iade kimliği ve durumuyla birlikte sipariş notlarına eklenir; PENDING durumundaki bir iadeyi PayPal daha sonra tamamlar.

Yalnızca yetkilendirilmiş bir ödeme iade edilemez: bunun yerine Void PayPal authorization kullanın. PayPal hesabınızda yapılan iadeler, itirazlar ve geri ödemeler WooCommerce ile senkronize edilmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınmış bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Payments > PayPal (Smart Buttons) sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bölümde durum, örneğin lisansın geçerli olduğu son tarih ve alan adınız görünür. 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 bir alan adında çalışır. Anahtarın bir siteden kaldırılması alan adı hakkını serbest bırakmaz. Bunu vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan PayPal, ö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. Giriş yapmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece anahtar satın almadan önce eklentiyi kurup test edebilirler. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: iadeler ve sipariş işlemleri çalışmaya devam eder.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

PayPal ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, seçili modun Client ID ve Secret bilgilerinin girildiğini, mağaza para biriminin PayPal tarafından desteklendiğini ve sepet toplamının sıfırdan büyük olduğunu kontrol edin. Kimlik bilgileri veya para birimi sorun olduğunda ayarlar sayfası uyarı gösterir. www.paypal.com adresini engelleyen bir tarayıcı eklentisi de düğmeyi gizler.

Ödeme yapıldı ama sipariş Ödeme bekleniyor durumunda kaldı: eklentinin webhook'u yoktur, bu nedenle ödeme yalnızca ödeme sayfası sırasında onaylanır. Bu, PayPal tahsilat sırasında yanıt vermediğinde olur. Sipariş notunu okuyun, ödemeyi PayPal hesabınızda kontrol edin ve siparişi elle tamamlayın ya da müşterinin yeniden denemesine izin verin: yeniden deneme hiçbir zaman iki kez tahsilat yapmaz.

PayPal şu anda kullanılamıyor: kimlik bilgileri yanlış veya diğer moda ait. Doğru uygulamanın Client ID ve Secret bilgilerini yeniden kopyalayın.

PayPal onayınız bu ödeme sayfasıyla eşleştirilemedi: PayPal siparişi, örneğin oturum süresi dolduğu için bu ödeme oturumunda oluşturulmadı. Müşteri PayPal düğmesine yeniden tıklar.

Ödemeden sonra sipariş Beklemede durumunda: sipariş notunu okuyun. Ödeme yetkilendirildi (Capture PayPal payment ile tahsil edin), tahsilat PayPal'da PENDING durumunda (daha sonra Check PayPal payment status kullanın) veya ödenen tutar ya da para birimi siparişle eşleşmedi.

Yetkilendirmenin tahsilatı başarısız oluyor: yetkilendirme 29 günden eski olabilir veya zaten iptal edilmiş olabilir. Sipariş notu PayPal hatasını gösterir.

İade başarısız oluyor: siparişte PayPal tahsilatı yok (yalnızca yetkilendirme var) veya ödemenin yapıldığı ortamın kimlik bilgileri eksik. Geliştiriciler para birimi listesini wc_plg_supported_currencies filtresiyle değiştirebilir.

Lisans bölümü bir hata gösteriyor: bölümdeki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa vibefox.net hesabınızda bir alan adı hakkı serbest bırakı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.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları ve önbelleğe alınmış PayPal erişim belirteçleri yalnızca Delete data on uninstall seçeneği açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanırlar. Mevcut siparişler ödeme notlarını, işlem kimliklerini ve PayPal kimliklerini korur.

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