VibeFox MercadoPago for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 – 9.x.

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

Mağaza para birimi: MercadoPago hesabınızın ülkesinin para birimi: ARS (Arjantin), BRL (Brezilya), CLP (Şili), COP (Kolombiya), MXN (Meksika), PEN (Peru) veya UYU (Uruguay). MercadoPago hesap para biriminde tahsilat yapar ve dönüşüm yapmaz; bu nedenle başka bir para birimindeki sepet için ödeme yöntemi gizlenir.

MercadoPago hesabı: MercadoPago geliştirici panelinde (Your integrations > your application > Credentials) bir uygulamanız olmalı; test kimlik bilgileri (TEST- ile başlar) ve canlı kimlik bilgileri (APP_USR- ile başlar) ile birlikte. Her biri için bir Public Key ve bir Access Token gerekir. Bildirimlerin isteğe bağlı imza kontrolü için your application > Webhooks bölümündeki gizli imza anahtarına da ihtiyacınız vardır.

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

Kurulum

1. Yönetim panelinde Modules > Module Manager sayfasına gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme tamamlandığında Configure düğmesine tıklayın ya da daha sonra modül listesinde VibeFox MercadoPago Gateway 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 girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Account country seçin, test ve canlı kimlik bilgilerini girin ve isterseniz MercadoPago uygulamanızda bildirimleri ayarlayın (bkz. Yapılandırma).

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.

Kurulumda modül iki sipariş durumu oluşturur: Awaiting MercadoPago payment ve MercadoPago payment on hold. PrestaShop, yeni ödeme modülünü kurulum sırasında aktif olan ülkelere atar. Modülün para birimlerini, ülkelerini ve müşteri gruplarını Payment > Preferences bölümünden kontrol edin.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox MercadoPago Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme sayfanın tamamını kaydeder. Alanların üstünde, test modu açık olduğunda sayfa Test mode is on: the TEST- credentials are used and no real money is charged. mesajını gösterir. Ayrıca mevcut modun Public Key veya Access Token bilgisi eksikse, mağaza para birimi MercadoPago hesabınızın para birimiyle aynı değilse (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve kimlik bilgileri Account country dışındaki bir ülkeye ait bir hesaba aitse uyarı verir.

Kaydetme sırasında beklenen önekle (test alanları için TEST-, canlı alanlar için APP_USR-) başlamayan bir kimlik bilgisi kaydedilmez ve must start with … — the previous value was kept. hatası gösterilir. Modül ayrıca her Access Token'ın hangi ülkeye ait olduğunu MercadoPago'ya sorar. Mevcut modun token'ı doğrulanamazsa, hesap desteklenen bir ülkede değilse veya ülke Account country ile eşleşmezse bir hata gösterilir. Bu durumda modül hesabın ülkesini kullanır.

MercadoPago

Enable / Disable: Enable MercadoPago card payments ödeme yöntemini açar veya kapatır. Varsayılan: off.

Title: ödeme sayfasında müşteriye gösterilen ödeme yöntemi adı. Siparişte de bu ad kaydedilir. Varsayılan: Credit or debit card (MercadoPago). Zorunlu.

Description: ödeme sayfası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.

MercadoPago hesabı

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

Account country: MercadoPago hesabınızın ülkesi. Tahsilat para birimini, kart alanlarının dilini ve kart sahibi belgesinin istenip istenmeyeceğini belirler. Mağaza para birimi aynı olmalıdır; örneğin Arjantin için ARS. Kimlik bilgileri kaydedilirken ü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 gösterilir. Gerçek kartları canlı kimlik bilgileriyle tahsil etmek için kapatın. Varsayılan: on.

Test Public Key: TEST- ile başlar. Kartı tokenize etmek için tarayıcıda 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ş Access Token'lar 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.

Ödeme seçenekleri

Maximum installments: müşterinin seçebileceği en yüksek taksit sayısı, 1 ile 24 arasında. 1 = yalnızca tek seferlik ödeme; taksit alanı gösterilmez. 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şlemde veya beklemede) MercadoPago bildirimleriyle tamamlanır. Mağazanızın genel bir adresi varsa (localhost veya .local ya da .test alan adı değilse) modül her ödemeyle birlikte bildirim URL'sini gönderir. URL'yi ayrıca your application > Webhooks bölümünde, Payments olayı için de ekleyebilirsiniz. URL, bu bölümde Notification URL altında gösterilir. Dostça URL'lerle şöyle görünür: https://your-shop/en/module/wcp_mercadopago_gateway/webhook?source_news=webhooks. URL'yi ayarların gösterdiği biçimiyle birebir kopyalayın.

