VibeFox PagSeguro for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve sonrası (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

Currency: Brezilya Reali (BRL). Mağazada BRL para birimi bulunmalıdır (System > Localisation > Currencies) ve ödeme yöntemi yalnızca müşteri BRL ile ödeme yaptığında gösterilir.

Reachable site: PagBank'ın ödeme bildirimlerini iletebilmesi için mağazanızın internetten erişilebilir olması gerekir.

PagBank account: gerçek ödemeler için bir üretim token'ı ve testler için bir sandbox token'ı. Üretim: PagBank hesabınıza giriş yapın, Venda online > Integrações bölümünü açın ve Gerar token seçeneğine tıklayın; PagBank token'ı e-posta ile gönderir. Sandbox: sandbox hesabınızın token'ını PagBank geliştirici portalından kopyalayın. Sandbox ve üretim token'ları yalnızca kendi ortamlarında çalışır.

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_pagseguro_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_pagseguro_gateway.ocmod.zip bulunur. Yalnızca kullandığınız OpenCart sürümünün paketini 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 seçeneğine tıklayın ve wcp_pagseguro_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications bölümünün yenilenmesi 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 tür olarak Payments seçin. VibeFox PagSeguro Gateway eklentisini bulun ve Install (yeşil + düğmesi) seçeneğine tıklayın. Yönetici kullanıcınızın ödeme eklentilerinin listesini değiştirme yetkisi olmalıdır.

3. Ayarlar sayfasını açmak için Edit (kalem düğmesi) seçeneğine tıklayın. VibeFox lisans anahtarınızı sayfanın üst kısmındaki lisans bloğunda bulunan License key alanına yapıştırın ve Activate seçeneğine tıklayın (bkz. Lisans anahtarı).

4. Sandbox token'ını ve gerçek ödemeleri almak için üretim token'ını girin. PagBank'ta herhangi bir ayar yapmanız gerekmez: bildirim URL'si her ödemeyle birlikte gönderilir.

5. Enable / Disable seçeneğini açın ve Save düğmesine tıklayın. Sandbox Mode açıkken test ödemeleri yapın, ardından gerçek ödemeleri almak için bunu kapatın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_pagseguro_gateway.ocmod.zip dosyasını seçin. Dosya 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 (yeşil + düğmesi) seçeneğine tıklayın.

3. Extensions > Extensions bölümüne gidin ve tür olarak Payments seçin. VibeFox PagSeguro Gateway eklentisini bulun, Install (yeşil + düğmesi) seçeneğine, ardından Edit (kalem düğmesi) seçeneğine tıklayın.

4. Lisans anahtarını ve token'ları girin, ardından OpenCart 3 için 3 ila 5 arasındaki adımlardaki gibi ödemeleri test edin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca bildirim URL'si farklıdır (bkz. Notification URL); o da her ödemeyle birlikte PagBank'a gönderilir.

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

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox PagSeguro Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üzerinde sayfa geçerli modu gösterir: SANDBOX MODE (ödemeler PagBank sandbox ortamında oluşturulur, gerçek bir tahsilat yapılmaz) veya LIVE (ödemeler üretim token'ı ile oluşturulur). Geçerli modun token'ı eksik olduğunda (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve mağazanın varsayılan para birimi BRL değilse uyarır. Eklentiyi değiştirme yetkisi olmadan sayfa ayarları gösterir ancak kaydedemez.

Kaydederken Title boş olamaz (en fazla 128 karakter), 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, hata bunu belirtir ve hiçbir şey kaydedilmez.

PagSeguro / PagBank

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

Title: müşterinin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: PagSeguro / PagBank. Zorunlu, en fazla 128 karakter.

Description: müşterinin Confirm Order adımında onay düğmesinin üzerinde gördüğü metin. Varsayılan: Pay securely via PagSeguro/PagBank. You will be redirected to complete your payment.

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

Geo Zone: PagBank'ı yalnızca seçilen coğrafi bölgedeki fatura adresleri için sunar. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde ayarlanır. OpenCart 4'te mağaza ödeme adresi istemediğinde teslimat adresi kullanılır.

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

PagBank hesabı

Bu bölüm token'ların nereden alınacağını açıklar ve PagBank hesabınıza ile token hakkındaki PagBank sayfasına bağlantılar içerir.

Sandbox Mode: Enable sandbox/test mode (no real charges). Yeni ödemeler sandbox token'ı ile PagBank sandbox ortamına gönderilir ve müşteriler Confirm Order adımında SANDBOX MODE — Using test environment. No real charges. ifadesini görür. Bir siparişin durum sorgulamaları ve iadeleri her zaman ödemenin oluşturulduğu ortamı ve token'ı kullanır. Varsayılan: açık.

Sandbox token: PagBank sandbox token'ı. Sandbox modu açıkken kullanılır.

Production token: PagBank üretim token'ı (Bearer). Sandbox modu kapalıyken kullanılır. Gizli tutun.

Kaydedilmiş token'lar 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. Kaydedilmiş bir token'ı kaldırmak için alanın altındaki Clear the saved token on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Ödeme bildirimleri

Notification URL: her ödemede PagBank'a ödeme sayfası ve ödeme bildirimlerini bu URL'ye göndermesi söylenir; bu nedenle PagBank'ta yapılandırılacak bir şey yoktur. OpenCart 3'te şuna benzer: https://your-store/index.php?route=extension/payment/wcp_pagseguro_gateway/webhook, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_pagseguro_gateway/payment/wcp_pagseguro_gateway.webhook şeklindedir ve OpenCart kurulumunuzun vitrin adresinden oluşturulur. URL internetten erişilebilir olmalıdır.

x-authenticity-token başlığı taşıyan bildirimler, ödemenin oluşturulduğu ortamın token'ı ile doğrulanır; geçersiz bir imza reddedilir. Bildirimin gövdesine asla güvenilmez: eklenti, siparişi değiştirmeden önce ödeme sayfasını ve PagBank siparişini (durum, tutar, para birimi) her zaman PagBank API'sinden okur. Bildirim olmadan sipariş, müşteri ödemeden sonra mağazaya döndüğünde durumunu alır.

Siparişler

OpenCart, siparişi Confirm Order adımında durumsuz (eksik sipariş) olarak oluşturur. Sipariş, PagBank ödemeyi bir bildirimle veya müşterinin dönüşünde bildirdikten sonra bir durum alır; ödeme her zaman PagBank'tan tekrar okunur. Aşağıdaki her alan, OpenCart sipariş durumlarınızı listeler.

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

Awaiting PagBank Payment Status: bir boleto veya PIX düzenlendi ya da ödeme incelemede (WAITING / IN_ANALYSIS); PagBank parayı daha sonra onaylar. Varsayılan: Beklemede.

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

Payment Declined Status: bekleyen bir siparişin ödemesi reddedildi. PagBank ödemeyi daha sonra ödendi olarak bildirirse sipariş, ödeme sonrası durumu alır. Varsayılan: Başarısız.

Payment Cancelled Status: bekleyen bir siparişin ödemesi PagBank'ta iptal edildi. Bu durumdaki bir sipariş için gelen bir ödeme, siparişi inceleme durumuna alır. Varsayılan: İptal edildi.

Refunded Status: ödeme, sipariş sayfasından veya PagBank 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_psg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Günlükler token veya müşteri verisi içermez. Hatalar ve uyarılar her zaman kaydedilir. Varsayılan: kapalı.

Log: günlüğün boyutunu ve en son kayıtlarını gösterir. Temizlemek için Clear log seçeneğine tıklayın.

Delete Data on Uninstall: açıkken eklentiyi kaldırmak, geçit ayarlarını ve günlüğü siler. Siparişler ve bunların PagBank referansları (iadeler için gereklidir) her zaman saklanır. Varsayılan: kapalı.

İçe aktarma / dışa aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Token'lar dışa aktarılmaz.

Import: daha önce dışa aktarılan JSON'u yapıştırın ve ayarları geri yüklemek için Import seçeneğine tıklayın. Kaydedilmiş token'lar korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak PagSeguro / PagBank). Confirm Order adımında müşteri sizin açıklamanızı ve You will be redirected to the PagBank payment page (credit card, PIX, boleto) and returned to the store. notunu görür. OpenCart siparişi bu adımda, hâlâ durum olmadan oluşturur. OpenCart 4'te müşteri, ödeme yöntemini Payment method options penceresindeki ödeme yöntemi bloğunun Choose düğmesiyle seçer ve ödeme sayfası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 tek bir ürün olarak bir PagBank ödemesi oluşturur: sipariş numarası ve mağaza adınızla birlikte Order # (kuponlar, kargo ve vergiler toplama dahildir) ve müşteriyi PagBank ödeme sayfasına yönlendirir. Müşterinin adı ve e-postası ile müşterinin veya ödeme adresinin adında CPF veya CNPJ geçen özel alanındaki CPF ya da CNPJ (11 veya 14 hane) ve bir Brezilya telefon numarası iletilir. OpenCart'ta varsayılan olarak CPF alanı yoktur; bunu Customers > Custom Fields bölümünden ekleyebilirsiniz. OpenCart 4'te mağaza ödeme adresi istemediğinde teslimat adresi ve onun özel alanları kullanılır. Müşteri bu bilgileri PagBank sayfasında tamamlayabilir veya düzeltebilir ve PagBank hesabınızda etkinleştirilmiş yöntemlerle öder. Ödeme sayfası 120 dakika sonra sona erer.

Ödeme yaptıktan sonra müşteri mağazanıza döner. Sipariş, yalnızca PagBank onayladıktan sonra ödenmiş olarak işaretlenir: eklenti, bildirim geldiğinde veya müşteri döndüğünde ödemeyi PagBank API'sinden okur ve tahsil edilen tutar (PagBank taksit faizi hariç) ile para birimi siparişle eşleşmelidir. Sipariş ardından OpenCart'ın standart yoluyla, olağan sipariş e-postaları ve stok güncellemesiyle bir durum alır ve müşteri OpenCart sipariş başarı sayfasını görür. Oluşturulan bir boleto veya PIX ya da incelemedeki bir ödeme için sayfa ayrıca Your PagBank payment is awaiting confirmation (boleto / PIX / analysis). The order will be confirmed as soon as PagBank reports the payment. gösterir. İnceleme durumundaki bir sipariş için We are confirming your payment with PagBank. The order will be updated automatically — please do not pay again. gösterilir. Müşteri döndüğünde PagBank ödemeyi henüz onaylamadıysa, Payment confirmation sayfası aynı metni Check again ve Back to checkout düğmeleriyle gösterir.

Ödeme tamamlanmadıysa müşteri ödeme sayfasına şu mesajlarla döner: The PagBank payment was not completed. You can try again or choose another payment method., The PagBank payment page has expired. You can try again or choose another payment method. veya The payment was declined by PagBank. Please try again with another card or payment method. Sepet korunur. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir. Boleto veya PIX bekleyen bir sipariş iptal edildiyse müşteri The PagBank payment was cancelled, so the order was cancelled. ifadesini görür. Sepet zaten boşsa (örneğin sipariş, boleto veya PIX'in süresi dolmadan önce başarı sayfasına ulaştıysa), ödeme sayfasında ödenecek bir şey yoktur: bunun yerine bir Payment confirmation sayfası mesajı gösterir; ödenmemiş bir sipariş için bu mesaj The PagBank 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. şeklindedir ve bir Continue düğmesi bulunur.

OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur. OpenCart 4, ödeme sürecindeki siparişi tutar ve günceller; bu nedenle reddedilen bir karttan, tamamlanmamış bir ödemeden veya süresi dolan bir sayfadan sonra müşteri aynı siparişi yeni bir PagBank ödemesiyle öder. Yeni bir ödemeden önce eklenti, aynı sipariş ve sepetin önceki PagBank ödemelerini kontrol eder: önceki bir sayfada yapılan bir ödeme, yeni bir ödeme oluşturmak yerine uygulanır ve sepetteki başka bir sipariş ödenmiş veya bekliyorsa müşteri başarı sayfasına gider. Siparişin açık ödeme sayfası, tutar ve ortam aynıysa ve 10 dakika içinde sona ermiyorsa yeniden kullanılır; aksi halde devre dışı bırakılır ve artık ödenemez. Yine de ikinci bir ödeme gelirse, bir not sizden bunu iade etmenizi ister.

Sipariş ödendikten sonra sizin tarafınızdan kapatılmışsa (örneğin iptal edilmiş veya iade edilmişse), PagBank'tan dönen müşteri başarı sayfasını görmez: müşteri ödeme sayfasına Your previous order #(number) was closed by the store. Please confirm the order again to pay with a new order. mesajıyla geri döner ya da sepet zaten boşsa bu mesajı bir Payment confirmation sayfasında görür.

OpenCart 4'te sipariş, başarı sayfası gösterilene kadar ödeme sürecinde kalır. Bu arada o sipariş kapatılmışsa, Confirm Order müşteriyi ödeme sayfasına, ilgili mesajla geri gönderir: yukarıda anlatılan iptal edilmiş boleto veya PIX ile reddedilen ödemeye ilişkin mesajlar, Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. ya da sizin tarafınızdan ödendikten sonra kapatılmış bir sipariş için mağaza tarafından kapatılan siparişe ilişkin mesaj. Bir sonraki Confirm Order yeni bir siparişi öder. Bu sipariş zaten ödenmişse veya bekliyorsa ve sepette artık başka ürünler ya da adetler varsa, mesaj şudur: Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it.

PagBank ödemeyi başlatamazsa müşteri, kısa bir mesajla Confirm Order adımında kalır; örneğin PagBank did not accept your billing details (CPF/CNPJ). Please check them and try again. veya Could not connect to PagBank. Please try again in a moment. Teknik neden günlüğe yazılır.

Mağaza bakım modundayken de bildirimler çalışır: OpenCart 3 ödeme eklentisi isteklerine izin verir; OpenCart 4'te ise eklenti, bildirimin ve müşterinin PagBank'tan dönüşünün geçmesini sağlayan bir başlangıç eylemi ekler.

Eklentinin sitede bir kart formu, kayıtlı kartlar, abonelikler veya yinelenen ödemeler ile bölünmüş ödemeler veya pazar yerleri yoktur. Ödeme yöntemleri ve taksitler PagBank hesabınızda yapılandırılanlardır.

Siparişler ve iadeler

Sipariş durumları

No status (missing order): müşteri PagBank'a gönderildi ve ödeme yapmadı, kart reddedildi veya ödeme sayfasının süresi doldu; müşteri yeniden ödeyebilir. 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 sayfasındaki ödenmemiş bir sipariş Voided durumunu alabilir; bu durum, müşteri Confirm Order adımına geri döndüğünde OpenCart 4 tarafından ayarlanır. 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 beklenen tutar ve para birimiyle onaylandı. Bir not tutarı, ödeme yöntemini ve PagBank tahsilat kimliğini gösterir.

Awaiting PagBank Payment Status (default Pending): bir boleto veya PIX oluşturuldu ve ödeme bekleniyor ya da ödeme incelemede. PagBank bunu ödenmiş olarak bildirdiğinde sipariş Order Status After Payment durumuna geçer.

PagBank Payment On Hold Status (default Pending): PagBank siparişten farklı bir tutar veya para birimi bildirdi; sipariş iptal edildikten sonra bir ödeme geldi (stoğu kontrol edin, ardından siparişi tamamlayın veya PagBank'ta ödemeyi iade edin); ya da bir kart ödemesi yetkilendirildi ama tahsil edilmedi (PagBank'ta tahsil edin). Not bunu açıklar. Fiilen alınan para, iadeler için kaydedilir.

Payment Declined Status (default Failed): bekleyen veya incelemedeki bir ödeme reddedildi.

Payment Cancelled Status (default Canceled): süresi dolan bir boleto veya PIX gibi bekleyen bir ödeme iptal edildi.

Refunded Status (default Refunded): ödeme, eklenti üzerinden veya PagBank panelinde tamamen iade edildi.

Her PagBank durumu yalnızca bir kez uygulanır; bu nedenle tekrarlanan bildirimler veya dönüşler not ya da durum değişikliği eklemez. Ödenmiş bir sipariş asla geri alınmaz. Zaten ödenmiş bir sipariş için ikinci bir ödeme gelirse sipariş değiştirilmez ve bir not, kopyayı PagBank'ta iade etmenizi ister. Notlar, müşterinin görmediği sipariş History kayıtlarıdır.

VibeFox PagSeguro Gateway sekmesi

Sales > Orders bölümünde PagBank ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox PagSeguro Gateway sekmesi; sandbox ödemeleri için Sandbox etiketiyle PagBank checkout bilgisini, PagBank order ve Charge kimliklerini, Payment method bilgisini, Status bilgisini, Paid / refunded tutarlarını, iade formunu, iade geçmişini ve siparişin PagBank notes bölümünü gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox PagSeguro Gateway sekmesinde Amount alanını girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) girin ve Refund via PagBank seçeneğine tıklayın. Refund this amount through PagBank? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Eklentiyi değiştirme yetkisine ihtiyacınız vardır (System > Users > User Groups bölümünde ayarlanır). Sınır, PagBank'ın tahsil ettiği tutardır; bu nedenle bir tutar uyuşmazlığından sonra, sipariş toplamına değil müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı ortamda ve token ile gönderilir. Bir iade yalnızca PagBank onayladığında kaydedilir; aksi halde sekme hatayı gösterir, örneğin PagBank refund failed: ... veya PagBank did not confirm the refund, ve hiçbir şey kaydedilmez. Boleto ödemelerinin iadeleri ve PIX'in kısmi iadeleri PagBank kurallarına uyar. Başarılı bir iade, iade geçmişine ve notlara tahsilat kimliğiyle birlikte eklenir. Tam iade, siparişi müşteriye bildirmeden ve ürünleri stoğa geri koymadan Refunded Status durumuna alır; tıpkı manuel bir durum değişikliği gibi. Kısmi iade durumu değiştirmez. İadeler, PagBank ödemeyi ödenmiş olarak bildirdikten sonra kullanılabilir.

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

PagBank panelinde yapılan iadeler bir sonraki bildirim veya kontrolde görülür: tam iade siparişi Refunded Status durumuna alır, kısmi iade ise iade edilen tutarla birlikte bir not ekler.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox PagSeguro Gateway lisans bloğu, ayarların üzerinde, Extensions > Extensions > Payments > VibeFox PagSeguro Gateway > Edit sayfasındaki ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate seçeneğine tıklayın. Bundan sonra blok, anahtarı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu tarih 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-pagseguro 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 yetkisine sahip yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedeni belirtir, örneğin Key not found, This key belongs to another product, Domain limit reached veya bir tarihle birlikte 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 seçeneğine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar 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 PagBank, ö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. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, bir anahtar satın almadan önce eklentiyi kurup test edebilmeniz için mağazada ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan ödeme yöntemi herkes için gizlidir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard ekranında bir hatırlatma belirir. 7 gün gizlemek için × ile kapatın. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder 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. Yönetici Dashboard ekranını veya Edit sayfasını açtığınızda durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, ardından haftada bir kez. Bir cron işi gerekmez. Eklentiyi kaldırmak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

PagBank does not appear at checkout: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu, geçerli modun token'ının ayarlandığını (sandbox modunda Sandbox token, canlı modda Production token) ve müşterinin BRL ile ödeme yaptığını kontrol edin. Ayarlar sayfası token eksik olduğunda veya mağaza para birimi BRL değilse uyarı gösterir. Ayrıca ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlardaki Total değerine ulaştığını kontrol edin.

The payment went through, but the order stays without a status: PagBank ödemeyi henüz bildirmedi ve müşteri mağazaya dönmedi. Bildirim ulaşır ulaşmaz sipariş bir durum alır. Mağazanızın Notification URL adresinde internetten erişilebilir olduğunu kontrol edin ve bildirimleri görmek için Debug log seçeneğini açın.

The notification answers Invalid signature: x-authenticity-token, ödemenin yapıldığı ortamın token'ı ile eşleşmiyor ya da bu token kaydedilmemiş. Ayarlarda doğru token'ın bulunduğunu kontrol edin.

The notification answers Verification failed, retry later: PagBank API'sine ulaşılamadı, ödeme ortamının token'ı eksik ya da sepet aynı anda başka bir istek tarafından işleniyordu. PagBank bildirimi yeniden dener.

The notification answers Order not found: bildirim, bu mağazada bu eklenti ile ödenmemiş bir siparişe aittir. Hiçbir şey değiştirilmez.

The customer sees PagBank payments are temporarily unavailable. Please choose another payment method.: geçerli modun token'ı eksik ya da PagBank onu reddetti.

The customer sees PagSeguro/PagBank only accepts payments in Brazilian Real (BRL).: ödeme sayfası başka bir para biriminde.

The customer sees This order has no amount to pay.: sipariş toplamı sıfır.

Order is in the review status after payment: VibeFox PagSeguro Gateway sekmesindeki notları okuyun (bkz. Sipariş durumları), PagBank'taki tutarları karşılaştırın, ardından siparişi tamamlayın veya ödemeyi iade edin.

No refund form in the tab: sekme nedenini belirtir: ödeme henüz ödenmiş olarak bildirilmemiştir, tamamen iade edilmiştir, kullanıcı grubunuzun eklentiyi değiştirme yetkisi yoktur veya ödemenin ortamının token'ı ayarlanmamıştır.

Refund fails with a message about the token: ödeme sandbox'ta veya üretimde yapıldı ve o ortamın token'ı eksik ya da reddedildi. Doğru token'ı girin ve yeniden deneyin.

Geliştiriciler için: PagBank ödeme sayfası oluşturulmadan önce eklenti, istek gövdesi, sipariş ve ortam ile birlikte OpenCart olayı wc_psg_checkout_data'yı tetikler. Ürün, 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 PagSeguro Gateway yanındaki Uninstall (kırmızı − düğmesi) seçeneğine 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 olayları ve bakım modunda bildirimlerin ve müşterinin dönüşünün geçmesini sağlayan başlangıç eylemi de kaldırılır). Delete Data on Uninstall açıksa diğer geçit ayarları (başlık, açıklama, sandbox modu, token'lar, günlükleme) ve günlük silinir. Kapalıysa sonraki bir yeniden kurulum için saklanırlar. PagBank ödeme ve iade kayıtları her zaman saklanır; 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ırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu eklentiler listesindeki VibeFox PagSeguro Gateway yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın ve ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

PagSeguro ve PagBank, ilgili sahiplerinin ticari markalarıdır. Bu eklenti PagSeguro veya PagBank ile bağlantılı değildir ve onlar tarafından onaylanmamıştır.