VibeFox dLocal for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

dLocal Go hesabı: dLocal Go hesabınızın API anahtarına ve API gizli anahtarına ihtiyacınız var; bunları dLocal Go panelindeki Payment integration sayfasından alabilirsiniz: 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. Eklenti yalnızca dLocal Go ile çalışır, kurumsal dLocal Payments API'si ile değil.

Para birimleri ve ülkeler: eklenti bunları sınırlamaz. dLocal Go, dLocal Go hesabınıza göre müşterinin ülkesi ve sipariş para birimi için hangi ödeme yöntemlerini sunacağına kendisi karar verir.

Erişilebilir mağaza: dLocal Go, ödeme ve iade bildirimlerini kendi sunucularından gönderir; bu nedenle bildirim URL'lerinin HTTPS üzerinden internetten erişilebilir olması gerekir.

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

Kurulum

İndirme, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_dlocal_payment-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_dlocal_payment.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı her iki sürüm için aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_dlocal_payment-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu yüzden Extensions > Modifications bölümünü yenilemeniz gerekmez. Yükleyici yerine, bu paketteki upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin ve tür olarak Payments seçin. VibeFox dLocal Payment eklentisini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme eklentileri listesini değiştirme yetkisine sahip olması gerekir.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem düğmesi) tıklayın. VibeFox lisans anahtarınızı sayfanın üst kısmındaki lisans bloğunda bulunan License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Test ortamı için API anahtarını ve API gizli anahtarını girin; gerçek ödemeler için de canlı ortamın bilgilerini girin. Environment seçeneğini belirleyin (bkz. Yapılandırma).

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Test ortamında bir deneme ödemesi yapın, ardından Environment seçeneğini Production olarak değiştirin.

OpenCart 4

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_dlocal_payment.ocmod.zip dosyasını seçin. Dosyayı yeniden adlandırmayın: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış bir paket çalışmaz.

2. Paket, aynı sayfadaki kurulu eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions bölümüne gidin ve tür olarak Payments seçin. VibeFox dLocal Payment eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını ve dLocal Go kimlik bilgilerini girin ve OpenCart 3 için 3 ila 5. adımlardaki gibi bir deneme ödemesi yapın. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca bildirim URL'leri farklıdır (bkz. Notifications (IPN)).

dLocal Go panelinde herhangi bir ayar yapmanız gerekmez: bildirim ve dönüş URL'leri her ödeme ve iade ile birlikte gönderilir. Yeni bir kurulum, ödeme yöntemi kapalı ve test ortamı seçili olarak başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox dLocal Payment > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Seçili ortamın API anahtarı ve gizli anahtarı girilene kadar sayfa, ödeme yönteminin ödeme sayfasında gizlendiği konusunda uyarır; örneğin: Enter the sandbox API key and secret: until then the payment method is hidden at checkout. Test ortamı seçili ve ödeme yöntemi etkin olduğunda Sandbox mode is active: payments are simulated, no money is charged. mesajı gösterilir. Eklentiyi değiştirme yetkiniz yoksa sayfa ayarları gösterir ama kaydedemez.

Kaydederken Title boş olamaz ve 128 karakterden uzun olamaz, Sort Order tam sayı olmalıdır, Total 0 veya daha büyük bir sayı olmalıdır ve bölge (geo zone) ile sipariş durumları mevcut olmalıdır. Aksi takdirde hiçbir şey kaydedilmez ve sayfa hatayı gösterir. Seçili ortamın anahtarı ve gizli anahtarı olmadan ödeme yöntemi etkinleştirilirse, ayarlar yukarıdaki uyarıyla birlikte kaydedilir.

dLocal Go

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

Title: müşterinin ödeme sayfasında gördüğü ödeme yöntemi adı. Ayrıca siparişte kaydedilen ödeme yöntemi adıdır. Varsayılan: dLocal Go. Zorunlu.

Description: müşterinin Confirm Order adımında onay düğmesinin üstünde gördüğü metin. Varsayılan: Yerel kartlar, banka havalesi veya nakit ile dLocal Go üzerinden ödeyin.

Sort Order: dLocal Go'nun ödeme sayfasındaki ödeme yöntemleri arasındaki sırası. Boş bırakın veya bir tam sayı girin.

Geo Zone: dLocal Go'yu yalnızca seçili bölgedeki ödeme adresleri için sunar. Varsayılan: All zones. Bölgeler System > Localisation > Geo Zones bölümünde ayarlanır.

Total: dLocal Go'nun sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde sepet tutarı. dLocal Go'yu her tutar için sunmak üzere boş bırakın.

