VibeFox dLocal for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin.

PHP: 8.0 veya üzeri. Eklenti daha eski bir PHP veya WordPress sürümünde etkinleştirilmez.

Site erişimi: dLocal Go'nun ödeme bildirimlerini iletebilmesi için siteniz internetten erişilebilir olmalı ve canlı ortamda HTTPS kullanmalıdır. Bir güvenlik duvarı, bakım modu veya temel kimlik doğrulama bunları engelleyebilir.

dLocal Go hesabı: dLocal Go panelinin Payment integration bölümündeki API anahtarına ve API gizli anahtarına ihtiyacınız vardır: test ortamı için dashboard-sbx.dlocalgo.com, canlı ortam için dashboard.dlocalgo.com. Test ortamı ve canlı ortam farklı kimlik bilgileri kullanır. Kurumsal dLocal Payments API'si (X-Login / X-Trans-Key kimlik bilgileri) farklı bir üründür ve desteklenmez.

Ülkeler ve para birimleri: eklenti bunları sınırlamaz. Müşterinin ülkesi ve mağaza para birimi için hangi ödeme yöntemlerinin sunulacağına dLocal Go karar verir.

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

2. Activate düğmesine tıklayın. WooCommerce etkin olmalıdır.

3. Ayarları açın: WooCommerce > Settings > Payments > dLocal Go > Manage veya Eklentiler sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. VibeFox lisans anahtarınızı sayfanın üst kısmındaki lisans bloğuna girin ve Activate düğmesine tıklayın.

5. Environment seçin ve o ortamın API anahtarını ve API gizli anahtarını yapıştırın (bkz. Yapılandırma).

6. Enable/Disable seçeneğini açın ve kaydedin. Test ortamında bir ödemeyi deneyin, ardından Environment ayarını Production olarak değiştirin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > dLocal Go. Sayfa başlığında SANDBOX veya PRODUCTION gösterilir. Seçili ortamın API anahtarı ve gizli anahtarı girilene kadar sayfa, ödeme yönteminin ödeme sayfasında gizlendiği konusunda sizi uyarır. Test ortamı seçiliyken ve ödeme geçidi etkinken sayfada Sandbox mode is active: payments are simulated, no money is charged. gösterilir. Ödeme yöntemleri listesinde dLocal Go, kimlik bilgileri ayarlanana kadar kurulum gerektiriyor olarak işaretlenir ve test ortamında Test mode gösterir.

Genel

Enable/Disable: Enable dLocal Go ö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: dLocal Go.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay with local cards, bank transfer or cash via dLocal Go.

API kimlik bilgileri

API anahtarını ve API gizli anahtarını dLocal Go panelinin Payment integration bölümünden kopyalayın: dashboard-sbx.dlocalgo.com (test ortamı) veya dashboard.dlocalgo.com (canlı ortam). Tüm kimlik bilgisi alanları parola alanlarıdır.

Environment: hangi kimlik bilgilerinin ve hangi dLocal Go sunucularının kullanılacağı.

Sandbox API Key: dLocal Go test ortamı API anahtarınız.

Sandbox API Secret: dLocal Go test ortamı API gizli anahtarınız.

Production API Key: dLocal Go canlı ortam API anahtarınız.

Production API Secret: dLocal Go canlı ortam API gizli anahtarınız.

Ödeme

Default country: dLocal Go, fatura adresinden, o yoksa teslimat adresinden alınan müşteri ülkesinin ödeme yöntemlerini gösterir. Siparişte ikisi de olmadığında bu ülke kullanılır. Varsayılan: Uruguay.

Auto-complete orders: Set paid orders to "Completed" instead of "Processing". Durum tek seferde ayarlanır ve tek bir e-posta grubu gönderilir. Varsayılan: kapalı.

Bildirimler (IPN)

Bildirimler, mağazanıza bir ödemenin veya iadenin değiştiğini haber verir. Eklenti bildirim URL'lerini her ödeme ve iadeyle birlikte dLocal Go'ya gönderir; bu nedenle dLocal Go panelinde hiçbir şeyin yapılandırılması gerekmez. Ayarların bu bölümü iki URL'yi de gösterir:

Bildirimler API gizli anahtarınızla doğrulanır (HMAC-SHA256). Geçerli imzası olmayan bildirimler reddedilir. Ardından ödemenin durumu, tutarı ve para birimi her zaman dLocal Go API'sinden yeniden okunur; bildirimin içeriğine güvenilmez. Bildirimler olmadan bir sipariş yalnızca müşteri mağazaya geri döndüğünde güncellenir.

