VibeFox Midtrans 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.

Para birimi: Endonezya Rupiahı (IDR). Midtrans yalnızca IDR ile tahsilat yapar; bu nedenle ödeme yöntemi yalnızca ödeme para birimi IDR olduğunda sunulur. Para birimi dönüşümü yapılmaz. Mağazanızda yoksa System > Localisation > Currencies bölümünden IDR para birimini ekleyin.

Midtrans hesabı: Midtrans Dashboard > Settings > Access Keys bölümündeki Server Key'e ihtiyacınız vardır; hem sandbox panelinde hem de canlı panelde. Yalnızca Server Key kullanılır. Snap Redirect için Client Key gerekmez. Ödeme yöntemlerinin kendileri (GoPay, QRIS, sanal hesaplar ve diğerleri) Midtrans hesabınızda etkinleştirilir.

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

Kurulum

Yükleme, her iki OpenCart sürümünün paketlerini içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_midtrans_payment_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_midtrans_payment_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüz için olan paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_midtrans_payment_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications bölümünü yenilemeniz gerekmez. Yükleyici yerine, bu paketin 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 Payments türünü seçin. VibeFox Midtrans Payment Gateway eklentisini bulun ve Install düğmesine tıklayın (yeşil + düğmesi). Yönetici kullanıcınızın ödeme eklentileri listesini değiştirme iznine sahip olması gerekir.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem simgesi) tıklayın. VibeFox lisans anahtarınızı sayfanı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. Server Key'leri girin ve ödeme bildirim URL'sini Midtrans paneline kopyalayın (bkz. Yapılandırma).

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Sandbox'ta test edin, ardından Environment seçeneğini Production'a çevirin.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_midtrans_payment_gateway.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve adı değiştirilmiş bir paket çalışmaz.

2. Paket, aynı sayfadaki yüklü 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 Payments türünü seçin. VibeFox Midtrans Payment Gateway eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını, Server Key'leri ve bildirim URL'sini OpenCart 3 için 3 ila 5. adımlarda anlatıldığı gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca bildirim URL'si farklıdır (bkz. Yapılandırma).

Yeni bir kurulum, ödeme yöntemi kapalı ve Sandbox ortamı seçili olarak başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Midtrans Payment Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa, seçili ortamın Server Key'i eksikse (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve mağazanın varsayılan para birimi IDR değilse sizi uyarır; Sandbox seçiliyken Sandbox mode: payments are simulated, no real money is charged. mesajını gösterir. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ama kaydedemez.

Kaydederken Title 1 ila 128 karakter olmalı, Sort Order tam sayı olmalı, Total 0 veya daha büyük bir sayı olmalı ve Payment page expiry (minutes) tam sayı olmalıdır. Bir değer hatalıysa sayfa hatayı gösterir ve hiçbir şey kaydedilmez.

Midtrans

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

Title: ödeme sayfasında müşteriye gösterilen ödeme yöntemi başlığı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Midtrans. Zorunlu.

Description: Confirm Order adımında, onay düğmesinin üstünde müşteriye gösterilen metin. Varsayılan: Pay securely via Midtrans — GoPay, QRIS, ShopeePay, cards, bank transfer and more. Sandbox'ta bunun üstünde SANDBOX MODE: no real money is charged. satırı gösterilir.

Sort Order: ödeme sayfasında Midtrans'ın ödeme yöntemleri arasındaki konumu. Boş bırakın veya bir tam sayı girin.

Geo Zone: Midtrans'ı yalnızca seçilen coğrafi bölgedeki ödeme adresleri için sunun. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde ayarlanır.

Total: Midtrans'ın sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası toplamı. Midtrans'ı her tutar için sunmak üzere boş bırakın.

API kimlik bilgileri

Server Key'i Midtrans Dashboard > Settings > Access Keys bölümünden kopyalayın. Bölümde canlı panele ve sandbox paneline bağlantılar bulunur.

