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

Mağaza para birimi: MercadoPago hesabınızın ülkesinin para birimi mağazada etkin olmalıdır: ARS (Arjantin), BRL (Brezilya), CLP (Şili), COP (Kolombiya), MXN (Meksika), PEN (Peru) veya UYU (Uruguay). MercadoPago, hesap para biriminde tahsilat yapar ve dönüştürme yapmaz; bu nedenle ödeme yöntemi yalnızca bu para biriminde ödeme yapan müşterilere gösterilir.

MercadoPago hesabı: MercadoPago geliştirici panelinde (Your integrations > your application > Credentials) bir uygulamanız ve bunun test kimlik bilgileri (TEST- ile başlar) ile canlı kimlik bilgileri (APP_USR- ile başlar) olmalıdır: her biri için bir Public Key ve bir Access Token. Bildirimlerin isteğe bağlı imza doğrulaması için ayrıca your application > Webhooks bölümündeki gizli imzaya da ihtiyacınız vardır.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek 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. Arşivde README.txt, OpenCart 3 paketi wcp_mercadopago_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_mercadopago_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_mercadopago_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 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 Payments türünü seçin. VibeFox MercadoPago 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. Account country seçeneğini belirleyin, test ve canlı kimlik bilgilerini girin ve isterseniz MercadoPago uygulamanızda bildirimleri ayarlayın (bkz. Yapılandırma). Hesabın para biriminin System > Localisation > Currencies bölümünde etkin olduğunu kontrol edin.

5. Enable / Disable seçeneğini açın ve Save düğmesine tıklayın. MercadoPago test kartlarıyla test modunda bir ödeme deneyin, ardından Test mode seçeneğini kapatın.

OpenCart 4

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

2. Paket, aynı sayfada kurulu uzantıların 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 MercadoPago Gateway 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ı, kimlik bilgilerini ve bildirimleri OpenCart 3 için 3 ila 5. adımlardaki gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca bildirim URL'si farklıdır (bkz. Ödeme bildirimleri (webhook'lar)).

Yeni bir kurulum, ödeme yöntemi kapalı ve test modu açık olarak başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox MercadoPago Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa, test modu açıkken Test mode is on: the TEST- credentials are used and no real money is charged. mesajını gösterir. Geçerli modun Public Key veya Access Token bilgisi eksikse (bu durumda ödeme yöntemi ödeme sayfasında gizlenir), mağazanın varsayılan para birimi MercadoPago hesabınızın para birimiyle eşleşmiyorsa (bu durumda ödeme yöntemi yalnızca hesap para biriminde ödeme yapan müşterilere gösterilir veya mağazada böyle bir etkin para birimi yoksa gizlenir) ve kimlik bilgileri Account country ile farklı bir ülkedeki hesaba aitse uyarır. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ama kaydedemez.

Title alanı boş (veya 128 karakterden uzun) ile kaydederseniz hiçbir şey kaydedilmez ve sayfa Enter a title for the payment method (1 to 128 characters). mesajını gösterir. Diğer hatalı değerler kaydedilmez, önceki değerini korur ve alan adını belirten ve — the previous value was kept. ile biten bir hata gösterilir. Bu; beklenen önekle (test alanları için TEST-, canlı alanlar için APP_USR-) başlamayan kimlik bilgileri, 1–24 aralığı dışındaki Maximum installments değeri, tam sayı olmayan bir Sort Order (Sort Order must be a whole number), 0 veya daha büyük bir sayı olmayan Total ve var olmayan bir coğrafi bölge ya da sipariş durumu için geçerlidir. Kaydettikten sonra eklenti, her erişim belirtecinin hangi ülkeye ait olduğunu MercadoPago'dan sorar. Geçerli modun belirteci doğrulanamazsa, hesap desteklenen bir ülkede değilse veya ülke Account country ile farklıysa bir uyarı gösterilir. Eklenti bu durumda hesabın ülkesini kullanır.