API kimlik bilgileri

API anahtarını ve API gizli anahtarını dLocal Go panelindeki Payment integration bölümünden kopyalayın: dashboard-sbx.dlocalgo.com (test ortamı) veya dashboard.dlocalgo.com (canlı ortam). Bölümde her iki panele de bağlantılar bulunur.

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 bilgilerini kullanır; bu nedenle diğer ortamın ödemeleri hâlâ açıksa veya iade edilebilirse o ortamın kimlik bilgilerini saklayın.

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.

Kaydedilen anahtarlar ve gizli anahtarlar bir daha gösterilmez. Alan boş kalır ve Kaydedildi — korumak için boş bırakın. mesajını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı bir değeri kaldırmak için alanın altındaki Clear the saved value kutusunu işaretleyin ve Save düğmesine tıklayın.

Ödeme

Default country: dLocal Go, müşterinin ülkesine ait ödeme yöntemlerini gösterir; bu ülke önce fatura adresinden, ardından teslimat adresinden alınır. Siparişte ikisi de yoksa bu ülke kullanılır. Listede mağazanızın ülkeleri gösterilir. Varsayılan: Uruguay.

Auto-complete orders: ödenen siparişlere Paid Order Status yerine Complete Order Status atanır. Varsayılan: kapalı.

Notifications (IPN): bildirimler, mağazanıza bir ödemenin veya iadenin değiştiğini bildirir. Eklenti, her ödeme ve iade ile birlikte bildirim URL'lerini dLocal Go'ya gönderir; bu nedenle dLocal Go panelinde bir şey yapılandırmanız gerekmez. Bu alan, OpenCart kurulumunuzun vitrin adresinden oluşturulan iki URL'yi gösterir:

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

Siparişler

OpenCart siparişi Confirm Order adımında durum olmadan (eksik sipariş) oluşturur. Sipariş, yalnızca dLocal Go ödemeyi onayladıktan sonra bir durum alır. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Paid Order Status: onaylanmış bir ödemeden sonraki sipariş durumu. Varsayılan: İşleniyor.

Complete Order Status: Auto-complete orders açıkken onaylanmış bir ödemeden sonraki sipariş durumu. Varsayılan: Tamamlandı.

On Hold (Review) Status: tutarı veya para birimi siparişle eşleşmeyen ya da sipariş iptal edildikten sonra gelen ödemeler bu durumu ve nedenini açıklayan bir not alır. Varsayılan: Beklemede; çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturabilir ve burada seçebilirsiniz.

Refunded Status: ödeme, sipariş sayfasından tamamen iade edildikten sonra atanır. Varsayılan: İade edildi.

Gelişmiş

Debug log: dLocal Go isteklerini ve bildirimlerini OpenCart günlük klasöründeki (storage/logs) dlocal_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında bir yedek dosyaya taşınır. API kimlik bilgileri ve kişisel veriler günlüğe yazılmaz. 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. Boşaltmak için Clear log düğmesine tıklayın.

Delete data on uninstall: açıkken eklentiyi kaldırmak, ağ geçidi ayarlarını ve günlüğü siler. Siparişlerin ödeme verileri (dLocal ödemeleri ve iadeleri) her zaman korunur, böylece mevcut siparişler çalışmaya devam eder. Varsayılan: kapalı.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. API kimlik bilgileri dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın. Kayıtlı API kimlik bilgileri korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak dLocal Go). Confirm Order adımında müşteri açıklamanızı ve You will be redirected to the dLocal Go checkout page. notunu görür. Test ortamında ayrıca Sandbox mode: no real payment is made. gösterilir. OpenCart siparişi bu adımda, hâlâ durum olmadan oluşturur. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş tutarı için sipariş para biriminde bir dLocal Go ödemesi oluşturur; müşterinin ülkesi, adı, e-posta adresi ve telefonuyla birlikte müşteriyi dLocal Go ödeme sayfasına yönlendirir. Orada müşteri, kendi ülkesindeki bir yöntemle öder. dLocal Go sayfasında ödeme Order # ve sipariş numarası olarak görünür. OpenCart 4'te müşteri ödeme yöntemini, ödeme yöntemi bloğundaki Choose düğmesiyle Payment method options penceresinde seçer ve ödeme sayfasının altındaki Confirm Order düğmesine tıklar. Mağaza bir ödeme adresi istemezse (OpenCart 4 varsayılanı), müşterinin teslimat adresinin ülkesi ve adı kullanılır.

