VibeFox dLocal for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerinde kurulmayı reddeder.

Mağaza erişimi: dLocal Go ödeme bildirimlerini iletebilmesi için mağazanıza internetten erişilebilmeli ve canlı ortamda HTTPS kullanmalıdır.

dLocal Go hesabı: dLocal Go panosunun Payment integration bölümünden API anahtarına ve API gizli anahtarına ihtiyacınız var: test için dashboard-sbx.dlocalgo.com, canlı için dashboard.dlocalgo.com. Test ve canlı ortamlar 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: modül bunları sınırlamaz. dLocal Go, müşterinin ülkesi ve sepet para birimi için hangi ödeme yöntemlerinin sunulacağına karar verir. Yalnızca PrestaShop'un ödeme kısıtlamaları geçerlidir.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek bir alan adında çalışır.

Kurulum

1. Back office'te Modules > Module Manager bölümüne gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme bittiğinde Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox dLocal Payment modülünü bulup Configure düğmesine tıklayın.

3. VibeFox lisans anahtarınızı Configure sayfasının üstündeki lisans bloğunda License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

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

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Sandbox'ta bir ödeme deneyin, ardından Environment seçeneğini Production olarak değiştirin.

Kurulumda modül dLocal payment on hold sipariş durumunu oluşturur. PrestaShop, yeni ödeme modülünü tüm para birimleri, ülkeler ve müşteri grupları için sunar. Bunları Payment > Preferences bölümünden sınırlayabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox dLocal Payment > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. İlk bölümün başlığı SANDBOX veya PRODUCTION gösterir. Seçili ortamın API anahtarı ve gizli anahtarı girilene kadar sayfa, ödeme yönteminin ödeme sayfasında gizli olduğunu bildirir; örneğin Enter the sandbox API key and secret: until then the payment method is hidden at checkout. Sandbox seçiliyken ve ödeme yöntemi etkinken Sandbox mode is active: payments are simulated, no money is charged. görünür.

dLocal Go

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ı. Ayrıca siparişte kayıtlı ödeme yöntemi adı olur. Varsayılan: dLocal Go. Zorunlu.

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 panosunun Payment integration bölümünden kopyalayın: dashboard-sbx.dlocalgo.com (sandbox) veya dashboard.dlocalgo.com (production). Bölüm her iki panoya bağlantı içerir.

Environment: yeni ödemeler için hangi kimlik bilgilerinin ve hangi dLocal Go sunucularının kullanılacağı.

Bir ödemenin iadeleri ve bildirimleri her zaman ödemenin yapıldığı ortamın kimlik bilgileriyle yapılır. Bu nedenle diğer ortamın ödemeleri hâlâ açıksa veya iade edilebilecekse o ortamın kimlik bilgilerini saklayın.

Sandbox API Key: dLocal Go sandbox API anahtarınız.

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

Production API Key: dLocal Go production API anahtarınız.

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

Kayıtlı anahtarlar ve gizli anahtarlar bir daha gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Clear saved credentials: bir anahtarı veya gizli anahtarı işaretleyin ve kaldırmak için Save düğmesine tıklayın. Boş alan kayıtlı değeri korur.

Ödeme

Default country: dLocal Go, müşterinin ülkesinin ödeme yöntemlerini gösterir; ülke önce fatura adresinden, sonra teslimat adresinden alınır. Sepette ikisi de yoksa bu ülke kullanılır. Varsayılan: Uruguay.

Auto-complete orders: ödenmiş siparişleri Payment accepted yerine Delivered durumuna getirir. Durum tek bir durum değişikliğiyle hemen ayarlanır. Varsayılan: kapalı.

Notifications (IPN): bildirimler, mağazanıza bir ödemenin veya iadenin değiştiğini söyler. Modül, her ödeme ve iade ile bildirim URL'lerini dLocal Go'ya gönderir; bu yüzden dLocal Go panosunda bir şey yapılandırmanız gerekmez. Bu alan iki URL'yi de gösterir:

Bildirimler API gizli anahtarınızla (HMAC-SHA256) doğrulanır. Geçerli imzası olmayan bildirimler reddedilir. Bir bildirim, ödemenin yapıldığı ortamın kimlik bilgileriyle imzalanmış olmalıdır. Bundan sonra ödemenin durumu, tutarı ve para birimi her zaman dLocal Go API'sinden yeniden okunur; bildirimin içeriğine güvenilmez. Bildirim olmadan sipariş yalnızca müşteri mağazaya geri döndüğünde oluşturulur.

Gelişmiş

Debug log: dLocal Go isteklerini ve bildirimlerini modül klasöründeki logs/dlocal_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. API kimlik bilgileri ve kişisel veriler kaydedilmez. Hatalar ve uyarılar her zaman yazılır; diğer kayıtlar yalnızca bu seçenek açıkken yazılır. Varsayılan: kapalı.