MercadoPago

Enable / Disable: Enable MercadoPago card payments ödeme yöntemini açar veya kapatır. Yöntem, ödeme sayfasında yalnızca etkin modun kimlik bilgileri doldurulmuşsa ve müşteri MercadoPago hesabının para biriminde ödeme yapıyorsa gösterilir. Varsayılan: kapalı.

Title: ödeme sayfasında müşteriye gösterilen ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Credit or debit card (MercadoPago). Zorunlu, en fazla 128 karakter.

Description: Confirm Order adımında kart alanlarının üstünde gösterilen metin. Varsayılan: Pay securely with your credit or debit card. Card data is sent directly to MercadoPago.

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

Geo Zone: MercadoPago'yu 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: MercadoPago'nun sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası toplamı. MercadoPago'yu her tutar için sunmak üzere boş bırakın.

MercadoPago hesabı

Uygulamanızın kimlik bilgilerini MercadoPago geliştirici panelinden alın: Your integrations > your application > Credentials (sayfa oraya bağlantı verir). Test kimlik bilgileri TEST- ile, canlı kimlik bilgileri APP_USR- ile başlar.

Account country: MercadoPago hesabınızın ülkesi. Tahsil edilecek para birimini, kart alanlarının dilini ve kart sahibinin belgesinin istenip istenmeyeceğini belirler. Müşteri aynı para biriminde ödeme yapmalıdır; örneğin Arjantin için ARS. Kimlik bilgileri kaydedildiğinde ülke hesapla karşılaştırılır. Varsayılan: Argentina (ARS).

Test mode: test modunda TEST- kimlik bilgileri kullanılır ve MercadoPago test kartlarıyla ödeme yaparsınız; ödeme sayfasında TEST MODE rozeti ve Use MercadoPago test cards. No real charges. metni gösterilir. Gerçek kartlardan canlı kimlik bilgileriyle tahsilat yapmak için kapatın. İadeler ve bildirimler her zaman ödemenin yapıldığı modun kimlik bilgilerini kullanır. Varsayılan: açık.

Test Public Key: TEST- ile başlar. Kartı tarayıcıda belirteçlemek için kullanılır.

Test Access Token: TEST- ile başlar. Yalnızca sunucuda kullanılır. Gizli tutun.

Production Public Key: APP_USR- ile başlar.

Production Access Token: APP_USR- ile başlar. Yalnızca sunucuda kullanılır. Gizli tutun.

Kaydedilmiş erişim belirteçleri ve webhook gizli anahtarı 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 değeri kaldırmak için alanın altındaki Clear the saved value on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Ödeme seçenekleri

Maximum installments: müşterinin seçebileceği en yüksek taksit sayısı (cuotas veya parcelas), 1 ile 24 arasında. 1 = yalnızca tek seferlik ödeme. Sınır sunucuda da uygulanır. Varsayılan: 1.

