VibeFox Pagar.me for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 sürümünde test edildi) veya 4.0.2 ve sonrası (4.1.0.3 sürümünde test edildi).

PHP: 8.0 veya üzeri.

Currency: Brezilya reali (BRL). Mağazanızda BRL para birimi tanımlı olmalıdır (System > Localisation > Currencies); ödeme yöntemi yalnızca müşteri BRL ile ödeme yaptığında ve sipariş toplamı sıfırdan büyük olduğunda gösterilir.

Pagar.me account: Pagar.me hesabınızın gizli anahtarlarına ihtiyacınız var: test anahtarı (sk_test_...) ve canlıya geçmek için canlı anahtar (sk_...). Bunlar Pagar.me panelinde Development > Keys altında bulunur. Yalnızca gizli anahtarlar kullanılır; genel anahtar (pk_...) gerekli değildir. Yalnızca Pagar.me hesabınızda etkinleştirilmiş ödeme yöntemleri sunulabilir.

VibeFox license key: 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_pagarme_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_pagarme_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_pagarme_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 tür olarak Payments seçin. VibeFox Pagar.me Gateway 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 yetkisi olmalıdır.

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ündeki lisans bloğunda License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Test gizli anahtarını girin ve canlıya geçtiğinizde canlı gizli anahtarı girin.

5. Pagar.me panelinde, ayarlarda gösterilen URL ile bir webhook oluşturun (bkz. Yapılandırma).

6. Enable / Disable seçeneğini etkinleştirin ve Save düğmesine tıklayın. Test mode açıkken test ödemeleri yapın, ardından gerçek ödemeleri kabul etmek için kapatın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_pagarme_gateway.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış 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 Pagar.me 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ı, gizli anahtarları ve webhook'u OpenCart 3 için 3 ila 6. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca webhook URL'si farklıdır (bkz. Ödeme bildirimleri (webhook)).

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 Pagar.me Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa geçerli modu gösterir: TEST MODE (ödemeler test gizli anahtarıyla oluşturulur, gerçek çekim yapılmaz) veya LIVE. Geçerli modun gizli anahtarı eksikse (bu durumda ödeme yöntemi ödeme ekranında gizlenir), test anahtarı sk_test_ ile başlamıyorsa, canlı anahtar sk_ ile başlamıyorsa veya bir test anahtarıysa ve mağazanın varsayılan para birimi BRL değilse uyarır. Eklentiyi değiştirme yetkisi olmadan sayfa ayarları gösterir ama kaydedemez.

Kaydederken Title boş olamaz (en fazla 128 karakter), Boleto due in (days) 1 ile 30 arasında bir tam sayı olmalıdır, Sort Order bir tam sayı olmalıdır (negatif sayılara izin verilir), Total 0 veya daha büyük bir sayı olmalıdır ve bölge ile sipariş durumları mevcut olmalıdır. Bir değer hatalıysa, bir hata mesajı onu belirtir ve hiçbir şey kaydedilmez.

Pagar.me

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

Title: müşterilerin ödeme ekranında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Pagar.me. Zorunlu, en fazla 128 karakter.

Description: müşterinin Confirm Order adımında onay düğmesinin üstünde gördüğü metin. Varsayılan: Pagar.me ile güvenle ödeyin (kredi kartı, PIX veya boleto). Ödemenizi tamamlamak için yönlendirileceksiniz.

Sort Order: Pagar.me'nin ödeme ekranındaki ödeme yöntemleri arasındaki sırası. Boş bırakın veya bir tam sayı girin.

Geo Zone: Pagar.me'yi 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 tanımlanır. OpenCart 4'te mağaza ödeme adresi istemediğinde, teslimat adresi kullanılır.

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

API anahtarları

Gizli anahtarları Pagar.me panelinden kopyalayın (bölüm oraya bir bağlantı içerir): Development > Keys. Pagar.me, test ve canlı ödemeler için tek bir API adresi kullanır; bir ödemenin test mi yoksa gerçek mi olduğunu anahtar belirler.