Gelişmiş

Debug log: Log API requests and notifications ayrıntıları API kimlik bilgileri veya kişisel veriler olmadan WooCommerce > Status > Logs altına, wcp_dlocal_payment kaynağıyla yazar. Hatalar her zaman günlüğe kaydedilir. Varsayılan: kapalı.

Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted (order payment data is kept). Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini (varsayılan olarak dLocal Go) seçer ve siparişi verir. Eklenti, sipariş toplamı için sipariş para biriminde, müşterinin ülkesi, adı, e-postası ve telefonuyla bir dLocal Go ödemesi oluşturur ve müşteriyi dLocal Go ödeme sayfasına yönlendirir. Orada müşteri kendi ülkesine ait bir yöntemle öder. Ödeme, dLocal Go sayfasında Order # ve sipariş numarası olarak görünür. Test modunda ödeme sayfası, ödeme yönteminin altında Sandbox mode: no real payment is made. gösterir.

Ödemeden sonra müşteri mağazanızın sipariş alındı sayfasına döner. Sipariş yalnızca dLocal Go onayladıktan sonra ödenmiş olarak işaretlenir: imzalı bildirimle veya müşteri o sayfaya geldiğinde dLocal Go API'sine yapılan sunucu tarafı bir istekle.

Müşteri dLocal Go sayfasından ödeme yapmadan ayrılırsa ödeme sayfasına (veya Pay for order sayfasına) döner ve The payment at dLocal Go was not completed. You can try again or choose another payment method. mesajını görür. Ödeme reddedildiyse veya süresi dolduysa mesaj Your dLocal payment was not completed: it was declined or it expired. Please try again or choose another payment method. olur. Ödemenin yapılmış olduğu anlaşılırsa müşteri sipariş alındı sayfasına yönlendirilir. Aynı siparişin daha eski bir ödeme bağlantısı, yeniden denemeden sonra da ödenebilir.

dLocal Go ödemeyi başlatamazsa müşteri teknik ayrıntı içermeyen kısa bir mesaj görür, örneğin dLocal could not start the payment: ve ardından dLocal'ın bildirdiği neden; müşteri başka bir yöntem seçebilir. Bu, müşterinin ülkesi ve mağaza para birimi dLocal Go hesabınızda etkin olmadığında da olur. Teknik neden günlüğe yazılır.

Ödeme yöntemi klasik ödeme sayfasında, Ödeme bloğunda ve Pay for order sayfasında çalışır. WooCommerce Yüksek Performanslı Sipariş Depolama (HPOS) ile uyumludur.

Eklenti yalnızca dLocal Go sayfasında tek seferlik ödemeleri kabul eder. Sitenizde kart formu, kayıtlı kart, abonelik veya ayrı yetkilendirme ve tahsilat yoktur.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri dLocal Go'ya yönlendirildi ve henüz ödeme yapmadı ya da ödeme dLocal Go'da beklemede (örneğin henüz ödenmemiş bir nakit ödeme kuponu). Her yeni ödeme denemesi, dLocal ödeme kimliği, tutarı ve ortamıyla siparişe not edilir.

Processing or Completed: ödeme onaylandı. Sipariş Hazırlanıyor (WooCommerce varsayılanı) veya Auto-complete orders açıkken Tamamlandı durumundadır. İşlem kimliği, dLocal ödeme kimliğidir.

On hold: dLocal Go sipariş toplamından farklı bir tutar veya para birimi bildirdi ya da ödeme sipariş iptal edildikten sonra geldi. Sipariş notu bunu açıklar. dLocal Go paneliyle karşılaştırın ve siparişi gönderin ya da ödemeyi iade edin.

Failed: son ödeme denemesi reddedildi veya süresi doldu. Müşteri tekrar deneyebilir.

Cancelled: dLocal Go son ödeme denemesini iptal edilmiş olarak bildirdi.