Ödeme bildirimleri (webhook'lar)

Kart ödemeleri genellikle hemen kesin bir yanıt alır. MercadoPago'nun incelemede tuttuğu ödemeler (işleniyor veya beklemede) MercadoPago bildirimleriyle tamamlanır. Mağazanızın genel bir adresi olduğunda (localhost veya .local ya da .test alan adı değil) eklenti her ödemeyle birlikte bildirim URL'sini gönderir. Ayrıca your application > Webhooks bölümünde Payments olayı için de ekleyebilirsiniz. URL, bu bölümde Notification URL alanında gösterilir. OpenCart 3'te şuna benzer: https://your-store/index.php?route=extension/payment/wcp_mercadopago_gateway/webhook&source_news=webhooks, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_mercadopago_gateway/payment/wcp_mercadopago_gateway.webhook&source_news=webhooks şeklindedir ve OpenCart kurulumunuzun vitrin adresinden oluşturulur. URL'yi ayarların gösterdiği gibi birebir kopyalayın.

Bir bildirime asla kendi başına güvenilmez. Eklenti, ödemeyi ödemenin yapıldığı ortamın erişim belirteciyle MercadoPago API'sinden yeniden okur ve mağazanızdaki bir ödeme denemesine bağlar. Bildirim yoksa, incelemedeki siparişler siz elle güncelleyene kadar Awaiting MercadoPago Status durumunda kalır.

Eklenti şu MercadoPago ödeme durumlarını işler:

Webhook secret signature: isteğe bağlı. your application > Webhooks bölümünde gösterilen gizli imza. Ayarlandığında geçerli bir x-signature içermeyen bildirimler reddedilir (HTTP 401).

Siparişler

OpenCart siparişi Confirm Order adımında durumsuz (eksik bir sipariş) olarak oluşturur. Sipariş, MercadoPago yanıt verdikten sonra bir durum alır. Reddedilen bir kart siparişi durumsuz bırakır (bir not nedenini açıklar) ve müşteri Confirm Order adımında kalır. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: MercadoPago ödemeyi onayladı ve tutarı ile para birimi siparişle eşleşiyor. Varsayılan: İşleniyor.

Awaiting MercadoPago Status: ödeme MercadoPago'da incelemede (işleniyor veya beklemede); bildirim siparişi tamamlar. Varsayılan: Beklemede.

On Hold (Review) Status: MercadoPago, siparişten farklı bir tutarı veya para birimini onayladı ya da beklenmeyen bir durum döndürdü. Bir not, MercadoPago panelinde neyin kontrol edileceğini açıklar. Varsayılan: Beklemede, çünkü OpenCart'ta On hold durumu yoktur. Bekleyen ve incelenen siparişleri ayırt etmek için System > Localisation > Order Statuses bölümünde kendi durumlarınızı oluşturabilirsiniz.

Payment Failed Status: incelemede olan bir ödeme MercadoPago tarafından reddedildi veya iptal edildi. Varsayılan: Başarısız.

Cancelled Status: bu durumdaki bir sipariş (veya iade edilmiş durumdaki bir sipariş) kapalıdır: MercadoPago'nun geç gelen bir onayı yalnızca bir not ekler. Varsayılan: İptal edildi.

Refunded Status: ödeme, sipariş sayfasından tamamen iade edilir. Kısmi iadeler yalnızca bir not ekler. Varsayılan: İade edildi.

Gelişmiş

Debug log: MercadoPago isteklerini ve bildirimlerini OpenCart günlükler klasöründeki (storage/logs) wc_mpg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar, bu ayar kapalıyken bile her zaman kaydedilir. Erişim belirteçleri, kart belirteçleri ve ödeyen verileri 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. MercadoPago ödeme kayıtları ve iadeler her zaman korunur; böylece önceden ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Varsayılan: kapalı.

İçe / Dışa aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Erişim belirteçleri ve webhook gizli anahtarı 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ş gizli bilgiler korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit or debit card (MercadoPago)). OpenCart siparişi Confirm Order adımında oluşturur; hâlâ durumsuzdur. Orada müşteri açıklamanızı görür ve kart alanlarını doldurur: Card number, Expiry (MM/YY), Security code ve Cardholder name. Ülkeye ve karta bağlı olarak müşteri ayrıca Document type seçer ve Document number girer, Card issuer seçer ve Installments sayısını belirler. Taksit seçenekleri ve faiz oranları, sipariş toplamı için MercadoPago tarafından sağlanır.

OpenCart 4'te müşteri, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde ödeme yöntemini seçer. Kart alanları bu durumda ödeme sayfasının altındaki sipariş onay bloğunda, Confirm Order düğmesinin üstünde görünür.

