VibeFox DPO for WooCommerce — Yardım

Gereksinimler

WordPress: 6.2 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin olmalıdır. Eklenti, WooCommerce olmadan etkinleşmeyi reddeder.

PHP: 8.0 veya üzeri.

DPO Pay hesabı: DPO satıcı hesabınızın Company Token ve Service Type ID bilgilerine ihtiyacınız vardır. DPO bunları hesabınız açıldığında verir; DPO hesap yöneticinizden veya dpogroup.com üzerinden edinin. DPO, kendi jeton ve service type bilgilerine sahip bir test hesabı da sağlayabilir. Ayrı bir test sunucusu yoktur: DPO, test ve canlı hesaplar için aynı API adresini kullanır ve hesap, jetona göre seçilir.

Para birimi: mağaza para biriminin DPO hesabınız tarafından desteklenmesi gerekir, örneğin USD, EUR, ZAR, KES, UGX, TZS, RWF, GHS, NGN, ZMW, XOF veya AED. DPO en fazla 2 ondalık basamak kabul eder, dolayısıyla 3 ondalık basamaklı sipariş toplamları (örneğin KWD 12.345) ödenemez.

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'a tıklayın. wcp_dpo_pay klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

2. Activate'e tıklayın.

3. Ayarları açın: WooCommerce > Settings > Payments > DPO Pay > Manage, ya da eklentiler sayfasında eklenti adının altındaki Settings'e tıklayın.

4. VibeFox lisans anahtarınızı sayfanın üstündeki lisans bloğuna girin ve Activate'e tıklayın.

5. Test ve/veya canlı Company Token ve Service Type bilgilerini girin (bkz. Yapılandırma).

6. Ayarlar sayfasında gösterilen push bildirim URL'sini DPO desteğine gönderin ve bunu hesabınız için ayarlamalarını isteyin.

7. Enable/Disable'ı açın. Test modunda bir test siparişi verin, ardından gerçek ödemeleri kabul etmek için Test mode işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > DPO Pay. Ağ geçidi etkinken seçili modun Company Token veya Service Type bilgisi boşsa, sayfa ödeme yönteminin ödeme sayfasında gizli olduğu konusunda uyarır ve kaydetme işlemi aynı hatayı gösterir. Test modu açıkken sayfa Test mode is on: payments are created with the test account credentials. mesajını gösterir.

Genel

Enable/Disable: Enable DPO Pay ö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: DPO Pay.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely by card or mobile money on the DPO Pay payment page.

API kimlik bilgileri

DPO, satıcı hesabınız için bir Company Token ve Service Type ID verir, test hesabı için de ayrı bilgiler sağlar. Bunları DPO hesap yöneticinizden veya dpogroup.com üzerinden edinin.

Test mode: Use the test account credentials below. Açıkken yeni ödemeler test Company Token ve Service Type ile oluşturulur. Varsayılan: açık. Gerçek kimlik bilgileriyle gerçek ödemeleri kabul etmek için işareti kaldırın. Mevcut siparişlerin durum kontrolleri her zaman ödemenin oluşturulduğu hesabı kullanır.

Test Company Token: DPO test hesabınızın Company Token'ı.

Test Service Type: DPO test hesabınızın sayısal Service Type ID'si.

Live Company Token: canlı DPO satıcı hesabınızın Company Token'ı.

Live Service Type: canlı DPO satıcı hesabınızın sayısal Service Type ID'si.

Service Type bir sayı olmalıdır. Başka herhangi bir değer kaydedilmez: sayfa bir hata gösterir ve önceki değeri korur. 1.0 sürümünden güncelliyorsanız, bu sürümün kimlik bilgileri de test alanlarına kopyalanır.

Ödeme bildirimleri

Push bildirimi, müşteri ödeme yaptıktan sonra tarayıcıyı kapatsa bile mağazanıza bir ödemenin yapıldığını anında bildirir. Bu bölümde push bildirim URL'si gösterilir. https://your-site/wc-api/dpo_pay_notify/ şeklinde görünür. Bir panelden ayarlanmaz: DPO desteğinden bu URL'yi hesabınız için ayarlamasını isteyin.

DPO push bildirimlerinin imzası yoktur, bu nedenle içeriklerine asla güvenilmez. Eklenti bunları yalnızca siparişi bulmak için kullanır ve ardından ödemeyi doğrudan DPO ile kontrol eder. Push URL'si olmasa da siparişler, müşteri mağazaya geri döndüğünde ve yönlendirmeden 15 dakika sonra ve ödeme süresi sınırından sonra yapılan otomatik yeniden kontrollerle onaylanır.