Bir bildirim kendi başına asla güvenilir kabul edilmez. Modül ödemeyi, ödemenin yapıldığı ortamın Access Token'ı ile MercadoPago API'sinden yeniden okur ve mağazanızın bir ödeme denemesine bağlar. Bildirim olmadan, incelemedeki siparişler siz elle güncelleyene kadar Awaiting MercadoPago payment durumunda kalır.

Modül ş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 anahtarı. Ayarlandığında, geçerli bir x-signature içermeyen bildirimler reddedilir (HTTP 401).

Clear saved secrets: kaldırmak için Test Access Token, Production Access Token veya Webhook secret signature seçeneğini işaretleyin ve Save düğmesine tıklayın. Boş alan, kayıtlı değeri korur.

Gelişmiş

Debug log: MercadoPago isteklerini ve bildirimlerini modül klasöründeki logs/wc_mpg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar bu ayar kapalıyken de her zaman kaydedilir. Access Token'lar, kart jetonları ve ödeyen bilgileri kaydedilmez. Varsayılan: off.

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ükler silinir. MercadoPago ödeme kayıtları, iadeler ve modülün sipariş durumları her zaman korunur; bu sayede daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Varsayılan: off.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit or debit card (MercadoPago)) 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 faizler sepet toplamı için MercadoPago tarafından sağlanır. Kart formu Classic ve Hummingbird temalarıyla çalışır.

Müşteri onayladığında MercadoPago kartı tek kullanımlık bir jetona dönüştürür ve mağazanız sepet toplamı için sunucuda ödemeyi oluşturur. Müşterinin e-posta adresi ve adı, belge ve sepet numarası MercadoPago'ya iletilir; ödeme Cart #, sepet numarası ve mağaza adınızla görünür. CLP ve COP tutarları ondalık olmadan tahsil edilir. MercadoPago yanıt verene kadar sipariş mevcut değildir.

Onaylanan bir ödeme ödenmiş bir sipariş oluşturur ve müşteri Your card payment has been received. mesajının yer aldığı sipariş onay sayfasını görür. İncelemedeki bir ödeme Awaiting MercadoPago payment durumunda bir sipariş oluşturur ve sayfa MercadoPago is reviewing your payment. Your order will be updated automatically as soon as MercadoPago confirms it. mesajını gösterir. İncelemedeki bir ödeme daha sonra reddedilirse sayfa Your MercadoPago payment was not completed. Please contact us about this order. mesajını gösterir. Beklemedeki 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ş oluşturmaz. Müşteri, kısa bir nedenle ödeme 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 bilgilerini düzeltebilir ya da başka bir kart kullanabilir; her denemede yeni bir kart jetonu oluşturulur.

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. Bir sonraki deneme önce ödemeyi sorgular, böylece kart iki kez tahsil edilmez. 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. Siparişi olan bir sepet bir daha tahsil edilmez; müşteri o siparişin onay sayfasına yönlendirilir.

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

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

Siparişler ve iadeler

Sipariş durumları

No order: kart reddedildi veya MercadoPago henüz yanıt vermedi. Yalnızca sepet vardır.

Payment accepted: MercadoPago ödemeyi onayladı ve tutar ile para birimi sepetle eşleşiyor. Ödeme, MercadoPago ödeme kimliğiyle işlem kimliği olarak kaydedilir; bir not ödeme kimliğini, ortamı ve taksit sayısını gösterir.

Awaiting MercadoPago payment: ödeme incelemede (işlemde veya beklemede) ve MercadoPago bildirimini bekliyor. MercadoPago onayladığında sipariş Payment accepted durumuna geçer.

