VibeFox SimplePay for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleştirilmez.

PHP: 8.0 veya üzeri.

Mağaza para birimi: HUF, EUR veya USD. SimplePay başka para birimlerini kabul etmez ve bu para birimleri için ödeme yöntemi sunulmaz.

SimplePay satıcı hesapları: SimplePay her para birimi için ayrı bir satıcı hesabı ve canlı ile sandbox için ayrı hesaplar verir. Her hesap için SimplePay satıcı yönetim panelinden (canlı için admin.simplepay.hu, sandbox için sandbox.simplepay.hu), hesap > Teknik veriler bölümündeki MERCHANT ve SECRET KEY değerlerine ihtiyacınız vardır. Yalnızca HUF ile satış yapıyorsanız HUF hesabı yeterlidir. Başka anahtara gerek yoktur.

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_simplepay_gateway klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Payments > SimplePay (OTP) > Manage, veya Plugins 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. Sattığınız her para birimi için SimplePay hesaplarınızın MERCHANT ve SECRET KEY değerlerini girin: testler için sandbox hesapları, gerçek ödemeler için canlı hesaplar (bkz. Yapılandırma).

6. Ayarlar sayfasında gösterilen IPN URL adresini, SimplePay satıcı yönetim panelindeki her satıcı hesabına (canlı ve sandbox) kopyalayın.

7. Enable/Disable seçeneğini açın, Sandbox mode açıkken bir test ödemesi yapın, ardından gerçek ödemeleri kabul etmek için Sandbox mode seçeneğinin işaretini kaldırın.

1.0 sürümünden güncelleme yaptığınızda, 1.0'ın tek Merchant ID ve Secret key değerleri, etkin olan modda (sandbox veya canlı) mağaza para birimi hesabına taşınır. Güncellemeden sonra hesapları kontrol edin.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > SimplePay (OTP). Alanların üstünde sayfa, mağaza para birimi SimplePay tarafından desteklenmiyorsa veya mağaza para biriminin mevcut modda satıcı hesabı yoksa sizi uyarır. Her iki durumda da bu para birimindeki siparişler için ödeme yöntemi sunulmaz. Sandbox modu açıkken sayfa Sandbox mode is on: payments go to the SimplePay sandbox, no real money is charged. mesajını gösterir. Ödeme yöntemleri listesinde, mevcut modda en az bir satıcı hesabı olana kadar SimplePay kurulum gerektiren olarak işaretlenir.

Genel

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yönteminin adı. Varsayılan: SimplePay (Card Payment).

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely with your credit or debit card via SimplePay. Macar satıcılar ödeme sayfasında SimplePay veri aktarım beyanını (Adattovábbítási nyilatkozat) göstermelidir. Bunu bağlantısıyla birlikte buraya ekleyebilirsiniz.

Sandbox mode: Use the SimplePay sandbox ödemeleri SimplePay sandbox'ına gönderir ve sandbox hesaplarını kullanır. Hem API adresini hem de satıcı hesaplarını değiştirir. Gerçek para tahsil edilmez. Varsayılan: açık. Canlı hesaplarla gerçek ödemeler almak için işareti kaldırın.

Canlı satıcı hesapları

Sandbox mode kapalıyken kullanılan hesaplar. Mağazanızın sattığı para birimlerinin hesaplarını doldurun. MERCHANT ve SECRET KEY değerleri SimplePay satıcı yönetim panelinde (admin.simplepay.hu), hesap > Teknik veriler bölümündedir. Bir hesap yalnızca iki alan da doldurulduğunda kullanılır.

HUF account — Merchant ID: canlı HUF hesabınızın MERCHANT değeri.

HUF account — Secret key: canlı HUF hesabınızın SECRET KEY değeri.

EUR account — Merchant ID ve EUR account — Secret key: canlı EUR hesabınız için aynısı.

USD account — Merchant ID ve USD account — Secret key: canlı USD hesabınız için aynısı.

Sandbox satıcı hesapları

Sandbox mode açıkken kullanılan hesaplar. Alanlar canlı hesaplarla aynıdır: HUF account — Merchant ID, HUF account — Secret key ve EUR ile USD için aynı çiftler. Değerleri SimplePay sandbox satıcı yönetim panelinden (sandbox.simplepay.hu), hesap > Teknik veriler bölümünden alın.

IPN URL

IPN, ödeme durumu değiştiğinde SimplePay'in mağazanıza gönderdiği mesajdır. Bir siparişin ödenmiş olmasının olağan yoludur. Ayarlar sayfası mağazanızın IPN URL'sini gösterir. Şu biçimdedir: https://your-site/wc-api/simplepay_payment_callback/. Bu URL'yi, SimplePay satıcı yönetim panelinde her satıcı hesabına (canlı ve sandbox) tanımlayın. Sitenizde URL'lerde dil öneki kullanılıyorsa veya başka adresleri yönlendiriyorsa, URL'yi ayarların gösterdiği gibi birebir kopyalayın, çünkü yönlendirilen bir IPN kaybolur.