Siparişler

Successful payment status: doğrulanmış başarılı bir ödemeden sonraki sipariş durumu. Durum, ikinci bir değişiklik olmadan anında ayarlanır.

Gelişmiş

Logging: Enable logging, API çağrılarını ve bildirimleri WooCommerce > Status > Logs'a, kaynak wcp_dpo_pay olarak yazar. Hatalar her zaman günlüğe kaydedilir. Jetonlar maskelenir, müşteri verisi günlüğe kaydedilmez. Varsayılan: kapalı.

Delete data: Delete all plugin data when the plugin is deleted. Kaldırma işleminde ayarları, siparişlerde saklanan DPO verilerini ve günlükleri kaldırır. Devre dışı bırakma verileri asla silmez. Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan DPO Pay) ve siparişi verir. Eklenti, sipariş para biriminde sipariş toplamı için, açıklama olarak sipariş numarası ve site adınızla bir DPO işlemi oluşturur ve müşteriyi DPO ödeme sayfasına gönderir. Müşterinin adı, e-postası, telefonu ve adresi sayfayı önceden doldurmak için iletilir. Müşteri orada, DPO hesabınızda etkin olan herhangi bir yöntemle öder. Ödeme bağlantısı 5 saat geçerlidir.

Ödeme sonrasında müşteri mağazanıza geri döner. Sipariş yalnızca DPO onayladıktan sonra ödenmiş olarak işaretlenir: eklenti, müşteri geri döndüğünde, bir push bildirimi geldiğinde ve otomatik yeniden kontrollerde DPO'dan işlem sonucunu sorar. Ödeme onaylandığında müşteri sipariş alındı sayfasına gider.

Ödeme onaylanmazsa müşteri, şu mesajlardan biriyle ödeme sayfasına veya Pay for order sayfasına geri döner:

Müşteri, DPO sayfasında mağazaya geri dönmek için düğmeye tıklarsa, sipariş WooCommerce'in standart yoluyla iptal edilir ve DPO ödeme bağlantısı DPO'da iptal edilir.

Bir müşteri aynı sipariş için tekrar ödeme yaptığında, önceki DPO ödeme bağlantısı önce kontrol edilir. Ödenmişse sipariş, ikinci bir tahsilat olmadan tamamlanır. Hâlâ işleniyorsa müşteri Your previous payment for this order is still being processed by DPO. Please wait a few minutes before trying again. mesajını görür. Aksi halde eski bağlantı DPO'da iptal edilir ve yeni bir bağlantı oluşturulur.

DPO ödemeyi başlatamazsa, müşteri DPO hata koduna göre seçilen kısa bir mesaj görür; örneğin DPO Pay'in bu siparişin para birimini desteklemediğini veya tutarın DPO Pay'in izin verdiği sınırı aştığını görür ve başka bir ödeme yöntemi seçebilir.

Ö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 DPO sayfasında tek seferlik ödemeleri kabul eder. WooCommerce'den iade desteği, kayıtlı kart, abonelik veya yinelenen ödemeler, sitenizde kart alanları yoktur ve yalnızca yetkilendirilmiş ödemelerin tahsilatını yapmaz.

Siparişler

Sipariş durumları

Pending payment: müşteri DPO'ya yönlendirilmiştir ve henüz ödeme yapmamıştır veya DPO ödemeyi henüz onaylamamıştır.

Processing, Completed veya On hold: ödeme doğrulandı. Durum, Successful payment status'u takip eder. Sipariş notunda tutar, para birimi, onay kodu ve DPO işlem jetonunun başlangıcı gösterilir. İşlem kimliği, DPO işlem jetonudur.

On hold after payment: DPO bir ödemeyi onayladı, ancak tutar veya para birimi siparişten farklı, ödeme yalnızca yetkilendirilmiş ve tahsil edilmemiş, işlem fazla veya az ödenmiş, ya da sipariş zaten iptal edilmiş. Sipariş notu nedeni açıklar. İşlemi DPO portalında kontrol edin. Yalnızca yetkilendirilmiş bir ödemeyi DPO portalında tahsil edin veya iptal edin, ardından siparişi güncelleyin.

Failed: ödeme reddedildi, iptal edildi veya ödeme süresi sınırı aşıldı. Müşteri yeniden ödeme yapabilir.

Cancelled: müşteri DPO sayfasından mağazaya geri döndü veya sipariş sizin tarafınızdan ya da ödenmemiş siparişler için WooCommerce zaman aşımıyla iptal edildi. Ödenmemiş DPO ödeme bağlantısı DPO'da iptal edilir.