MercadoPago payment on hold: onaylanan tutar veya para birimi sepetten farklı ya da MercadoPago beklenmeyen bir durum döndürdü. Not nedenini açıklar. Siparişi kontrol edin ve tamamlayın ya da ödemeyi iade edin.

Payment error: incelemedeki bir ödeme reddedildi veya iptal edildi. Not durumu ve ayrıntısını gösterir.

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

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

MercadoPago ödeme bloğu

Sipariş sayfasında ödeme kimliği, ödeme durumu, ortam (test ödemeleri için Test rozeti), taksitler, MercadoPago'nun tahsil ettiği tutar ve sipariş toplamı, iade edilen tutar, iade geçmişi ve siparişin MercadoPago notes bölümünü içeren bir MercadoPago payment bloğu gösterilir.

İadeler

MercadoPago payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın 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. Siparişleri düzenleme yetkisine sahip olmanız gerekir. İ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 Access Token'ı ayarlanmış olmalıdır. MercadoPago iadeyi reddederse blok, nedeniyle birlikte MercadoPago refused the refund mesajını gösterir ve hiçbir iade kaydedilmez. Onaylanan veya işlemde olan bir iade, iade kimliğiyle birlikte iade geçmişine ve notlara eklenir. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki PrestaShop'un standart iade düğmeleri MercadoPago üzerinden para iadesi yapmaz.

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

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox MercadoPago Gateway lisans bloğu, Modules > Module Manager > VibeFox MercadoPago Gateway > Configure sayfasının ilk bloğudur ve ayarların üstünde yer alır. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu son tarih ve alan adınızı) ve şu düğmeleri gösterir: 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: presta-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 modül için Configure yetkisi olan çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli 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 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 MercadoPago ö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 sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ama ödeme sayfasında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır ve iadeler çalışır.

Bir lisans süresi dolduğunda 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, ardından haftada bir. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak 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 mevcut modun iki kimlik bilgisine de doğru önekle sahip olduğunu kontrol edin: test modunda TEST- anahtarları, canlıda APP_USR- anahtarları. Sepet para biriminin MercadoPago hesabınızın para birimi olduğunu kontrol edin. Ayarlar sayfası hangisinin eksik olduğunu gösterir. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşteri grubu için izinli olduğunu kontrol edin.

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

Bildirim invalid signature yanıtı veriyor: gizli imza anahtarı başka bir uygulamaya ait ya da bildirimin geçerli bir x-signature'ı yok. 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 Access Token'ı 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şmez.

Bildirim order busy veya payment could not be read yanıtı veriyor: sipariş aynı anda başka bir istek tarafından güncelleniyordu ya da 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: mevcut modun kimlik bilgileri eksik, yanlış önekle girilmiş ya da MercadoPago tarafından reddedilmiş. Ayarlar sayfasında kontrol edin.

Müşteri MercadoPago cannot process payments in mesajını görüyor: sepet para birimi MercadoPago hesabınızın para birimi değil. MercadoPago para birimi 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. Mevcut modun Public Key'ini kontrol edin.

Müşteri Your payment was received, but the order could not be completed automatically mesajını görüyor: MercadoPago ödemeyi aldı, ancak PrestaShop siparişi oluşturamadı (örneğin modül o anda devre dışıydı). Modül 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 yapmadan siparişi oluşturur.

Ödemeden sonra sipariş MercadoPago payment on hold durumunda: sipariş bloğundaki MercadoPago notes bölümünü okuyun (bkz. Sipariş durumları), ardından siparişi tamamlayın 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 Access Token'ı 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

Modules > Module Manager sayfasına gidin, VibeFox MercadoPago Gateway yanındaki menüyü açın ve Uninstall seçeneğini seçin. Bu modülün lisans anahtarı ve lisans durumu her zaman silinir. Delete data on uninstall açıksa ağ geçidi ayarları, kayıtlı hesap kontrolü ve günlükler silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. MercadoPago ödeme kayıtları ve iadeleri ile Awaiting MercadoPago payment ve MercadoPago payment on hold sipariş durumları her zaman korunur; bu sayede daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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