Environment: yeni ödemelerin kullandığı Midtrans ortamı. Geçiş yapıldığında seçili ortamın anahtarı ve API'si kullanılır. Siparişler, iadeler ve bildirimler için ödendikleri ortamı korur. Varsayılan: Sandbox.

Production Server Key: Mid-server- ile başlar. Gizli tutun.

Sandbox Server Key: SB-Mid-server- ile başlar.

Kaydedilmiş anahtarlar bir daha gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. mesajını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kaydedilmiş bir anahtarı kaldırmak için alanın altındaki Clear the saved key on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Ödeme bildirim URL'si

Bildirim, mağazanıza bir ödemenin yapıldığını bildirir. Notification URL alanı kullanılacak URL'yi gösterir. OpenCart 3'te şuna benzer: https://your-store/index.php?route=extension/payment/wcp_midtrans_payment_gateway/webhook, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_midtrans_payment_gateway/payment/wcp_midtrans_payment_gateway.webhook gibi görünür ve OpenCart kurulumunuzun vitrin adresinden oluşturulur. URL'yi ayarların gösterdiği gibi birebir kopyalayın ve kullandığınız sandbox panelinde ve canlı panelde Midtrans Dashboard > Settings > Payment > Notification URL alanına yapıştırın. URL internetten erişilebilir olmalıdır. Bir tarayıcıda açarsanız kısa bir açıklama gösterir; böylece erişilebilir olduğunu kontrol edebilirsiniz. Midtrans panelindeki Test notification URL düğmesine de yanıt verilir.

Her bildirim, Server Key'lerinizden biriyle oluşturulmuş geçerli bir imza taşımalıdır ve anahtarın ortamı ödemenin ortamıyla eşleşmelidir. Geçerli imza taşımayan bildirimler reddedilir. Sipariş değişmeden önce durum, Midtrans durum API'sinden yeniden okunur. Eklenti şu Midtrans işlem durumlarını işler:

Bildirim URL'si olmadan, bir sipariş yalnızca müşteri ödemeden sonra mağazaya döndüğünde onaylanır ve daha sonra yapılan gecikmeli bir ödeme, müşteri geri dönene kadar görülmez.

Ödeme ayarları

Midtrans yalnızca IDR ile tahsilat yapar ve tutarlar tam rupi olarak gönderilir. Sipariş kalemleri yuvarlanmış toplamı karşılamazsa Midtrans'a bir Rounding adjustment satırı gönderilir.

Payment page expiry (minutes): müşterinin ne kadar süre ödeme yapabileceği (Snap sayfası, sanal hesap ve benzeri). Midtrans varsayılanı için boş bırakın veya 0 girin.

Order ID prefix: Midtrans'a gönderilen numaraya eklenir; böylece birden fazla mağaza aynı Midtrans hesabını paylaşabilir. Numara, zaman damgalı OpenCart sipariş kimliğidir; örneğin OC-123-1700000000. Yalnızca harfler, rakamlar ve - _ . ~ kullanılabilir, en fazla 20 karakter; diğer karakterler kaydederken kaldırılır. Diğer mağazaların bildirimleri yok sayılır. Varsayılan: OC-.

Siparişler

OpenCart siparişi Confirm Order adımında durumsuz (eksik bir sipariş) olarak oluşturur. Sipariş, Midtrans işlemi onayladıktan sonra bir durum alır. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Status after payment: onaylanmış bir ödemeden sonraki durum. Varsayılan: İşleniyor. Ödenmiş siparişleri tamamlanmış olarak işaretlemek için tamamlanmış bir durum veya her ödenmiş siparişi elle kontrol etmek için kendi inceleme durumunuzu seçin.

Awaiting Midtrans payment status: Midtrans pending bildiriyor: bir sanal hesap, market veya QRIS kodu düzenlendi ya da kartın 3-D Secure doğrulaması tamamlanmadı. Varsayılan: Beklemede.