Ödemeden sonra müşteri mağazanıza 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. Dönüş adresi, ödeme denemesine ait rastgele bir jeton içerir. Ardından sipariş, OpenCart'ın standart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle bir durum alır; müşteri OpenCart sipariş başarı sayfasını Your payment with dLocal Go has been received. mesajıyla görür. Sipariş inceleme durumuna 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. gösterir. dLocal Go ödemeyi henüz onaylamadıysa (örneğin henüz ödenmemiş bir nakit kuponu varsa veya dLocal Go'ya ulaşılamadıysa), bir Payment confirmation sayfası müşteriden tekrar ödeme yapmamasını ister ve Check again ile Back to checkout seçeneklerini sunar. Sipariş, dLocal Go ödemeyi onaylar onaylamaz bir durum alır. OpenCart 4'te tarayıcı, dLocal Go müşteriyi geri gönderdiğinde mağazanın oturumunu iletmez; bu nedenle eklenti önce kısa bir sayfa gösterir ve aynı dönüş adresini mağazanızdan yeniden açar. Müşteri sepetini ve oturumunu korur.

Müşteri ödeme yapmadan dLocal Go sayfasından ayrılırsa ödeme sayfasına geri 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 şudur: Your dLocal payment was not completed: it was declined or it expired. Please try again or choose another payment method. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir. Sepet korunur. Confirm Order düğmesine her tıklamada yeni bir dLocal Go ödemesi oluşturulur ve OpenCart 3'te Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturulur; OpenCart 4 ödeme sayfası için tek bir sipariş tutar ve onu günceller, dolayısıyla yeni ödeme aynı siparişe aittir. Daha eski bir ödeme bağlantısı hâlâ ödenebilir ve kendi siparişini onaylar. Yeni bir ödeme başlamadan önce, aynı siparişin ve aynı müşteri oturumunun (son 24 saat) açık ödemeleri dLocal Go'dan okunur: biri ödenmişse, o sipariş onaylanır ve müşteri ikinci bir ödeme yapmadan başarı sayfasına gider.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme sayfasında tutar. Bu sipariş bu arada ödenmeden kapatılmışsa (örneğin iptal edildi veya süresi doldu), Confirm Order veya dLocal Go'dan dönüş müşteriyi Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. mesajıyla ödeme sayfasına geri gönderir ve sonraki Confirm Order sepet için yeni bir sipariş öder.

dLocal Go ödemeyi başlatamazsa müşteri, kısa bir mesajla Confirm Order adımında kalır; örneğin dLocal could not start the payment: ve ardından dLocal'in bildirdiği neden gösterilir. Bu, müşterinin ülkesi ve sipariş para birimi dLocal Go hesabınızda etkin değilse 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.

Mağaza bakım modundayken de bildirimler çalışır: OpenCart 3 ödeme eklentilerinin isteklerine izin verir, OpenCart 4'te ise eklenti bildirimler ve müşteri dönüşü için bir başlangıç eylemi ekler.

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

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri dLocal Go'ya yönlendirildi ve ödeme yapmadı, ödeme reddedildi veya süresi doldu ya da dLocal Go'da hâlâ beklemede. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Paid Order Status (varsayılan İşleniyor) veya Complete Order Status (varsayılan Tamamlandı): ödeme onaylandı. Auto-complete orders açıksa sipariş Complete Order Status alır. Bir not, ortamı ve dLocal ödeme kimliğini gösterir.

On Hold (Review) Status (varsayılan Beklemede): dLocal Go, sipariş toplamından farklı bir tutar veya para birimi bildirdi ya da ödeme siparişin iptal edilmesinden sonra geldi. Not nedenini açıklar. dLocal Go panelinde kontrol edin, ardından siparişi yerine getirin veya ödemeyi iade edin.

Refunded Status (varsayılan İade edildi): ödeme eklenti üzerinden tamamen iade edildi.

Reddedilen, süresi dolan veya iptal edilen bir ödeme, zaten bir durumu olan 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 panelinden iade etmenizi ister. Aynı sepet (aynı müşteri oturumu ve sepet içeriği) başka bir siparişle bir kez daha ödendiğinde, örneğin ikinci bir tarayıcı sekmesinde, ödenmiş siparişe aynı türde bir not eklenir; o diğer sipariş herhangi bir durum almaz.

Notlar, müşterinin görmediği siparişin History bölümündeki kayıtlardır.

VibeFox dLocal Payment sekmesi