IPN, adını verdiği satıcı hesabının SECRET KEY değeriyle imzalanmalıdır. Geçerli imzası olmayan IPN'ler reddedilir. Eklenti, her geçerli IPN'i SimplePay'in gerektirdiği imzalı biçimde SimplePay'e onaylar. Bu IPN durumları siparişi değiştirir:

Başarısız ve İptal edildi yalnızca hâlâ Ödeme bekleniyor durumundaki bir siparişin en son ödeme denemesi için ayarlanır. Diğer durumlar günlüğe yazılır ve siparişi değiştirmez. IPN olmadan bir sipariş, ancak müşteri başarılı bir ödemeden sonra mağazaya döndüğünde onaylanır.

Siparişler

Order Status After Payment: başarılı bir ödemeden sonra ayarlanan sipariş durumu. Durum hemen ayarlanır, ikinci bir durum değişikliği olmaz.

Gelişmiş

Logging: Enable logging, API çağrılarını, IPN'leri ve dönüşleri WooCommerce > Status > Logs bölümüne, kaynak wcp_simplepay_gateway olarak yazar. Anahtarlar ve müşteri verileri kaydedilmez. Hatalar, bu seçenek kapalı olsa bile her zaman kaydedilir. Varsayılan: kapalı.

Delete Data on Uninstall: Remove all plugin data when uninstalling. Açıkken eklentiyi silmek ağ geçidi ayarlarını ve eklentinin günlüklerini kaldırır. Sipariş verileri her zaman saklanır. Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak SimplePay (Card Payment)) ve siparişi verir. Eklenti, sipariş toplamı için sipariş para biriminde bir SimplePay kart ödemesi başlatır; bu para biriminin satıcı hesabını mevcut modda kullanır ve müşteriyi SimplePay ödeme sayfasına yönlendirir. Sayfada, satıcı hesabınızın kart ödemeleri için izin verdiği seçenekler gösterilir. Müşterinin e-posta adresi ve tamamlanmışsa fatura adresi SimplePay'e iletilir. Ödeme sayfası, SimplePay destekliyorsa sitenizin dilini kullanır, aksi halde İngilizce kullanır. Başlatılan bir ödeme 30 dakika içinde tamamlanabilir.

Başarılı bir ödemeden sonra müşteri mağazanızın sipariş alındı sayfasına döner. Dönüş tek başına bir siparişi asla ödenmiş yapmaz: eklenti, işlemin durumunu imzalı bir istekle SimplePay'den sorar; bu nedenle IPN geç gelse bile sipariş onaylanır. Sipariş alındı sayfası Successful transaction. SimplePay transaction ID: ve kimliği gösterir. Ödeme henüz onaylanmamışsa Your payment is being confirmed by SimplePay. SimplePay transaction ID: ve kimliği gösterir.

Ödeme başarısız olur, iptal edilir veya zaman aşımına uğrarsa müşteri ödeme sayfasına geri gönderilir; sepet boşsa Pay for order sayfasına gönderilir. Orada müşteri, işlem kimliğiyle birlikte SimplePay mesajını görür; örneğin Cancelled payment. You cancelled the payment veya Timeout. The time allowed to complete the payment has expired. Başarısız bir ödemede müşteriden girdiği bilgileri kontrol etmesi ve kartı veren bankayla iletişime geçmesi istenir. Müşteri tekrar deneyebilir. Her yeni deneme kendi SimplePay referansını alır; örneğin 123, 123-2, 123-3.

SimplePay ödemeyi başlatamazsa müşteri The SimplePay payment could not be started. Please try again or choose another payment method. mesajını görür. Sipariş para biriminin satıcı hesabı yoksa mesaj SimplePay is not available for the currency of this order. Please choose another payment method. olur. Teknik neden sipariş notlarına ve günlüğe eklenir. Giriş yapmış mağaza yöneticileri nedeni mesajda da görür.

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

Eklenti yalnızca SimplePay sayfasında tahsil edilen tek seferlik kart ödemelerini kabul eder. Kayıtlı kart veya tek tıkla ödeme, abonelik veya yinelenen ödeme ve ayrı yetkilendirme ile tahsilat desteği yoktur.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri SimplePay'e gönderildi ve henüz ödeme yapmadı ya da SimplePay ödemeyi henüz onaylamadı. Sipariş notu, başlatılan işlemi, tutarı ve modu (sandbox veya canlı) gösterir.

Processing or Completed: ödeme onaylandı. Durum Order Status After Payment ayarını izler. Sipariş notu işlem kimliğini ve ödemenin IPN mi yoksa durum isteği mi tarafından onaylandığını gösterir. SimplePay işlem kimliği, siparişin işlem kimliği olarak kaydedilir. Geç gelen başarılı bir ödeme, Başarısız veya İptal edildi olan bir siparişi de tamamlar.

On hold: ödeme başlatıldıktan sonra sipariş toplamı veya para birimi değiştirildi; bu nedenle ödenen tutar siparişten farklı. Sipariş notu her iki tutarı da gösterir. Siparişi kontrol edin ve işleyin ya da ödemeyi iade edin.