Midtrans payment on hold status: ödeme sizin incelemenizi gerektiriyor (bkz. Sipariş durumları). Varsayılan: Beklemede, çünkü OpenCart'ta On hold durumu yok. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturabilir ve burada seçebilirsiniz.

Payment failed status: Midtrans, bekleyen bir sipariş için deny veya failure bildiriyor. Varsayılan: Başarısız.

Payment expired / cancelled status: bekleyen bir siparişin bekleyen Midtrans işlemi süresi doldu veya iptal edildi. Ödenmemiş bir Midtrans siparişini kendiniz bu duruma aldığınızda, bekleyen Midtrans işlemi (örneğin düzenlenmiş bir sanal hesap) süresi dolmuş olarak işaretlenir ve artık ödenemez. Varsayılan: İptal edildi.

Refunded status: ödeme, sipariş sayfasından veya Midtrans panelinden tamamen iade edildi. Varsayılan: İade edildi.

Gelişmiş

Debug log: API çağrılarını ve bildirimleri OpenCart günlükler klasöründeki (storage/logs) midtrans_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar her zaman kaydedilir. Anahtarlar ve müşteri verileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

Log: günlüğün boyutunu ve son kayıtlarını gösterir. Temizlemek 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. Midtrans ödeme referansları ve siparişlerin iadeleri her zaman korunur; böylece eski siparişler yeniden kurulumdan sonra da iade edilebilir. Varsayılan: kapalı.

İçe / Dışa aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Server Key'ler 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. Kaydedilmiş Server Key'ler korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Midtrans). Confirm Order adımında müşteri açıklamanızı ve You will be redirected to the Midtrans payment page (GoPay, QRIS, ShopeePay, cards, bank transfer and more). notunu görür. OpenCart siparişi bu adımda oluşturur; hâlâ durumsuzdur. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş toplamı için tam rupi olarak bir Midtrans Snap işlemi oluşturur; sipariş kalemleri, kargo, indirimler, vergi ve müşterinin fatura ve teslimat bilgileriyle birlikte, ve müşteriyi Midtrans ödeme sayfasına yönlendirir. Orada müşteri, Midtrans hesabınızda etkin olan herhangi bir yöntemi seçer. 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.

Ödemeden sonra müşteri mağazanıza döner. Dönüş bağlantısı bir siparişi asla ödenmiş olarak işaretlemez: sipariş yalnızca Midtrans onayladıktan sonra, imzalı bildirimle veya müşteri döndüğünde Midtrans durum API'sine yapılan bir istekle ödenmiş olarak işaretlenir. Sipariş daha sonra olağan OpenCart yöntemiyle durumunu alır; olağan sipariş e-postaları ve stok güncellemesiyle birlikte, ve müşteri OpenCart sipariş başarı sayfasını görür. Gecikmeli bir ödeme için sayfa ayrıca We are waiting for Midtrans to confirm your payment. If you chose a bank transfer, virtual account or convenience store, please complete the payment using the instructions from Midtrans. You will receive an e-mail once the payment is confirmed. mesajını gösterir. Müşteri geri döndüğünde Midtrans'a ulaşılamazsa, bir Payment confirmation sayfası We are confirming your payment with Midtrans. The order will be updated automatically — please do not pay again. mesajını, bir Check again düğmesini ve bir Back to checkout düğmesini gösterir.

Müşteri ödeme yapmadan Snap sayfasından ayrıldıysa, The Midtrans payment was not completed. You can try again below. mesajıyla ödeme sayfasına döner. Ödeme reddedildiyse veya süresi dolduysa mesaj Your Midtrans payment was declined or has expired. Please try again or choose another payment method. olur. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir. Sepet korunur. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise ödeme için tek bir sipariş tutar ve onu yeniden öder. Her iki durumda da eklenti aynı sepetin tüm siparişlerini tek bir ödeme olarak ele alır: müşteri yeniden ödediğinde, aynı tutarda kullanılmamış veya bekleyen bir Snap yeniden kullanılır (düzenlenmiş bir sanal hesap geçerli kalır); tutar değiştiyse önce bekleyen işlem Midtrans'ta süresi dolmuş olarak işaretlenir; bu arada önceki bir Snap ödenmişse, o ödeme onaylanır ve müşteri yeni bir işlem olmadan başarı sayfasına gider.