Sales > Orders bölümünde dLocal Go ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında, VibeFox dLocal Payment sekmesi Payment ID, Environment (test veya canlı), ödemenin Status değerini, Paid / refunded tutarlarını, iade formunu, iade geçmişini ve siparişin dLocal Go notes notlarını gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox dLocal Payment sekmesinde Amount girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) 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. Eklentiyi değiştirme yetkisine sahip olmanız gerekir (System > Users > User Groups bölümünde ayarlanır). İ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ş 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 sekme 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 müşteriye bildirilmeden ve ürünleri stoğa geri eklemeden, elle yapılan bir durum değişikliği gibi Refunded Status durumuna alır. Kısmi iade durumu değiştirmez. İadeler, dLocal Go ödemeyi onayladıktan sonra kullanılabilir.

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

Sales > Returns bölümündeki ürün iadeleri dLocal Go üzerinden para geri göndermez. dLocal Go panelinde yapılan iadeler OpenCart'ta iade olarak kaydedilmez. Gerekirse siparişi elle güncelleyin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox dLocal Payment lisans bloğu, Extensions > Extensions > Payments > VibeFox dLocal Payment > Edit bölümündeki ilk bloktur ve ayarların üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskeli olarak, durumu (örneğin lisansın ne zamana kadar geçerli olduğu ve alan adınız) ve durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu mağazadan kaldırmak için Remove key düğmelerini gösterir. Bunların altında Product: opencart-payment-dlocal satırı ve hesabınızda vibefox.net'i açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca eklenti için Modify yetkisi olan yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici dilini izler (İngilizce ve Rusça dahildir).

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

Bir anahtar bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızda boşaltı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. Yönetim paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada (unlicensed — visible to admins only) işaretiyle hâlâ görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetim paneli Dashboard bölümünde bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır 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. Yönetim panelinde Dashboard veya Edit sayfasını açtığınızda durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir kez. Cron işi gerekmez. Eklentinin kaldırılması her zaman lisans anahtarını ve lisans durumunu 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 girili olduğunu kontrol edin. Eksikse ayarlar sayfasında bir uyarı görünür. Ayrıca ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlardaki Total tutarına ulaştığını kontrol edin.

Ödeme başarılı oldu ama sipariş durumsuz kaldı: dLocal Go bildirim URL'sine ulaşamadı (güvenlik duvarı, temel kimlik doğrulama veya herkese açık bir HTTPS adresi olmaması) ve müşteri mağazaya geri dönmedi. Debug log seçeneğini açın, Log alanına bakın ve dLocal Go panelinde ödemeyi kontrol edin. Bir bildirim geldiğinde veya müşteri Check again düğmesine tıkladığında sipariş durum alır.

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

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ş tam o sırada başka bir istek tarafından onaylanıyordu veya sipariş durumu ayarlanamadı. dLocal Go bildirimi yeniden dener. Neden günlüktedir.

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

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ş inceleme durumunda: VibeFox dLocal Payment sekmesindeki notları okuyun. Ödenen tutar veya para birimi siparişle uyuşmuyordu ya da ödeme siparişin iptal edilmesinden sonra geldi. Siparişi yerine getirin veya ödemeyi iade edin.

Sekmede iade formu yok: sekme nedeni gösterir: ödeme henüz onaylanmamış, tamamen iade edilmiş, kullanıcı grubunuzun eklentiyi değiştirme yetkisi yok veya ödeme ortamının kimlik bilgileri eksik.

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

Geliştiriciler için: eklenti, OpenCart olaylarını tetikler: dlocal_p_payment_data (ödeme isteği ve sipariş, ödeme oluşturulmadan önce) ve dlocal_p_currency_decimals (bir para biriminin ondalık basamakları).

Kaldırma

Extensions > Extensions bölümüne gidin, tür olarak Payments seçin ve VibeFox dLocal Payment yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman silinir. OpenCart, eklentinin kendi ayarlarını her zaman siler: Enable/Disable, Sort Order, Geo Zone, Total ve Orders bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılan değerlerine döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te olayları ve dLocal Go'nun bakım modundan geçmesini sağlayan başlangıç eylemi de kaldırılır). Delete data on uninstall açıksa diğer ağ geçidi ayarları (başlık, açıklama, ortam, kimlik bilgileri, varsayılan ülke, otomatik tamamlama, günlükleme) ve günlük silinir. Kapalıysa, sonraki bir yeniden kurulum için saklanırlar. Siparişlerin dLocal ödemeleri ve iadeleri her zaman korunur; bu nedenle daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te yüklenen dosyaları da kaldırmak için, kaldırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu eklentiler listesinde VibeFox dLocal Payment yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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