Test mode: test gizli anahtarını kullanır, gerçek çekim yapılmaz. Açıkken müşteriler Confirm Order adımında TEST MODE — Use test credentials. No real charges. ifadesini görür. Bir siparişin durum sorgulamaları ve iadeleri her zaman ödemesinin oluşturulduğu modun anahtarını kullanır. Varsayılan: açık.

Test secret key: Pagar.me test gizli anahtarı (sk_test_...). Test modu açık olduğunda kullanılır.

Live secret key: Pagar.me canlı gizli anahtarı (sk_...). Test modu kapalı olduğunda kullanılır. Gizli tutun.

Kaydedilmiş anahtarlar bir daha asla gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı 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 sayfası

Pagar.me ödeme sayfasında sunulan yöntemler, her birinin kendi anahtarı vardır. Yalnızca Pagar.me hesabınızda etkinleştirilmiş yöntemleri seçin. Hiçbiri seçilmezse kredi kartı, PIX ve boleto sunulur. Varsayılan: kredi kartı, PIX ve boleto.

Boleto due in (days): boleto vadesine kalan gün sayısı, 1 ile 30 arasında. Varsayılan: 3. Başka bir değer kaydederken Boleto due in (days): enter a number from 1 to 30. uyarısıyla reddedilir.

Ödeme bildirimleri (webhook)

Pagar.me panelinde Settings > Webhooks bölümünü açın ve bu bölümdeki Webhook URL alanında gösterilen URL ile bir webhook oluşturun. OpenCart 3'te şuna benzer: https://your-store/index.php?route=extension/payment/wcp_pagarme_gateway/webhook, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_pagarme_gateway/payment/wcp_pagarme_gateway.webhook gibidir. URL, OpenCart kurulumunuzun vitrin adresinden oluşturulur. Ayarlarda gösterildiği gibi tam olarak kopyalayın. URL internetten erişilebilir olmalıdır.

Bu olayları seçin (bu bölümde de listelenmişlerdir):

Webhook parola veya imza gerektirmez. İçeriği asla güvenilir kabul edilmez: mağaza ondan yalnızca Pagar.me sipariş kimliğini alır ve bu siparişi, oluşturulduğu modun anahtarıyla Pagar.me API'sinden okur. Bu mağaza tarafından oluşturulmamış Pagar.me siparişlerine ait bildirimler yoksayılır. Webhook olmadan, daha sonra yapılan PIX ve boleto ödemeleri yalnızca müşteri mağazaya döndüğünde onaylanır.

Siparişler

OpenCart siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik bir sipariş, missing order). Sipariş, Pagar.me ödemeyi webhook ile bildirdikten veya müşteri döndüğünde ancak durum alır; Pagar.me siparişi her zaman API'den yeniden okunur. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: doğrulanmış bir Pagar.me ödemesinden sonra ayarlanan durum. Varsayılan: İşleniyor.

Awaiting Pagar.me Payment Status: bir PIX kodu veya boleto düzenlendi ya da bir kart ödemesi incelemede; Pagar.me parayı daha sonra onaylar. Varsayılan: Beklemede.

Pagar.me Payment On Hold Status: ödeme sizin incelemenizi gerektirir (bkz. Sipariş durumları). Varsayılan: Beklemede, çünkü OpenCart'ta Askıda durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturabilir ve burada seçebilirsiniz.

Payment Failed Status: bekleyen bir siparişin ödemesi başarısız oldu, iptal edildi veya süresi doldu. Pagar.me daha sonra ödenmiş olarak bildirirse sipariş ödeme sonrası durumunu alır. Varsayılan: Başarısız.

Cancelled Order Status: mağazanızın iptal edilen siparişler için kullandığı durum. Eklenti bunu ayarlamaz: bundan sonra gelen bir Pagar.me ödemesi siparişi inceleme durumuna alır. Varsayılan: İptal edildi.

Refunded Status: ödeme sipariş sayfasından veya Pagar.me panelinden tamamen iade edildikten sonra ayarlanır. Varsayılan: İade edildi.

Gelişmiş