OpenCart 4, ödeme başarı sayfası gösterilene kadar siparişi ödeme aşamasında tutar. Bu arada o sipariş ödeme yapılmadan kapatılmışsa (örneğin ödeme reddedildi, süresi doldu ya da siparişi iptal ettiniz), müşteri Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. mesajıyla ödeme aşamasına döner ve bir sonraki Confirm Order yeni bir siparişi öder. Bu sipariş zaten verilmişse ve o zamandan beri sepet değiştiyse mesaj şöyledir: Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it. Yeni miktar dahil sepetteki her değişiklik, kendi ödemesini gerektiren yeni bir sepet sayılır. Sepet boşaltıldıktan sonra siparişin ödemesi reddedilir veya süresi dolarsa (örneğin sanal hesap ödemesinden sonra), müşteri The Midtrans payment of order #(number) was declined or has expired, so the order will not be shipped. To buy these items, please place a new order. mesajını görür.

Midtrans ödemeyi başlatamazsa müşteri Confirm Order adımında kalır ve düğmenin üstünde kısa bir mesaj görür: Could not connect to Midtrans. Please try again in a moment., Midtrans payments are temporarily unavailable. Please choose another payment method or contact us. (örneğin yanlış bir Server Key ile) veya Midtrans'ın bildirdiği neden. Teknik neden günlüğe yazılır.

Mağaza bakım modundayken de bildirim çalışır, çünkü OpenCart 3 ödeme eklentilerinin isteklerine izin verir; OpenCart 4'te eklenti bunun için bir başlangıç eylemi ekler ve bu eylem müşterinin Midtrans'tan dönüşüne de izin verir.

Eklenti yalnızca Snap Redirect kullanır. Snap açılır penceresi, sitenizde kart formu, kayıtlı kartlar veya tek tıklamayla ödeme, taksit veya promosyon ayarları (ödeme yöntemleri Midtrans panelinde yapılandırılır) ve abonelikler yoktur. Kart ödemeleri hemen tahsil edilir; ayrı bir yetkilendirme ve tahsilat yoktur.

Siparişler ve iadeler

Sipariş durumları

No status (missing order): müşteri Midtrans'a yönlendirildi ve ödeme yapmadı ya da Midtrans ödemeyi henüz onaylamadı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Awaiting Midtrans payment status (varsayılan Beklemede): müşteri gecikmeli bir yöntem seçti veya tamamlanmamış bir kart ödemesi başlattı. Midtrans ödemeyi bildirdiğinde sipariş Status after payment durumuna geçer.

Status after payment (varsayılan İşleniyor): ödeme onaylandı. Bir not ödeme yöntemini, Midtrans sipariş kimliğini ve işlemi gösterir.

Midtrans payment on hold status (varsayılan Beklemede): bir kart ödemesi dolandırıcılık incelemesinde (challenge, henüz hiçbir tutar kaydedilmedi), ödenen tutar veya para birimi siparişle eşleşmedi (sipariş ödenmiş olarak işaretlenmez) ya da iptal edilmiş bir sipariş için bir ödeme geldi (sipariş otomatik olarak yeniden açılmaz). Not bunu açıklar. Siparişi kontrol edin, ardından yerine getirin veya ödemeyi iade edin.

Payment expired / cancelled status (varsayılan İptal edildi): bekleyen bir siparişin ödenmemiş işlemi süresi doldu veya iptal edildi.

Payment failed status (varsayılan Başarısız): ödeme başarısız oldu veya incelenen bir kart ödemesi reddedildi.

Refunded status (varsayılan İade edildi): ödeme tamamen iade edildi.