Ödenmemiş bir siparişi yalnızca son ödeme denemesi başarısız veya iptal durumuna getirebilir. Ödenmiş bir sipariş eski bir bildirimle asla yeniden açılmaz. Zaten ödenmiş bir sipariş için ikinci bir ödeme gelirse sipariş değiştirilmez. Bir not, yinelenen ödemeyi dLocal Go panelinden iade etmenizi ister.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via dLocal Go düğmesine tıklayın. dLocal Go üzerinden ödenen siparişler için tam ve kısmi iadeler desteklenir. İade, ödemenin yapıldığı ortama, o ortamın kimlik bilgileriyle gönderilir. dLocal Go iadeyi kabul etmezse WooCommerce hatayı gösterir ve iade kaydedilmez. Kabul edilen bir iade, iade kimliği ve durumuyla sipariş notlarına eklenir.

Ardından dLocal Go nihai iade durumunu iade bildirimiyle bildirir ve bu durum sipariş notlarına eklenir. dLocal Go daha önce kabul ettiği bir iadeyi sonradan reddeder veya iptal ederse not, paranın müşteriye iade edilmediği konusunda uyarır. Bunun için kaydedilen WooCommerce iadesini inceleyin: silip yeniden iade edin ya da müşteriye başka bir yolla iade yapın.

dLocal Go panelinde yapılan iadeler WooCommerce iadesi olarak kaydedilmez ve genellikle sipariş notu eklemez. Gerekirse WooCommerce'te Refund via dLocal Go kullanmadan manuel bir iade oluşturun.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > dLocal Go sayfasının üst kısmındadır. 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, 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, o alan adının yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan dLocal Go, ö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. Oturum açmış 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 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 ve iadeler çalışır.

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

dLocal Go ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve seçili Environment için API anahtarı ile API gizli anahtarının ayarlandığını kontrol edin. Bunlar eksik olduğunda ayarlar sayfası bir uyarı gösterir.

Ödeme gerçekleşti, ancak sipariş Ödeme bekleniyor durumunda kalıyor: dLocal Go bildirim URL'sine ulaşamadı (güvenlik duvarı, bakım modu, temel kimlik doğrulama) ve müşteri sipariş alındı sayfasına dönmedi. WooCommerce > Status > Logs, kaynak wcp_dlocal_payment ve dLocal Go panelindeki ödemeyi kontrol edin. Bir bildirim gelir gelmez veya müşteri sipariş alındı sayfasını açar açmaz sipariş güncellenir.

Bildirim Missing signature veya Invalid signature yanıtını veriyor: ayarlardaki API anahtarı ve gizli anahtar, bildirimi gönderen hesaba ait değil. Bildirimler iki ortamın kimlik bilgileriyle de kontrol edilir; böylece Environment ayarını değiştirmeden önce başlatılan ödemeler, ortamlarının kimlik bilgileri ayarlarda kaldığı sürece onaylanmaya devam eder.

Bildirim Gateway not configured yanıtını veriyor: seçili ortamın kimlik bilgileri eksik. dLocal Go bildirimi yeniden dener.

Bildirim API verification failed yanıtını veriyor: ödemeyi okumak için dLocal Go API'sine ulaşılamadı. dLocal Go bildirimi yeniden dener.

Bildirim Order not found yanıtını veriyor: ödeme bu mağazanın bir siparişine ait değil; örneğin aynı dLocal Go hesabını kullanan başka bir site tarafından oluşturuldu.

Müşteri This payment method is temporarily unavailable mesajını görüyor: dLocal Go API anahtarını veya gizli anahtarı reddetti. Seçili ortamın kimlik bilgilerini kontrol edin.

Sipariş ödemeden sonra Beklemede durumunda: sipariş notunu okuyun. Ödenen tutar veya para birimi siparişten farklıydı ya da ödeme sipariş iptal edildikten sonra geldi. Siparişi gönderin veya ödemeyi iade edin.

İade, eksik kimlik bilgileriyle ilgili bir mesajla başarısız oluyor: ödeme diğer ortamda yapıldı ve o ortamın kimlik bilgileri ayarlanmamış. Bunları girin ve tekrar deneyin.

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 yuvayı 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 bilinen son durumla çalışmaya devam eder.

Geliştiriciler için eklenti belgeleri dlocal_p_payment_data, dlocal_p_currency_decimals ve dlocal_p_icon filtrelerini listeler.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi Plugins sayfasında devre dışı bırakıp silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ödeme geçidi ayarları ve günlükler yalnızca Delete data on uninstall açıksa kaldırılır. Aksi halde daha sonraki bir yeniden kurulum için kalırlar. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

dLocal, ilgili sahibinin ticari markasıdır. Bu eklentinin dLocal ile bir bağlantısı yoktur ve dLocal tarafından onaylanmamıştır.