VibeFox MercadoPago for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin. WooCommerce yoksa eklenti etkinleştirilmez.

PHP: 8.0 veya üzeri.

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 para birimleri eşleşmediğinde ödeme yöntemi gizlenir.

MercadoPago hesabı: MercadoPago geliştirici panelinde bir uygulamanız (Your integrations > your application > Credentials) 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. WordPress'te Plugins > Add New > Upload Plugin bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. wcp_mercadopago_gateway klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Payments > MercadoPago > Manage veya Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Account country seçeneğini belirleyin, test ve canlı kimlik bilgilerini girin ve isterseniz MercadoPago uygulamanızda bildirimleri ayarlayın (bkz. Yapılandırma).

6. Enable / Disable seçeneğini açın ve kaydedin. MercadoPago test kartlarıyla deneyin (kart sahibi adı APRO = onaylandı, CONT = beklemede, OTHE = reddedildi), ardından Test mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > MercadoPago. Alanların üstünde sayfa, test modu açıkken Test mode is on: the TEST- credentials are used and no real money is charged. uyarısını gösterir. Geçerli modun kimlik bilgileri eksikse, mağaza para birimi MercadoPago hesabınızın para birimi değilse (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve kimlik bilgileri Account country dışında bir ülkedeki hesaba aitse uyarı verir. Ödeme yöntemleri listesinde, geçerli modun kimlik bilgileri girilene kadar MercadoPago kurulum gerektiriyor olarak işaretlenir.

Kaydetme sırasında beklenen önekle (test alanları için TEST-, canlı alanlar için APP_USR-) başlamayan bir kimlik bilgisi kaydedilmez: bir hata gösterilir ve önceki değer korunur. Eklenti ayrıca MercadoPago'ya Access Token'ın hangi ülkeye ait olduğunu sorar. Jetonu doğrulayamazsa, hesap desteklenen bir ülkede değilse veya ülke Account country ile farklıysa bir hata gösterilir. Bu durumda eklenti hesabın ülkesini kullanır.

Genel

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

Title: müşterinin ödeme sayfasında gördüğü ödeme yöntemi adı. Varsayılan: Credit or debit card (MercadoPago).

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. Tahsil edilen para birimini, kart alanlarının dilini ve kart sahibinin belgesinin istenip istenmeyeceğini belirler. Mağaza para birimi aynı olmalıdır; örneğin Arjantin için ARS. Varsayılan: Argentina (ARS).

Argentina (ARS), Brazil (BRL), Chile (CLP), Colombia (COP), Mexico (MXN), Peru (PEN), Uruguay (UYU): desteklenen ülkeler. Belge alanı Meksika hariç hepsinde gösterilir.

Test mode: Use the test credentials (no real charges). Test modunda TEST- kimlik bilgileri kullanılır ve MercadoPago test kartlarıyla ödeme yaparsınız; ödeme sayfasında bir TEST MODE rozeti görünür. Gerçek kartlardan canlı kimlik bilgileriyle tahsilat yapmak için işaretini kaldırın. Varsayılan: açık. Bir MercadoPago test kullanıcı hesabıyla (APP_USR- kimlik bilgileri) test etmek için o hesabın kimlik bilgilerini canlı alanlara girin ve test modunu kapatın.

Test Public Key: TEST- ile başlar. Kartı jetonlaştırmak 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.

Ödeme seçenekleri

Maximum installments: müşterinin seçebileceği en yüksek taksit sayısı (1 ile 24 arası). 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şleniyor veya beklemede) MercadoPago bildirimleriyle tamamlanır. Siteniz genel bir adrese sahipse eklenti her ödemeyle birlikte bildirim URL'sini gönderir. Ayrıca your application > Webhooks bölümünde Payments olayıyla da ekleyebilirsiniz. URL, ayarların bu bölümünde gösterilir ve şuna benzer: https://your-site/wc-api/wc_mpg_webhook/?source_news=webhooks.

Bir bildirim kendiliğinden asla güvenilir sayılmaz. Eklenti, ödemeyi ödemenin yapıldığı ortamın Access Token'ıyla MercadoPago API'sinden yeniden okur ve sipariş kimliği ile sipariş anahtarı üzerinden siparişe bağlar. Bildirim olmadan, incelemedeki siparişler siz elle güncelleyene kadar Beklemede kalır.

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

approved: ödeme onaylandı. Tutar ve para birimi eşleşirse sipariş ödenmiş olarak işaretlenir.

in_process, pending, authorized: ödeme incelemede. Sipariş Beklemede durumuna geçer ve sonraki bir bildirimle tamamlanır.

rejected, cancelled: ödeme reddedildi veya iptal edildi. Ödenmemiş sipariş Başarısız olarak işaretlenir.

refunded, charged_back, in_mediation: bir not eklenir; sipariş durumu değişmez.

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).

Gelişmiş

Debug log: Log API requests and notifications, WooCommerce > Status > Logs sayfasına, kaynak wcp_mercadopago_gateway olarak yazar. Access Token'lar, kart jetonları ve ödeyen verileri günlüğe yazılmaz. Varsayılan: kapalı.

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted. Siparişlerde kayıtlı MercadoPago ödeme kimlikleri ödeme geçmişidir ve her zaman korunur. Varsayılan: kapalı.

Ödeme sayfası

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, sipariş toplamı için MercadoPago'dan gelir.

Sipariş verildiğinde MercadoPago kartı tek kullanımlık bir jetona dönüştürür ve mağazanız sipariş toplamı için ödemeyi sunucuda oluşturur. Fatura e-posta adresi ve adı, belge ve sipariş numarası MercadoPago'ya iletilir. CLP ve COP tutarları ondalık basamak olmadan tahsil edilir ve tam sayıya yuvarlanır; bu nedenle bu para birimleri için WooCommerce ondalık basamak sayısını 0 olarak ayarlayın.

