VibeFox Autopay for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin olmalı.

PHP: 8.0 veya üzeri.

Autopay hizmeti: Autopay hizmetinizin Service ID ve Shared key (hash anahtarı) değerlerine ihtiyacınız var. Bunlar Autopay satıcı portalında gösterilir: canlı için portal.autopay.eu, test için testportal.autopay.eu. Test hizmetlerinin kendi Service ID ve Shared key değerleri vardır; birini açmasını Autopay'den isteyin. Hizmetin hash fonksiyonu SHA-256 olmalıdır.

Para birimi: mağaza para birimi PLN, EUR, GBP, USD veya CZK olmalı ve Autopay hizmetiniz tarafından kabul edilmelidir.

Erişilebilir mağaza: Autopay, bildirimleri mağazanıza gönderebilmelidir; bu nedenle site, bakım modu, temel kimlik doğrulama (basic authentication) veya POST isteklerini engelleyen bir güvenlik duvarı olmadan internetten erişilebilir olmalıdır.

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 yolunu izleyin, eklenti ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_autopay_payment 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 > Autopay > Manage yolunu izleyin veya Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bölümüne VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Service ID ve Shared key değerlerini (test ve canlı için) girin ve hizmetinizin para birimlerini seçin.

6. Autopay portalında hizmetiniz için ITN URL'sini, dönüş URL'sini ve SHA-256 hash fonksiyonunu ayarlayın (bkz. Yapılandırma).

7. Enable/Disable seçeneğini açın. Test modunda bir test siparişi verin, ardından gerçek ödemeler için Test mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfada: WooCommerce > Settings > Payments > Autopay. Alanların üstünde sayfa, seçili ortamın Service ID veya Shared key değeri boşsa ve mağaza para birimi Currencies içinde seçili değilse sizi uyarır. Her iki durumda da ödeme yöntemi ödeme sayfasında gizlenir. Ödeme yöntemleri listesinde, seçili ortamın kimlik bilgileri girilene kadar Autopay kurulum gerektiriyor olarak işaretlenir.

Genel

Enable/Disable: Enable Autopay payment gateway ödeme yöntemini açar veya kapatır. Varsayılan: kapalı.

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

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay online by bank transfer, BLIK or card. You will be redirected to the secure Autopay payment page.

Autopay hizmeti

Service ID ve Shared key, Autopay satıcı portalında (portal.autopay.eu veya testportal.autopay.eu) gösterilir.

Test mode: Use the Autopay test environment (testpay.autopay.eu) and the test credentials below. Varsayılan: açık. Canlı kimlik bilgileriyle pay.autopay.eu üzerinden gerçek ödeme almak için kapatın.

Service ID (production): portal.autopay.eu'dan alınan sayısal hizmet kimliği.

Shared key (production): canlı hizmetin hash anahtarı. Gizli tutun.

Service ID (test): testportal.autopay.eu'dan alınan sayısal hizmet kimliği.

Shared key (test): test hizmetinin hash anahtarı.

Currencies: Autopay hizmetinizin kabul ettiği para birimleri: PLN, EUR, GBP, USD, CZK. Autopay genellikle para birimi başına ayrı bir hizmet açar. Ödeme yöntemi, yalnızca sipariş para birimi burada seçiliyse sunulur. Varsayılan: PLN.

Ödeme bildirimleri (ITN) ve dönüş adresi

Bu adresleri, hizmetiniz için Autopay portalına hem canlı hem test için girin. Kesin adresler ayarlar sayfasının bu bölümünde gösterilir.

ITN (transaction notification) URL: https://your-site/?wc-api=wc_ap_payment

Return URL (after payment): https://your-site/?wc-api=wc_ap_return

ITN URL'si olmadan siparişler hiçbir zaman ödenmiş olarak işaretlenmez. Her ITN, eşleşen hizmetin Shared key değeriyle oluşturulmuş SHA-256 hash ile kontrol edilir. Geçerli hash'i olmayan veya bilinmeyen bir Service ID içeren bildirimler reddedilir. Bir bildirim, yalnızca o siparişin ödemesi aynı Autopay hizmetiyle başlatılmışsa siparişe uygulanır. Test mode seçeneğini değiştirmeden önce başlatılan ödemelerin bildirimleri de doğru anahtarla yine doğrulanır.

Eklenti, ITN'de şu ödeme durumlarını işler:

SUCCESS: ödeme yapıldı; sipariş tutar ve para birimi kontrolünden sonra ödenmiş olarak işaretlenir.

PENDING: ödeme başlatıldı; bir not eklenir.

FAILURE: ödeme başarısız oldu; bekleyen sipariş Başarısız olur.

Gelişmiş

Logging: Log payment events seçeneği, WooCommerce > Status > Logs bölümüne, kaynak wcp_autopay_payment olarak yazar. Anahtarlar ve müşteri verileri hiçbir zaman günlüğe yazılmaz. Varsayılan: kapalı.

Ödeme süreci

Müşteri ödeme yöntemini seçer (varsayılan olarak Autopay) ve siparişi verir. Sonraki sayfada Thank you for your order. You are being redirected to Autopay to complete the payment. mesajı gösterilir ve müşteri Autopay ödeme sayfasına yönlendirilir. Müşteri tarayıcının geri düğmesiyle dönerse, sayfa tekrar yönlendirme yapmak yerine Pay with Autopay düğmesini gösterir.