Log: günlüğün boyutunu ve en son kayıtlarını gösterir. Temizlemek için Clear log düğmesine tıklayın.

Delete data on uninstall: açıksa modül kaldırıldığında ağ geçidi ayarları ve günlük silinir. Siparişlerin ödeme verileri (dLocal ödemeleri ve iadeleri) ile dLocal payment on hold sipariş durumu her zaman korunur, böylece mevcut siparişler çalışmaya devam eder. Varsayılan: kapalı.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak dLocal Go). Sandbox modunda ödeme sayfası, ödeme yönteminin altında Sandbox mode: no real payment is made. mesajını gösterir. Onaylandıktan sonra modül, sepet toplamı için sepet para biriminde, müşterinin ülkesi, adı, e-postası ve telefonuyla birlikte bir dLocal Go ödemesi oluşturur ve müşteriyi dLocal Go ödeme sayfasına gönderir. Orada müşteri kendi ülkesine ait bir yöntemle öder. Ödeme, dLocal Go sayfasında Order # ve sepet numarası olarak görünür. Bu noktada henüz bir sipariş yoktur.

Ödeme yaptıktan sonra müşteri mağazanıza geri döner. Sipariş, yalnızca dLocal Go onayladığında ödenmiş olarak işaretlenir: imzalı bildirimle veya müşteri geri döndüğünde dLocal Go API'sine sunucu tarafı bir istekle. Sipariş bu noktada oluşturulur ve müşteri Your payment with dLocal Go has been received. mesajıyla standart sipariş onay sayfasını görür. Sipariş beklemeye alındıysa sayfa Your dLocal Go payment has been received and is being reviewed by the store. You will be informed when your order is confirmed. mesajını gösterir. dLocal Go ödemeyi henüz onaylamadıysa (örneğin henüz ödenmemiş bir nakit kuponu veya dLocal Go'ya ulaşılamadıysa), Payment confirmation sayfası müşteriden tekrar ödeme yapmamasını ister ve Check again ile Back to checkout seçeneklerini sunar. dLocal Go ödemeyi onaylar onaylamaz sipariş oluşturulur.

Müşteri dLocal Go sayfasından ödeme yapmadan ayrılırsa ödeme 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. Sepet korunur. Her yeni deneme yeni bir dLocal Go ödemesi oluşturur; aynı sepetin eski bir ödeme bağlantısı hâlâ ödenebilir ve sipariş oluşturur.

dLocal Go ödemeyi başlatamazsa müşteri kısa bir mesajla ödeme sayfasında kalır; örneğin dLocal could not start the payment: ve ardından dLocal'ın verdiği neden gösterilir. Bu, müşterinin ülkesi ve sepet para birimi dLocal Go hesabınızda etkinleştirilmediğinde de olur. dLocal Go kimlik bilgilerinizi reddederse müşteri This payment method is temporarily unavailable. Please choose another payment method or contact us. mesajını görür. Teknik neden günlüğe yazılır.

Bildirimler mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez.

Modül 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ı

Henüz sipariş yok: müşteri dLocal Go'ya yönlendirildi ve ödeme yapmadı ya da ödeme dLocal Go'da hâlâ beklemede. Yalnızca sepet vardır.

Payment accepted veya Delivered: ödeme onaylandı. Sipariş, Auto-complete orders açıksa Ödeme kabul edildi ya da Teslim edildi durumuna geçer. Ödeme, dLocal ödeme kimliği işlem kimliği olarak kaydedilir ve bir not ortamı ile ödeme kimliğini gösterir.

dLocal payment on hold: dLocal Go, sepet toplamından farklı bir tutar veya para birimi bildirdi (örneğin ödeme başladıktan sonra sepet başka bir sekmede değiştirildi) ya da ödeme, sipariş iptal edildikten sonra geldi. Not durumu açıklar. dLocal Go panosuyla karşılaştırın, ardından siparişi tamamlayın veya ödemeyi iade edin.

Refunded: ödeme modül üzerinden tamamen iade edildi.

Reddedilen, süresi dolan veya iptal edilen bir ödeme mevcut siparişi asla değiştirmez. Zaten ödenmiş bir sipariş için ikinci bir ödeme gelirse sipariş değişmez. Bir not, mükerrer ödemeyi dLocal Go panosunda iade etmenizi ister.

dLocal Go ödeme bloğu

Sipariş sayfasında dLocal ödeme kimliği, ortam (test ödemeleri için bir Sandbox rozetiyle), ödeme durumu, dLocal Go'nun tahsil ettiği tutar ve iade edilen tutar, iade formu, iade geçmişi ve siparişin dLocal Go notes bölümünü içeren bir dLocal Go payment bloğu görünür.