Debug log: API isteklerini ve bildirimleri OpenCart günlükler klasöründeki (storage/logs) wc_pgm_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar ve uyarılar her zaman günlüğe yazılır. Anahtarlar ve müşteri verileri (e-posta, telefon, CPF) günlüğe yazılmaz. 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 eklentinin kaldırılması gateway ayarlarını ve günlüğü siler. Siparişler ve bunların Pagar.me ödeme verileri (iadeler için gerekli) her zaman korunur. Varsayılan: kapalı.

İçe / Dışa aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Gizli anahtarlar 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ı gizli anahtarlar korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Pagar.me). Confirm Order adımında müşteri sizin açıklamanızı ve You will be redirected to the Pagar.me payment page to pay by credit card, PIX, boleto or debit card. notunu görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. OpenCart 4'te müşteri, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde ödeme yöntemini seçer ve ödeme ekranının altındaki Confirm Order düğmesine tıklar. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş toplamı için BRL cinsinden bir Pagar.me siparişi oluşturur ve müşteriyi Pagar.me ödeme sayfasına gönderir. Vergi, kargo ve diğer ek ücretleri içeren sipariş satırları ürün olarak gönderilir; siparişte indirim (kupon, hediye çeki, ödül puanları) varsa veya satırlar toplamla eşleşmiyorsa, tutar için sipariş numaralı tek bir Order # satırı gönderilir. Geçerli bir e-posta adresi gereklidir.

Müşterinin adı ve e-posta adresi Pagar.me'ye iletilir. CPF veya CNPJ (11 veya 14 haneli), adında CPF veya CNPJ geçen müşteri veya ödeme adresi özel alanından alınır; OpenCart varsayılan olarak böyle bir alan içermez, bu yüzden iletmek istiyorsanız Customers > Custom Fields bölümünde ekleyin. OpenCart 4'te mağaza ödeme adresi istemediğinde, teslimat adresi ve bunun özel alanları kullanılır. Brezilya cep telefonu numarası da iletilir. Fatura adresi yalnızca 8 haneli CEP'i ve eyaleti olan bir Brezilya adresi için iletilir. CPF veya CNPJ yoksa müşteri bunu Pagar.me sayfasında girer.

Ödemeden sonra müşteri mağazanıza döner. Sipariş, yalnızca Pagar.me onayladıktan sonra ödenmiş olarak işaretlenir: mağaza Pagar.me siparişini API'den okur ve ödenen tutar ile para birimi siparişle eşleşmelidir. Sipariş daha sonra olağan OpenCart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle durum alır ve müşteri OpenCart sipariş başarı sayfasını görür. Düzenlenmiş ama henüz ödenmemiş bir PIX veya boleto siparişi bekleme durumuna alır; sayfa ayrıca Your Pagar.me payment is awaiting confirmation (PIX / boleto). The order will be confirmed as soon as Pagar.me reports the payment. mesajını gösterir. İnceleme durumundaki bir sipariş için We are confirming your payment with Pagar.me. The order will be updated automatically — please do not pay again. gösterilir. Sonraki her dönüşte Pagar.me siparişi yeniden okunur; bu yüzden webhook gelmemiş olsa bile bu sırada ödenen bir PIX veya boleto uygulanır.