OpenCart, bu durum değişikliklerini olağan yöntemle müşteriye bildirir. Aynı sepet için ikinci bir ödeme gelirse sipariş değişmez. Ödenmiş siparişteki bir not, ikinci ödemeyi Midtrans panelinde iade etmenizi ister. İade edilmiş bir siparişe yapılan ödeme yalnızca bir not ekler.

Notlar, müşterinin görmediği sipariş History kayıtlarıdır.

VibeFox Midtrans Payment Gateway sekmesi

Sales > Orders bölümünde Midtrans ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında VibeFox Midtrans Payment Gateway sekmesi Midtrans order ID, ödemenin ortamının Midtrans panelindeki işleme bağlı Transaction ID (sandbox ödemeleri için Sandbox etiketiyle), Payment method, Status, Paid / refunded tutarlarını, iade formunu, iade geçmişini ve siparişin Midtrans notes bölümünü gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox Midtrans Payment Gateway sekmesinde Amount değerini girin (henüz iade edilmemiş tutar otomatik doldurulur), isterseniz Reason (optional) alanını doldurun ve Refund via Midtrans düğmesine tıklayın. Refund this amount through Midtrans? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler tam rupi olarak desteklenir; ondalıklı bir tutar reddedilir. Eklentiyi değiştirme iznine sahip olmanız gerekir (System > Users > User Groups bölümünde ayarlanır). Sipariş daha sonra düzenlenmiş olsa bile, Midtrans'ın gerçekte tahsil ettiği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı ortamda gönderilir; bu nedenle o ortamın Server Key'i ayarlanmış olmalıdır. Midtrans, API ile iadeye yalnızca belirli ödeme yöntemleri ve tahsil edilmiş işlemler için izin verir. Midtrans iadeyi kabul etmezse sekme hatayı gösterir ve iade kaydedilmez; bu durumda Midtrans panelinden iade yapın. Başarılı bir iade, iade geçmişine ve notlara eklenir. Tam iade, siparişi müşteriye bildirmeden 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, Midtrans ödemenin tahsil edildiğini bildirdikten sonra kullanılabilir.

Sales > Returns bölümündeki ürün iadeleri Midtrans üzerinden para geri göndermez.

Midtrans panelinde yapılan iadeler bildirimle gelir ve Refunded in the Midtrans dashboard nedeniyle otomatik olarak iade geçmişine eklenir. Tüm ödeme orada iade edildiğinde sipariş Refunded status durumunu alır.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Midtrans Payment Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Midtrans Payment Gateway > Edit 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ı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) gösterir ve şu düğmeleri içerir: 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. Bunların altında Product: opencart-payment-midtrans satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca eklenti için Modify izni 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 nedenini açıklar; ö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 veya hesabınızda bir alan adı yuvası serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar tek 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 serbest bırakın.

Etkin bir anahtar olmadan Midtrans müşterilere ödeme sayfasında 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önetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada (unlicensed — visible to admins only) işaretiyle yine görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme yoktur: mağaza yönetici girişini görmez, bu yüzden etkin anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma belirir. 7 gün gizlemek için × ile kapatın. Mevcut siparişler etkilenmez: 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. Durum, yönetici Dashboard veya Edit sayfası açıldığında otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Eklentinin kaldırılması her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Midtrans ö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 Server Key bulunduğunu kontrol edin. Ödeme para biriminin IDR olduğunu, ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total değerine ulaştığını kontrol edin. Anahtar eksikse veya mağaza para birimi IDR değilse ayarlar sayfası bir uyarı gösterir.

Ödeme gerçekleşti, ancak sipariş durumsuz kaldı: bildirim çalışmıyor. Kullandığınız ortamın (sandbox veya production) Midtrans panelinde ödeme bildirim URL'sinin ayarlandığını, Notification URL alanında gösterilen URL ile birebir aynı olduğunu ve erişilebilir olduğunu kontrol edin: bir tarayıcıda açın, kısa bir açıklama gösterir. Bildirimleri görmek için Debug log seçeneğini açın. Müşteri ödemeden sonra mağazaya döndüğünde de sipariş durumunu alır.