İadeler

dLocal Go payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isterseniz bir neden yazın ve Refund via dLocal Go düğmesine tıklayın. Refund this amount through dLocal Go? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Siparişleri düzenleme yetkisine ihtiyacınız vardır; Modules sayfalarına erişim gerekmez. İadeler, dLocal Go'nun tahsil ettiği tutar ve para biriminde yapılır; bu nedenle tutar veya para birimi uyuşmazlığından sonra, siparişin toplamına değil müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı ortama o ortamın kimlik bilgileriyle gönderilir. dLocal Go iadeyi kabul etmezse blok hatayı gösterir ve hiçbir iade kaydedilmez. Kabul edilen bir iade, iade kimliği, durumu ve nedeniyle birlikte iade geçmişine ve notlara eklenir. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez.

Ardından dLocal Go, nihai iade durumunu iade bildirimiyle iletir ve bu durum notlara eklenir. dLocal Go daha sonra kabul ettiği bir iadeyi reddeder veya iptal ederse not, paranın müşteriye geri dönmediği konusunda uyarır. Müşteriye tekrar veya başka bir yöntemle iade yapın.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri dLocal Go üzerinden para göndermez. dLocal Go panosunda yapılan iadeler PrestaShop'ta iade olarak kaydedilmez ve genellikle not eklemez. Gerekirse siparişi elle güncelleyin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox dLocal Payment lisans bloğu, Modules > Module Manager > VibeFox dLocal Payment > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı gizlenmiş olarak, durumu (örneğin lisansın hangi tarihe kadar etkin olduğunu ve alan adınızı) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: presta-payment-dlocal satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure izni olan çalışanlar değiştirebilir. Bloğun metinleri back office dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir; örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihli License expired on. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül son bilinen durumla çalışmaya devam eder.

Bir anahtar yalnızca bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da. Anahtarı mağazadan kaldırmak alan adı 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. PrestaShop vitrini back office'e giriş yaptığınızı bilmez, bu nedenle ödeme yöntemi sizden de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: başlatılmış ödemeler hâlâ onaylanır ve iadeler çalışır.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Back office'te çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak lisans anahtarını ve lisans durumunu her zaman siler.

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 girildiğini kontrol edin. Eksikse ayarlar sayfası bir uyarı gösterir. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Ödeme yapıldı ama sipariş oluşturulmadı: dLocal Go bildirim URL'sine ulaşamadı (güvenlik duvarı, temel kimlik doğrulama, genel adres yok) ve müşteri mağazaya geri dönmedi. Debug log seçeneğini açın, Log alanına bakın ve ödemeyi dLocal Go panosunda kontrol edin. Bir bildirim geldiğinde veya müşteri Check again düğmesini açtığında sipariş oluşturulur.

Bildirim Missing signature veya Invalid signature yanıtı veriyor: ayarlardaki API anahtarı ve gizli anahtar, bildirimi gönderen hesaba ait değil. Bildirimler ödemenin ortamının kimlik bilgileriyle doğrulanır; bu nedenle Environment değiştirilmeden önce başlatılan ödemeler, o ortamın kimlik bilgileri ayarlarda kaldığı sürece onaylanmaya devam eder.

Bildirim Gateway not configured yanıtı veriyor: ödemenin ortamına ait kimlik bilgileri eksik. Bunları girin; dLocal Go bildirimi yeniden dener.

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

Bildirim Temporarily unavailable yanıtı veriyor: sipariş aynı anda başka bir istekle onaylanıyordu ya da sipariş oluşturulamadı (örneğin modül devre dışı). dLocal Go bildirimi yeniden dener. Neden günlükte yazılıdır.

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

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.

Müşteri Payment gateway is not properly configured mesajını görüyor: seçili ortamın kimlik bilgileri eksik.

Ödemeden sonra sipariş dLocal payment on hold durumunda: dLocal Go payment bloğundaki notları okuyun. Ödenen tutar veya para birimi sepetten farklıydı ya da ödeme, sipariş iptal edildikten sonra geldi. Siparişi tamamlayın 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 yeniden deneyin.

Geliştiriciler için: modül belgeleri actionWcpDlocalPaymentData ve actionWcpDlocalCurrencyDecimals hook'larını listeler.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox dLocal Payment yanındaki menüyü açın ve Uninstall seçeneğini seçin. Bu modülün lisans anahtarı ve lisans durumu her zaman kaldırılır. Delete data on uninstall açıksa ağ geçidi ayarları ve günlük kaldırılır. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Siparişlerin dLocal ödemeleri ve iadeleri ile dLocal payment on hold sipariş durumu her zaman korunur, bu nedenle daha önce ödenen siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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