Onaylanan bir ödeme hemen ödenmiş olarak işaretlenir ve müşteri sipariş alındı sayfasına gider. İncelemedeki bir ödeme siparişi Beklemede durumuna geçirir; müşteri yine sipariş alındı sayfasına gider ve sipariş bildirimle tamamlanır. Reddedilen bir kart, ödeme sayfasında kısa bir neden gösterir, ö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 deneme için 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. Sipariş ödenirken ikinci kez tıklanırsa This order is already being paid. Please wait a moment and check your e-mail before trying again. gösterilir.

Ödeme yöntemi klasik ödeme sayfasında, Checkout bloğunda ve Pay for order sayfasında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklenti yalnızca kredi ve banka kartlarını kabul eder. Checkout Pro yönlendirmesi, MercadoPago cüzdanı veya hesap bakiyesi, nakit (Rapipago, OXXO, boleto ve diğerleri), Pix, PSE veya Yape, 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ı

Pending payment: sipariş oluşturuldu ve henüz bir ödeme sonucu gelmedi; örneğin bir zaman aşımından sonra.

Processing: MercadoPago ödemeyi onayladı ve tutar ile para birimi eşleşiyor. Yalnızca sanal indirilebilir ürün içeren siparişler, WooCommerce varsayılanı olarak Tamamlandı durumuna geçer. Sipariş notu MercadoPago ödeme kimliğini ve taksit sayısını gösterir. İşlem kimliği MercadoPago ödeme kimliğidir.

On hold: ödeme incelemede (işleniyor veya beklemede) ve MercadoPago bildirimini bekliyor. Onaylanan tutar veya para birimi siparişle eşleşmediğinde ya da MercadoPago beklenmeyen bir durum döndürdüğünde de Beklemede durumu ayarlanır. Sipariş notu nedenini açıklar.

Failed: ödeme reddedildi veya iptal edildi. Sipariş notu durumu ve ayrıntısını gösterir. Müşteri yeniden ödeme yapabilir.

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

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Credit or debit card (MercadoPago) düğmesine tıklayın (düğme Title değerinizi gösterir). Tam ve kısmi iadeler desteklenir. İ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 WooCommerce nedeniyle birlikte MercadoPago refused the refund mesajını gösterir ve iade kaydedilmez. Onaylanan veya işlenmekte olan bir iade, iade kimliğiyle birlikte sipariş notlarına eklenir.

MercadoPago panelinde yapılan iadeler ve itirazlar bildirimle gelir ve sipariş notlarına eklenir. Bunlar otomatik olarak WooCommerce iadesi olarak kaydedilmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > MercadoPago sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu gösterir; örneğin lisansın hangi tarihe kadar aktif olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar tek bir alan adında çalışır. Anahtarın bir siteden kaldırılması alan adı hakkını serbest bırakmaz. Hakkı 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. Oturum açmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında 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ın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

MercadoPago does not appear at checkout: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu ve geçerli modun doğru önekli iki kimlik bilgisine sahip olduğunu kontrol edin: test modunda TEST- anahtarları, canlı modda APP_USR- anahtarları. Mağaza para biriminin (veya Pay for order sayfasındaki sipariş para biriminin) MercadoPago hesabınızın para birimi olduğunu kontrol edin. Ayarlar sayfası eksik olanı belirtir.

The payment went through, but the order stays On hold or Pending payment: ödeme geçti, ancak sipariş Beklemede veya Pending payment durumunda kalıyor: bildirim ulaşmadı. Eklenti bildirim URL'sini yalnızca siteniz genel bir adrese sahipse gönderir (localhost veya .local ya da .test alan adı değil). Ayarlardaki URL'yi your application > Webhooks bölümüne Payments olayıyla 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.

Notification answers invalid signature: gizli imza başka bir uygulamaya aittir ya da bildirimde geçerli bir x-signature yoktur. Gizli imzayı yeniden kopyalayın veya alanı boş bırakın.

Notification answers not for this store: ödeme, bu mağazanın MercadoPago ile ödenmiş bir siparişine ait değildir. Sipariş değiştirilmez.

A credential is not saved: 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.

The customer sees This payment method is not configured correctly. Please choose another payment method or contact the store.: geçerli modun kimlik bilgileri eksik, yanlış öneke sahip veya MercadoPago tarafından reddedilmiştir. Bunları ayarlar sayfasında kontrol edin.

The customer sees MercadoPago cannot process payments in: sipariş para birimi MercadoPago hesabınızın para birimi değildir. MercadoPago para birimlerini dönüştürmez.

The secure card form does not load: 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'ini kontrol edin. Daha fazla ayrıntı için Debug log seçeneğini açın ve WooCommerce > Status > Logs sayfasında wcp_mercadopago_gateway kaynağına bakın.

Refund fails with a message about the mode: ödeme test veya canlı modda yapıldı ve o modun Access Token'ı ayarlanmamış. Girin ve yeniden deneyin.

Refund fails with MercadoPago did not answer the refund request: tekrar denemeden önce ödemeyi MercadoPago panelinde kontrol edin.

The license block shows an error: lisans bloğundaki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa, vibefox.net hesabınızda bir hak serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse, anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasında silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman silinir. Ağ geçidi ayarları, kayıtlı hesap kontrolü ve günlükler yalnızca Delete data on uninstall açıksa silinir. Aksi halde yeniden kurulum için saklanırlar. Mevcut siparişler ödeme notlarını, MercadoPago ödeme kimliklerini ve işlem kimliklerini korur.

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