Müşteri ödeme yapmadan dönerse, ödeme ekranına The Pagar.me payment was not completed. You can try again or choose another payment method. mesajıyla geri gelir. Ödeme reddedildiyse veya iptal edildiyse mesaj The Pagar.me payment was declined or canceled. You can try again or choose another payment method. olur. Sepet korunur. OpenCart 4'te bu mesajlar ödeme ekranının üstünde gösterilir. Siparişin zaten bir durumu varsa ve ödemesi başarısız olduysa veya süresi dolduysa mesaj The Pagar.me payment of your order was declined, canceled or has expired. Please place a new order or contact us. olur. Sepet zaten boşsa (örneğin sipariş, PIX veya boleto süresi dolmadan başarı sayfasına ulaşmışsa), ödeme ekranında ödenecek bir şey yoktur: bir Payment confirmation sayfası The Pagar.me payment of order #N was not completed (declined, canceled or expired), so the order will not be shipped. To buy these items, please place a new order. mesajını ve bir Continue düğmesini gösterir. Pagar.me'ye ulaşılamazsa, bir Payment confirmation sayfası müşteriden tekrar ödeme yapmamasını ister ve Check again ile Back to checkout seçeneklerini sunar.

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 günceller; bu nedenle tamamlanmamış veya reddedilmiş bir ödemeden sonra müşteri aynı siparişi yeniden öder. Yeni bir ödemeden önce eklenti aynı sepetin önceki denemelerini kontrol eder: bunlardan biri ödenmişse veya PIX ya da boleto ödemesi bekliyorsa, müşteri yeni bir ödeme yapmadan başarı sayfasına gider. Aynı siparişin hâlâ açık olan bir Pagar.me ödeme sayfası, tutar ve mod aynıysa yeniden kullanılır; diğer açık sayfalar önce Pagar.me'de kapatılır. Aynı sepetin ikinci bir Pagar.me siparişi yine de ödenirse, uygulanmaz ve ödenmiş siparişteki bir not, kopyayı iade etmeniz için sizden ister.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme ekranında tutar. Bu arada sipariş kapatılmışsa (örneğin PIX veya boleto ödemesinin süresi dolduysa, ödeme başarısız olduysa ya da siz siparişi iptal edip iade ettiyseniz), Confirm Order müşteriyi Your previous order was cancelled or its payment failed. Please confirm the order again. mesajıyla ödeme ekranına geri gönderir; sipariş, siz kapatmadan önce ödenmişse This order was closed by the store, so it will not be shipped. Your cart is kept: confirm the order again to pay. mesajı gösterilir. Bir sonraki Confirm Order yeni bir sipariş öder. Müşteri Pagar.me'den, ödenmiş ve sonra sizin kapattığınız bir siparişe geri döndüğünde aynı mesajı ödeme ekranında görür; sepet zaten boşsa Order #(numara) was closed by the store, so it will not be shipped. To buy these items, please place a new order. mesajını içeren bir sayfa görür. Ödeme ekranındaki siparişin zaten bir durumu varsa ve sepette artık başka ürünler veya adetler varsa, müşteri ödeme ekranına geri gönderilir ve yeni sepet yeni bir sipariş alır.

Pagar.me ödemeyi başlatamazsa, müşteri Confirm Order adımında kısa bir mesajla kalır, örneğin Could not connect to Pagar.me. Please try again in a moment., ya da geçersiz fatura bilgileriyle ilgili Pagar.me mesajıyla. Teknik neden günlüğe yazılır.

Mağaza bakım modundayken de webhook çalışır: OpenCart 3 ödeme eklentisi isteklerine izin verir, OpenCart 4'te ise eklenti, webhook'un ve müşterinin Pagar.me'den dönüşünün geçmesini sağlayan bir başlangıç eylemi (startup action) ekler.

Eklentinin ödeme ekranınızda bir kart formu, kayıtlı kart, abonelik veya düzenli ödeme, taksit kuralı, bölünmüş ödeme (pazar yeri) ve yalnızca ön provizyonlu kart ödemesi yoktur.

Siparişler ve iadeler

Sipariş durumları

No status (missing order): müşteri Pagar.me'ye yönlendirildi ve henüz ödeme yapmadı ya da PIX veya boleto düzenlemedi ya da ödeme reddedildi. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

OpenCart 4'te ödeme ekranından gelen ödenmemiş bir sipariş, müşteri Confirm Order adımına döndüğünde OpenCart 4 tarafından ayarlanan Voided durumunu alabilir. Eklenti böyle bir siparişi durumsuz sipariş olarak değerlendirir ve sonraki bir ödeme yine de onu onaylar.

Order Status After Payment (default Processing): ödeme onaylandı. Bir not, Pagar.me sipariş kimliğini (or_...) ve ödeme yöntemini gösterir.

Awaiting Pagar.me Payment Status (default Pending): bir PIX veya boleto düzenlendi (ya da bir kart ödemesi incelemede) ve ödeme bekleniyor. Pagar.me ödemeyi onayladığında sipariş Order Status After Payment durumuna geçer.

Pagar.me Payment On Hold Status (default Pending): boleto yalnızca kısmen ödendi; ya da ödenen tutar veya para birimi siparişten farklı; ya da ödeme, sipariş iptal edildikten veya iade edildikten sonra geldi; ya da ödenmiş bir siparişte chargeback açıldı. Not bunu açıklar. Siparişi kontrol edin ve tamamlayın ya da ödemeyi iade edin.