Müşteri Confirm Order düğmesine tıkladığında MercadoPago kartı tek kullanımlık bir belirtece dönüştürür ve mağazanız, sipariş toplamını sipariş para biriminde sunucuda ödeme olarak oluşturur. Müşterinin e-posta adresi ve adı ile belge MercadoPago'ya iletilir; ödeme Order #, sipariş numarası ve mağaza adınızla görünür. CLP ve COP tutarları ondalık olmadan tahsil edilir.

Onaylanan bir ödeme, sipariş durumunu OpenCart'ın standart yöntemiyle ayarlar; olağan sipariş e-postaları ve stok güncellemesiyle birlikte sepet boşaltılır ve müşteri OpenCart sipariş başarı sayfasını görür. İncelemedeki bir ödeme Awaiting MercadoPago Status durumunu ayarlar ve sayfa ayrıca MercadoPago is reviewing your payment. Your order will be updated automatically as soon as MercadoPago confirms it. mesajını gösterir. İnceleme durumundaki bir sipariş Your payment is being reviewed. We will update your order as soon as the review is complete. mesajını gösterir.

Reddedilen bir kart siparişi durumsuz bırakır. Müşteri, kısa bir nedenle Confirm Order adımında kalır; örneğin Your card has insufficient funds. Please use another card or payment method. veya Please check the security code of your card. Müşteri verileri düzeltebilir ya da başka bir kart kullanabilir; her denemede yeni bir kart belirteci oluşturulur. Kart verileri eksikse Please fill in all card fields. gösterilir.

MercadoPago yanıt vermezse müşteri We could not confirm your payment with MercadoPago. Please wait a minute before trying again — if the payment went through, your order will be updated automatically. mesajını görür. Sonraki deneme önce ödemeyi sorgular, böylece kart iki kez çekilmez. Sepet ödenirken ikinci bir tıklama This order is already being paid. Please wait a moment and check your e-mail before trying again. mesajını gösterir. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise siparişi tutar ve reddedilen karttan sonra müşteri aynı siparişi öder. Her iki durumda da ödenmiş veya bekleyen siparişi olan bir sepetten tekrar tahsilat yapılmaz; müşteri başarı sayfasına yönlendirilir.

OpenCart 4'te sipariş, başarı sayfası gösterilene kadar ödeme sayfasında tutulur. Bu arada sipariş ödenmeden kapatıldıysa (örneğin siz iptal ettiniz), sipariş tahsil edilmez ve müşteri Your previous order was cancelled without a payment. Please reload the checkout page and confirm the order again — the payment will be made with a new order. mesajını görür. Sipariş zaten verilmişse ve sepet o zamandan beri değiştiyse mesaj Your previous order has already been placed. Your cart has changed since — please reload the checkout page and confirm the order again to pay for the current cart with a new order. şeklindedir. Sepetteki bir değişiklik, yeni adet dahil, kendi ödemesi gereken yeni bir sepet sayılır.

Mağaza bakım modundayken de bildirim URL'si çalışır, OpenCart 3 ödeme eklentilerinin isteklerine izin verir, OpenCart 4'te ise eklenti bunun için bir başlangıç eylemi ekler.

Eklenti yalnızca kredi ve banka kartlarını kabul eder. Checkout Pro yönlendirmesi, MercadoPago cüzdanı veya hesap bakiyesi, nakit ödemeler (Rapipago, OXXO, boleto ve diğerleri), Pix, PSE veya Yape, kayıtlı kartlar veya abonelikler, ayrı yetkilendirme ve tahsilat, 3-D Secure doğrulaması ve para birimi dönüşümü yoktur.

Siparişler ve iadeler

Sipariş durumları

No status (missing order): kart reddedildi veya MercadoPago henüz yanıt vermedi. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Order Status After Payment (varsayılan İşleniyor): MercadoPago ödemeyi onayladı ve tutar ile para birimi siparişle eşleşiyor. Bir not ödeme kimliğini, ortamı ve taksit sayısını gösterir.