Failed: SimplePay en son ödeme denemesini yetkisiz veya dolandırıcılık olarak bildirdi.

Cancelled: SimplePay en son ödeme denemesinin zaman aşımına uğradığını veya iptal edildiğini bildirdi.

İade edilmiş veya tamamlanmış bir sipariş, geç gelen bir IPN ile asla yeniden açılmaz. Zaten ödenmiş bir sipariş için ikinci bir ödeme başarılı olursa sipariş tekrar değiştirilmez. Bir not, bunu SimplePay yönetim panelinde kontrol etmenizi ve yinelenen bir ödemeyse iade etmenizi ister.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via SimplePay (OTP) düğmesine tıklayın. Tam ve kısmi iadeler desteklenir. HUF iadeleri tam forint olmalıdır. İade, ödemenin yapıldığı satıcı hesabı ve modla (sandbox veya canlı) gönderilir; bu nedenle o hesap ayarlarda hâlâ bulunmalıdır. SimplePay iadeyi kabul etmezse WooCommerce hatayı gösterir ve iade kaydedilmez. Başarılı bir iade, SimplePay iade işlem kimliği ve girdiyseniz nedeniyle birlikte sipariş notlarına eklenir.

SimplePay satıcı yönetim panelinde yapılan iadeler WooCommerce ile senkronize edilmez. Bunları Refund via SimplePay (OTP) kullanmadan WooCommerce'e elle kaydedin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınmış bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > SimplePay (OTP) 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 seçeneklerini 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ı bir siteden kaldırmak, o sitenin alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan SimplePay ö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 hâlâ görür; yöntem (unlicensed — visible to admins only) işaretiyle gösterilir. Böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır ve iadeler çalışır.

Bir 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

SimplePay ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, sipariş para biriminin HUF, EUR veya USD olduğunu ve bu para biriminin mevcut modda hem Merchant ID hem de Secret key değerine sahip olduğunu kontrol edin: Sandbox mode açıkken sandbox hesapları, kapalıyken canlı hesaplar. Mağaza para birimi için hesap yoksa ayarlar sayfası uyarı gösterir.

Ödeme gerçekleşti ama sipariş Ödeme bekleniyor durumunda kaldı: IPN mağazaya ulaşmadı. SimplePay satıcı yönetim panelinde kullandığınız satıcı hesabının (canlı veya sandbox, siparişin para birimi) IPN URL'sini kontrol edin. Ayarlarda gösterilen URL ile birebir aynı olmalı ve sunucunuza internetten erişilebilmelidir. Müşteri ödeme yaptıktan sonra mağazaya döndüğünde de sipariş onaylanır.

IPN, Invalid signature yanıtı veriyor: IPN, ayarlarda olmayan bir satıcı hesabını belirtiyor veya Secret key yanlış. MERCHANT ve SECRET KEY değerlerini SimplePay satıcı yönetim panelinde gösterildiği gibi birebir girin. SimplePay onaylanmamış IPN'leri yeniden gönderir.

IPN, Order not found veya Unknown transaction yanıtı veriyor: IPN, bu mağazanın başlatmadığı bir sipariş veya işlem için. Sipariş değiştirilmez.

IPN, Busy, retry yanıtı veriyor: sipariş aynı anda başka bir istekle onaylanıyordu. SimplePay IPN'i yeniden dener.

Müşteri sipariş verirken bir hata görüyor: sipariş notlarını açın veya WooCommerce > Status > Logs bölümüne, kaynak wcp_simplepay_gateway olacak şekilde bakın. Yanlış bir secret key Invalid response signature from SimplePay. Check the secret key of the merchant account. hatasını verir. SimplePay hataları SimplePay error code(s): ve ardından kodlar olarak gösterilir.

Sandbox ile canlı arasında geçiş yaptıktan sonra: yeni ödemeler yeni modun hesaplarını kullanır. Daha önce başlatılmış siparişler, başlatıldıkları satıcı hesabını ve modu korur: IPN'leri, durum istekleri ve iadeleri o hesabı kullanır. Bu tür siparişler açık olduğu veya iade edilebileceği sürece eski modun hesaplarını ayarlarda tutun.

Ödemeden sonra sipariş Beklemede: sipariş notunu okuyun. Ödeme başlatıldıktan sonra sipariş toplamı veya para birimi değiştirilmiş. Siparişi işleyin veya ödemeyi iade edin.

İade başarısız oluyor: mesajı okuyun. SimplePay refunds in HUF must be whole amounts. HUF tutarında ondalık olduğu anlamına gelir. Mesaj bu ödemenin satıcı hesabının yapılandırılmadığını söylüyorsa, ödemenin yapıldığı hesabı (para birimi ve mod) yeniden girin. SimplePay farklı bir tutarı iade ettiyse, mesaj iadeyi SimplePay yönetim panelinde kontrol etmenizi ister.

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 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şılamazsa 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 eklentinin günlükleri yalnızca Delete Data on Uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için kalırlar. Mevcut siparişler ödeme notlarını, işlem kimliklerini ve SimplePay verilerini korur.

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