Eklenti, sipariş toplamını sipariş para biriminde, açıklama olarak sipariş numarasını (Order ve numara) ve müşterinin fatura e-posta adresini iletir. Autopay sayfasında müşteri ödeme yöntemini seçer ve öder.

Ödemeden sonra müşteri sipariş alındı sayfasına döner. Dönüş adresi imzalıdır, ancak sipariş durumunu hiçbir zaman değiştirmez. Sipariş, yalnızca Autopay imzalı bir ITN ile onaylarsa ve tutar ile para birimi siparişle eşleşirse ödenmiş olarak işaretlenir.

Ödeme başarısız olursa sipariş Başarısız olur ve müşteri siparişteki Pay bağlantısıyla yeniden ödeme yapabilir. Ödeme başlatılamazsa müşteri kısa bir mesaj görür; örneğin Autopay payments are not configured. Please choose another payment method or contact the store. veya Autopay'in bu para biriminde ödeme kabul edemediği bilgisi.

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

Eklentide WooCommerce'ten iade, abonelik veya yinelenen ödeme, kayıtlı kart (1-Click), ödeme sayfasında BLIK kodu veya kart formu, ödeme sayfasında banka veya ödeme kanalı seçimi yoktur ve her ortam için tek bir Service ID kullanılır.

Siparişler

Sipariş durumları

Pending payment: müşteri Autopay'e yönlendirildi ve Autopay ödemeyi henüz onaylamadı.

Processing or Completed: Autopay ödemeyi onayladı. WooCommerce durumu İşleniyor olarak ayarlar; yalnızca sanal ve indirilebilir ürünlü siparişlerde Tamamlandı olarak ayarlar. Sipariş notunda tutar, Autopay işlemi ve ödeme tarihi gösterilir. İşlem kimliği, Autopay işlem kimliğidir (RemoteID).

On hold: Autopay, sipariş toplamından farklı bir tutar veya para birimi bildirdi. Sipariş ödenmiş olarak işaretlenmedi. İşlemi Autopay portalında kontrol edin ve siparişi elle tamamlayın veya iade edin.

Failed: ödeme başarısız oldu. Müşteri siparişten yeniden ödeme yapabilir.

Ödenmiş bir sipariş, sonradan gelen bir başarısızlık bildirimiyle hiçbir zaman değiştirilmez. Autopay, ödenmiş bir sipariş için başka bir başarılı ödeme bildirirse, bir not müşterinin iki kez ödemiş olabileceği konusunda uyarır. Başka bir Autopay hizmetiyle başlatılmış bir ödemenin bildirimi uygulanmaz ve bir not bunu açıklar.

İadeler

WooCommerce'ten iade desteklenmez. Ödemeyi Autopay portalından iade edin, ardından WooCommerce'te manuel iade ile kaydedin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Payments > Autopay sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bölüm 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 bir alan adında çalışır. Anahtarı bir siteden kaldırmak alan adı hakkını serbest bırakmaz; bu hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa Autopay, ödeme sayfasında müşterilere gösterilmez. Ödeme yine de başlatılırsa müşteri This payment method is not available. Please choose another one. mesajını görür. Oturum açmış mağaza yöneticileri ödeme yöntemini yine görür; yöntem (unlicensed — visible to admins only) etiketiyle işaretlenir. Böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Plugins 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.

Lisans 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

Autopay ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, seçili ortamda bir Service ID ve Shared key bulunduğunu ve mağaza para biriminin Currencies içinde seçili olduğunu kontrol edin. Bunlardan biri eksikse ayarlar sayfası uyarı gösterir.

Ödeme yapıldı, ancak sipariş hâlâ Pending payment durumunda: Autopay ITN'yi iletmedi ya da mağaza bunu reddetti. Ayarlarda gösterilen ITN URL'sinin hizmet için Autopay portalında (canlı veya test) tanımlı olduğunu, hash fonksiyonunun SHA-256 olduğunu ve eklentideki Shared key'in hizmetle eşleştiğini kontrol edin. Mağazanın internetten erişilebilir olduğunu kontrol edin. Logging seçeneğini açın ve WooCommerce > Status > Logs bölümünde kaynak wcp_autopay_payment kayıtlarına bakın.

The log shows ITN rejected: invalid hash: Shared key hizmetle eşleşmiyor ya da hizmetin hash fonksiyonu SHA-256 değil.

The log shows that the service ID is not configured: bildirim, Service ID'si eklentide girilmemiş bir hizmetten geldi.

Sipariş, uyuşmazlık notuyla birlikte On hold durumuna alındı: Autopay, sipariş toplamından farklı bir tutar veya para birimi bildirdi. İşlemi Autopay portalında kontrol edin ve siparişi elle tamamlayın veya iade edin.

Bir not, bildirimin UYGULANMADIĞINI belirtiyor: bu siparişin ödemesi bu Autopay hizmetiyle başlatılmamış; örneğin canlı bir sipariş için test bildirimi. İşlemi Autopay portalında kontrol edin.

Ödemeden sonra müşteri ana sayfaya düşüyor: dönüş adresi doğrulanamadı; örneğin Service ID eklentide girilmemiş. Sipariş durumu etkilenmez; ITN'yi izler.

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ını serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse, anahtarı yeni alan adı için 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. Tamamen kaldırmak için Plugins sayfasında devre dışı bırakıp silin. Bu eklentinin lisans anahtarı, lisans durumu ve ağ geçidi ayarları kaldırılır. Eklentinin ayarlarını saklamak için bir seçeneği yoktur. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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