Daha sonraki bir reddedilme mesajı, zaten ödenmiş bir siparişi asla değiştirmez ve eski ödeme bağlantılarının sonuçları geçerli denemeyi asla başarısız kılmaz. DPO, zaten ödenmiş bir sipariş için ikinci bir başarılı ödemeyi onaylarsa, sipariş olası bir çift ödeme hakkında bir not alır, böylece bunu DPO portalında iade edebilirsiniz.

İadeler

WooCommerce'den iadeler bu sürümde kullanılamaz. Ödemeyi DPO satıcı portalında iade edin, ardından siparişi WooCommerce'de iade edildi olarak işaretleyin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden bir VibeFox lisans anahtarı ile çalışır. Lisans bloğu, WooCommerce > Settings > Payments > DPO Pay'in üst kısmında bulunur. Anahtarı License key'e yapıştırın ve Activate'e tıklayın. Blok, lisansın hangi tarihe kadar etkin olduğu ve alan adınız gibi durumu gösterir. Durumu yeniden kontrol etmek için Check now'u, başka bir anahtar girmek için Change key'i ve bu siteden kaldırmak için Remove key'i 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ı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan, DPO Pay müşterilere ödeme sayfasında gösterilmez. Buna rağmen bir ödeme 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 (unlicensed — visible to admins only) işaretiyle görmeye devam eder, böylece bir 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 onaylanmaya 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

DPO Pay ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable'ın açık olduğunu ve seçili modun Company Token ve Service Type bilgilerinin ayarlandığını kontrol edin: test modunda test alanları, diğer durumda canlı alanlar. Ayarlar sayfası bunlar eksik olduğunda bir uyarı gösterir.

Ödeme yapıldı, ancak sipariş Pending payment durumunda kalıyor: push bildirim URL'si büyük olasılıkla DPO hesabınız için ayarlanmamıştır ve müşteri mağazaya geri dönmemiştir. DPO desteğinden ayarlarda gösterilen URL'yi ayarlamasını isteyin. Sipariş, yönlendirmeden 15 dakika sonra yapılan otomatik yeniden kontrolle de onaylanır. Logging'i açın ve WooCommerce > Status > Logs'a, kaynak wcp_dpo_pay'e bakın.

Push bildirimi Unknown transaction yanıtı veriyor: işlem jetonu bu mağazanın bir DPO Pay siparişine ait değildir, örneğin bildirim aynı DPO hesabındaki başka bir mağazadan gelmiştir.

Push bildirimi Verification failed yanıtı veriyor: ödemeyi kontrol etmek için DPO'ya ulaşılamadı. DPO bildirimi tekrarlar ve otomatik yeniden kontrol de siparişi onaylar.

Service Type kaydedilmiyor: DPO'dan gelen sayısal Service Type ID olmalıdır.

Müşteri DPO Pay is temporarily unavailable görüyor: DPO, örneğin yanlış bir Company Token veya Service Type ya da diğer modun bir jetonu nedeniyle işlemi oluşturmayı reddetti. DPO sonuç kodu WooCommerce > Status > Logs'da, kaynak wcp_dpo_pay'dedir.

Müşteri, DPO'nun en fazla 2 ondalık basamak kabul ettiğini görüyor: sipariş toplamı 3 ondalık basamağa sahiptir. DPO bu tür tutarları tahsil edemez.

Sipariş ödemeden sonra On hold durumunda: sipariş notunu okuyun. Ödenen tutar veya para birimi siparişten farklıydı, ödeme yalnızca yetkilendirilmiş, işlem fazla veya az ödenmişti ya da sipariş iptal edilmişti. İşlemi DPO portalında inceleyin.

Lisans bloğu bir hata gösteriyor: bloktaki mesajı takip edin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa, vibefox.net hesabınızda bir yuvayı serbest bırakın ve Check now'a tıklayın. Site adresi değiştiyse, anahtarı yeni alan adı için etkinleştirmek üzere Check now'a 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 ve yalnızca zamanlanmış durum kontrollerini durdurur. Kaldırmak için, Plugins sayfasında devre dışı bırakıp silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ayarlar, siparişlerde saklanan DPO verileri, zamanlanmış kontroller ve günlükler, yalnızca Delete data açıksa kaldırılır. Aksi halde daha sonraki bir yeniden kuruluma hazır kalırlar. Mevcut siparişler, ödeme notlarını ve işlem kimliklerini korur.

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