Awaiting MercadoPago Status (varsayılan Beklemede): ödeme incelemede (işleniyor veya beklemede) ve MercadoPago bildirimini bekliyor. MercadoPago onayladığında sipariş Order Status After Payment durumuna geçer.

On Hold (Review) Status (varsayılan Beklemede): onaylanan tutar veya para birimi siparişten farklı ya da MercadoPago beklenmeyen bir durum döndürdü. Not bunu açıklar. Siparişi kontrol edin ve yerine getirin ya da ödemeyi iade edin.

Payment Failed Status (varsayılan Başarısız): incelemedeki bir ödeme reddedildi veya iptal edildi. Not durumu ve ayrıntısını gösterir.

Refunded Status (varsayılan İade edildi): ödeme eklenti aracılığıyla tamamen iade edildi.

MercadoPago, zaten iptal edilmiş veya iade edilmiş bir sipariş için bir ödeme onaylarsa durum değişmez ve bir not siparişi tamamlamanızı veya ödemeyi iade etmenizi ister. Zaten ödenmiş bir sipariş veya sepet için başka bir ödeme gelirse, bir not MercadoPago panelinde fazla ödemeyi iade etmenizi ister.

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

VibeFox MercadoPago Gateway sekmesi

Sales > Orders bölümünde MercadoPago ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında VibeFox MercadoPago Gateway sekmesi Payment ID, ödemenin Status değerini, Environment (test ödemeleri için Test etiketi), Installments, Charged / order tutarlarını, Refunded tutarını, iade formunu, iade geçmişini ve siparişin MercadoPago notes bölümünü gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox MercadoPago Gateway sekmesinde Amount değerini girin (henüz iade edilmemiş tutar otomatik doldurulur), isterseniz Reason (optional) alanını doldurun ve Refund via MercadoPago düğmesine tıklayın. Refund this amount through MercadoPago? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Eklentiyi değiştirme iznine sahip olmanız gerekir (System > Users > User Groups bölümünde ayarlanır). İadeler, MercadoPago'nun tahsil ettiği tutarla sınırlıdır; bu nedenle tutar uyuşmazlığından sonra sipariş toplamına değil, müşterinin gerçekte ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı ortamın (test veya canlı) kimlik bilgileriyle gönderilir; bu nedenle o ortamın erişim belirteci ayarlanmış olmalıdır. MercadoPago iadeyi reddederse sekme nedenle birlikte MercadoPago refused the refund mesajını gösterir ve iade kaydedilmez. Onaylanmış veya işlenen bir iade, iade kimliğiyle birlikte 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.

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

MercadoPago panelinde yapılan iadeler, chargeback'ler ve arabuluculuk işlemleri bildirimle gelir ve notlara eklenir. Sipariş durumu otomatik olarak değişmez. Gerekirse elle güncelleyin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox MercadoPago Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox MercadoPago 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-mercadopago 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 MercadoPago 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 nedenle 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

MercadoPago ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu ve geçerli modda doğru önekli iki kimlik bilgisinin de bulunduğunu kontrol edin: test modunda TEST- anahtarları, canlı modda APP_USR- anahtarları. Müşterinin MercadoPago hesabınızın para biriminde ödeme yaptığını (para birimi mağazada etkin olmalıdır), ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total değerine ulaştığını kontrol edin. Ayarlar sayfası hangisinin eksik olduğunu gösterir.

Ödeme gerçekleşti, ancak sipariş Awaiting MercadoPago Status durumunda kaldı: bildirim gelmedi. Eklenti bildirim URL'sini yalnızca mağazanızın genel bir adresi olduğunda gönderir (localhost veya .local ya da .test alan adı değil). Notification URL alanındaki URL'yi Payments olayıyla birlikte your application > Webhooks bölümüne ekleyin. Webhook secret signature ayarlıysa, bunun aynı uygulamanın gizli anahtarı olduğunu kontrol edin. MercadoPago paneli her bildirim için mağazanızın yanıtını gösterir.