Bildirim Invalid signature yanıtı veriyor: bildirim Sandbox veya Production Server Key'iniz ile imzalanmamış. Ayarlardaki anahtarların, bildirimleri gönderen panelle aynı Midtrans hesabına ait olduğunu kontrol edin.

Bildirim Server key not configured yanıtı veriyor: hiçbir Server Key ayarlanmamış. Ayarlara girin; Midtrans bildirimi yeniden dener.

Bildirim Order not found — ignored yanıtı veriyor: Midtrans sipariş kimliği bu mağaza tarafından verilmemiş, örneğin aynı Midtrans hesabındaki başka bir mağaza tarafından. Her mağazaya farklı bir Order ID prefix verin.

Bildirim Environment mismatch — ignored yanıtı veriyor: bildirim, ödemenin yapıldığı ortamdan farklı ortamın anahtarıyla imzalanmış.

Bildirim Verification failed, please retry yanıtı veriyor: Midtrans durum API'sine ulaşılamadı. Midtrans bildirimi yeniden dener.

Bildirim Busy, please retry yanıtı veriyor: sepet aynı anda başka bir istek tarafından güncelleniyordu veya sipariş durumu ayarlanamadı. Midtrans bildirimi yeniden dener. Nedeni görmek için günlüğe bakın.

Sipariş inceleme durumunda: sekmedeki Midtrans notes bölümünü okuyun. Kart ödemesi dolandırıcılık incelemesinde, ödenen tutar veya para birimi siparişle eşleşmedi ya da ödeme sipariş iptal edildikten sonra geldi.

Müşteri Confirm Order sonrasında bir hata görüyor: eklenti sayfasındaki Log alanına bakın; hatalar her zaman kaydedilir. Yanlış bir Server Key, Midtrans ödemelerinin geçici olarak kullanılamadığı mesajını verir. Midtrans only supports payments in IDR (Indonesian Rupiah). Please choose another payment method. siparişin IDR olmadığı anlamına gelir. This payment method is not available. ise ödeme oturumunun artık siparişle eşleşmediği veya ödeme yönteminin bu arada kapatıldığı anlamına gelir: müşterinin ödeme sayfasını yeniden yüklemesi gerekir.

Müşteri ödeme sayfasına Payment verification failed. mesajıyla dönüyor: dönüş bağlantısı eksikti veya siparişe ait değildi. Sipariş yine de durumunu bildirimden alır.

Sekmede iade formu yok: sekme nedenini belirtir: ödeme henüz tahsil edilmemiş, tamamen iade edilmiş, kullanıcı grubunuzun eklentiyi değiştirme izni yok veya siparişin ödendiği ortam için Server Key ayarlanmamış.

İade başarısız oluyor: ödeme yöntemi veya işlem durumu API ile iadeye izin vermiyor; Midtrans panelinden iade yapın, iade otomatik olarak siparişe kaydedilir.

Geliştiriciler için: Snap işlemi oluşturulmadan önce eklenti, istek verileri ve siparişle birlikte midtrans_p_snap_payload OpenCart olayını tetikler; sipariş kimliği ve tutar değiştirilemez.

Kaldırma

Extensions > Extensions bölümüne gidin, Payments türünü seçin ve VibeFox Midtrans Payment Gateway yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, eklentinin kendi ayarlarını her zaman kaldırır: Enable/Disable, Sort Order, Geo Zone, Total ve Orders bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılanlarına döner. Eklentinin OpenCart olayları da kaldırılır (OpenCart 4'te ayrıca bakım modunda bildirimlere izin veren 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, Server Key'ler, ödeme ayarları, günlüğe kaydetme) ve günlük kaldırılır. Kapalıysa, sonraki bir yeniden kurulum için saklanır. Midtrans ödeme referansları ve siparişlerin iadeleri her zaman korunur; böylece önceden ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.

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

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