Payment Failed Status (default Failed): bekleyen veya askıdaki bir siparişin ödemesi başarısız oldu ya da Pagar.me siparişi iptal edildi veya süresi doldu (örneğin ödenmemiş bir boleto). Pagar.me daha sonra bir ödeme bildirirse sipariş yine Order Status After Payment durumuna geçer.

Refunded Status (default Refunded): ödeme eklenti üzerinden tamamen iade edildi ya da Pagar.me'de iade edildi veya iptal edildi.

Her Pagar.me durumu bir kez uygulanır; bu nedenle tekrarlanan webhook'lar veya dönüşler not ya da ödeme eklemez. Notlar, müşterinin görmediği sipariş History kayıtlarıdır.

VibeFox Pagar.me Gateway sekmesi

Sales > Orders bölümünde Pagar.me ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında, VibeFox Pagar.me Gateway sekmesi, test ödemeleri için Test mode etiketiyle birlikte Pagar.me order kimliğini, Payment method bilgisini, Status durumunu, Paid / refunded tutarlarını, iade formunu, iade geçmişini ve siparişin Pagar.me notes bölümünü gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox Pagar.me Gateway sekmesinde Amount alanını doldurun (henüz iade edilmemiş tutar otomatik yazılır), isteğe bağlı olarak bir Reason (optional) girin ve Refund via Pagar.me düğmesine tıklayın. Refund this amount through Pagar.me? This cannot be undone. sorusunu onaylayın. Kart ve PIX ödemelerinin tam ve kısmi iadeleri desteklenir. Eklentiyi değiştirme yetkisine ihtiyacınız vardır (System > Users > User Groups bölümünde ayarlanır). Pagar.me'nin gerçekte çektiği tutara kadar iade yapabilirsiniz; bu nedenle tutar uyuşmazlığından sonra sınır, sipariş toplamı değil müşterinin ödediği tutardır. İade, ödemenin yapıldığı modun anahtarıyla gönderilir; bu yüzden o modun gizli anahtarı ayarlanmış olmalıdır. İade yalnızca Pagar.me onayladığında kaydedilir; aksi halde sekme Pagar.me refused the refund: ... veya Pagar.me did not confirm the refund gibi bir hata gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, tahsilat kimliğiyle birlikte iade geçmişine ve notlara eklenir. Tam iade, siparişi müşteriye bildirmeden ve ürünleri stoka geri koymadan Refunded Status durumuna alır; tıpkı manuel durum değişikliği gibi. Kısmi iade durumu değiştirmez. İadeler, Pagar.me ödemeyi bildirdikten sonra kullanılabilir.

Boleto ödemeleri yalnızca müşterinin banka hesabına iade edilebilir. Bunları Pagar.me panelinde iade edin, ardından iadeyi OpenCart'ta elle kaydedin. Sales > Returns bölümündeki ürün iadeleri Pagar.me üzerinden para geri göndermez.