Bildirim invalid signature yanıtı veriyor: gizli imza başka bir uygulamaya ait veya bildirimde geçerli bir x-signature yok. Gizli anahtarı yeniden kopyalayın veya alanı boş bırakın.

Bildirim no credentials for test veya no credentials for live yanıtı veriyor: ödemenin yapıldığı ortamın erişim belirteci ayarlanmamış. Girin; MercadoPago bildirimi yeniden dener.

Bildirim not for this store yanıtı veriyor: ödeme bu mağazanın bir ödeme denemesine ait değil. Hiçbir sipariş değiştirilmez.

Bildirim order busy veya payment could not be read yanıtı veriyor: sipariş aynı anda başka bir istek tarafından güncelleniyordu veya MercadoPago'ya ulaşılamadı. MercadoPago bildirimi otomatik olarak yeniden dener.

Bir kimlik bilgisi kaydedilmiyor: must start with hatası, değerin alan için yanlış öneke sahip olduğunu gösterir. Test alanları TEST- kimlik bilgilerini, canlı alanlar APP_USR- kimlik bilgilerini kabul eder.

Müşteri «This payment method is not configured correctly. Please choose another payment method or contact the store.» mesajını görüyor: geçerli modun kimlik bilgileri eksik, yanlış öneke sahip veya MercadoPago tarafından reddedilmiş. Ayarlar sayfasında kontrol edin.

Müşteri «MercadoPago cannot process payments in» mesajını görüyor: sipariş para birimi MercadoPago hesabınızın para birimi değil. MercadoPago para birimlerini dönüştürmez.

Güvenli kart formu yüklenmiyor: müşteri The secure card form could not be loaded. Please reload the page or choose another payment method. mesajını görür. Geçerli modun Public Key değerini kontrol edin.

Müşteri «Your session has expired. Please reload the page and try again.» mesajını görüyor: kart formu artık müşterinin ödeme oturumuna ait değil. Müşteri ödeme sayfasını yeniden yükler.

Müşteri «Your payment was received, but the order could not be completed automatically» mesajını görüyor: MercadoPago ödemeyi aldı, ancak OpenCart sipariş durumunu ayarlayamadı. Eklenti sayfasındaki Log alanına bakın: hatalar her zaman kaydedilir. Müşteriden tekrar ödeme yapmaması istenir; sepet için bir sonraki ödeme denemesi veya bildirimi, yeni bir tahsilat olmadan durumu ayarlar.

Sipariş ödemeden sonra inceleme durumunda: sipariş sekmesindeki MercadoPago notes bölümünü okuyun (bkz. Sipariş durumları), ardından siparişi yerine getirin veya ödemeyi iade edin.

İade, mod ile ilgili bir mesajla başarısız oluyor: ödeme test veya canlı modda yapıldı ve o modun erişim belirteci ayarlanmamış. Girin ve yeniden deneyin.

İade, MercadoPago did not answer the refund request mesajıyla başarısız oluyor: yeniden denemeden önce ödemeyi MercadoPago panelinde kontrol edin.

Kaldırma

Extensions > Extensions bölümüne gidin, Payments türünü seçin ve VibeFox MercadoPago 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 olayı da kaldırılır (OpenCart 4'te ayrıca bakım modunda bildirimleri geçiren başlangıç eylemi de). Delete data on uninstall açıksa, diğer ağ geçidi ayarları (başlık, açıklama, hesap ülkesi, test modu, kimlik bilgileri, taksitler, webhook gizli anahtarı, günlüğe kaydetme), kaydedilmiş hesap doğrulaması ve günlük kaldırılır. Kapalıysa, sonraki bir yeniden kurulum için saklanır. MercadoPago ödeme kayıtları ve iadeler 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 eklentinin dosyalarını da silmek için, kaldırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu uzantılar listesinde VibeFox MercadoPago Gateway yanındaki Uninstall düğmesine (turuncu − düğmesi) ve ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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