Pagar.me panelinde yapılan tam iade veya iptal webhook ile gelir, siparişi Refunded Status durumuna alır ve bir not ekler. Bir chargeback bir not ekler ve ödenmiş bir siparişi inceleme durumuna alır.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Pagar.me Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Pagar.me 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 tarihi 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-pagarme satırı ve hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca eklenti için Modify yetkisine sahip yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici panelinin diline uyar (İ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 tarihle birlikte License expired on. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvası boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumuyla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresinde. 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 Pagar.me müşterilere ödeme ekranı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. Aynı tarayıcıda yönetici paneline giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada (unlicensed — visible to admins only) ibaresiyle görmeye devam eder; böylece bir 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 yüzden etkin bir anahtar olmadan ödeme yöntemi herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici panelinin Dashboard sayfasında bir hatırlatıcı görünür. 7 gün gizlemek için × ile kapatın. 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, yönetici panelindeki Dashboard veya Edit sayfası açıldığında otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, ardından haftada bir kez. Cron işi gerekmez. Eklentinin kaldırılması her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Pagar.me does not appear at checkout: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu, geçerli modun gizli anahtarının ayarlandığını (test modunda Test secret key, canlı modda Live secret key) ve müşterinin BRL ile ödeme yaptığını kontrol edin. Anahtar eksikse ayarlar sayfası bir uyarı gösterir. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda tanımlanan Total tutarına ulaştığını kontrol edin.

The payment went through, but the order stays without a status or in the awaiting status: webhook çalışmıyor. Pagar.me panelinde, kullandığınız hesap ve mod için webhook'un var olduğunu, URL'sinin Webhook URL altında gösterilenle tam olarak aynı olduğunu ve yukarıda listelenen olayların seçili olduğunu kontrol edin. Sipariş, müşteri mağazaya her döndüğünde de kontrol edilir.

The webhook answers verification failed, retry later: mağaza Pagar.me siparişini API'den okuyamadı; örneğin o modun anahtarı eksik olabilir ya da API yanıt vermemiş olabilir. Pagar.me webhook'u yeniden dener.

The webhook answers busy: sepet aynı anda başka bir istek tarafından işleniyordu ya da sipariş durumu ayarlanamadı. Pagar.me webhook'u yeniden dener. Nedenini görmek için Debug log seçeneğini açın.

The webhook answers unknown order: Pagar.me siparişi bu mağaza tarafından oluşturulmamış; örneğin aynı hesaptaki başka bir mağazanın siparişi. Hiçbir şey değişmez.

The webhook answers invalid payload or invalid order id: istek bir Pagar.me bildirimi değildir. Hiçbir şey değişmez.

The customer sees Pagar.me payments are not available right now: gizli anahtar yanlış ya da eksik. Geçerli modun anahtarını kontrol edin.

The customer sees Pagar.me could not start the payment: Pagar.me fatura bilgilerini reddetti; örneğin özel alandaki CPF. Mesaj sorunu belirtir; tam neden günlüktedir.

The customer sees A valid billing email is required for Pagar.me.: siparişin e-posta adresi geçerli değil.

The customer sees Pagar.me only supports payments in Brazilian Real (BRL).: ödeme ekranı başka bir para biriminde.

The customer sees This order already has a Pagar.me payment that the store has to review: sepetin daha önceki bir ödemesi sizin incelemenizi gerektiriyor. Pagar.me panelini ve günlüğü kontrol edin.

Order is in the review status after payment: VibeFox Pagar.me Gateway sekmesindeki notları okuyun (bkz. Sipariş durumları), ardından siparişi tamamlayın veya ödemeyi iade edin.

No refund form in the tab: sekme nedenini belirtir: ödeme henüz bildirilmemiş, tamamen iade edilmiş, kullanıcı grubunuzun eklentiyi değiştirme yetkisi yok ya da ödemenin modunun gizli anahtarı ayarlanmamış.

Refund fails for a boleto: boleto ödemeleri API üzerinden iade edilemez. Pagar.me panelinde iade edin ve iadeyi elle kaydedin.

Geliştiriciler için: Pagar.me siparişi gönderilmeden önce eklenti, istek gövdesi ve sipariş ile birlikte OpenCart olayı wc_pgm_order_data'yı tetikler. Ödeme tutarı sipariş toplamına eşit kalmalıdır.

Kaldırma

Extensions > Extensions bölümüne gidin, tür olarak Payments seçin ve VibeFox Pagar.me 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ılan değerlerine döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te ayrıca olayları ve webhook'un ile müşterinin dönüşünün bakım modunda geçmesini sağlayan başlangıç eylemi de kaldırılır). Delete data on uninstall açıksa diğer gateway ayarları (başlık, açıklama, test modu, gizli anahtarlar, ödeme yöntemleri, boleto günleri, günlük kaydı) ve günlük silinir. Kapalıysa, sonraki bir yeniden kurulum için saklanırlar. Pagar.me ödeme ve iade kayıtları 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 eklenti dosyalarını da kaldırmak için kaldırdıktan sonra Extensions > Installer bölümüne gidin, kurulu eklentiler listesinde VibeFox Pagar.me Gateway 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.

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