VibeFox PagSeguro for PrestaShop

Genel bakış

VibeFox PagSeguro Gateway, PrestaShop'u PagBank Checkout API aracılığıyla PagBank'a (eski adıyla PagSeguro) bağlar. Ödeme adımında müşteri PagBank'ı seçer; modül, sepet tutarının tam değeri için bir PagBank ödemesi oluşturur ve müşteriyi PagBank ödeme sayfasına yönlendirir. Müşteri orada PagBank hesabınızda etkin olan yöntemlerle, örneğin kredi kartı, PIX veya boleto ile öder ve mağazanıza geri döner. Ödemeler yalnızca Brezilya reali (BRL) ile kabul edilir. Sipariş yalnızca PagBank ödemeyi bildirdikten sonra oluşturulur; bu nedenle yarıda kalan ödemeler ödenmemiş sipariş bırakmaz.

PrestaShop sipariş sayfasından iade yapabilmek ve PagBank'ın barındırdığı ödeme sayfasını kullanmak isteyen Brezilyalı mağazalar için uygundur. Modülde mağaza içi kart formu, kayıtlı kart, abonelik veya yinelenen ödeme ve bölünmüş ödeme özelliği yoktur. Ödeme yöntemleri ve taksitler PagBank hesabınızda yapılandırılır; modül içinde seçilmezler.

Temel özellikler

PagBank'ın barındırdığı ödeme sayfası: sunucunuzda hiçbir kart verisi bulunmaz. Müşterinin adı, e-posta adresi, bir Brezilya telefon numarası ve CPF/CNPJ bilgisi, mağazada mevcutsa PagBank sayfasında otomatik doldurulur.

Yalnızca PagBank onayladığında ödenmiş sayılır: bildirimler ve müşterinin geri dönüşü, ödeme sayfası ve PagBank siparişi API üzerinden okunarak kontrol edilir: durum, centavo cinsinden tutar ve para birimi. Geçersiz imzaya sahip bildirimler reddedilir.

PagBank'ta yapılandırılacak bir şey yoktur: bildirim URL'si her ödemeyle birlikte gönderilir.

Tutar kontrolü: tutarı veya para birimi sepetle uyuşmayan bir ödeme, bir notla birlikte PagBank payment on hold durumuna alınır. Alıcının ödediği taksit faizi dikkate alınır.

Açık durumlar: ödenmiş siparişler Payment accepted durumuna geçer; oluşturulan PIX veya boleto ile analizdeki ödemeler Awaiting PagBank payment durumuna geçer; sonradan reddedilen ödemeler Payment error, iptal edilenler ise Canceled durumuna geçer.

Çift ödeme yok: yeniden ödeme, açık PagBank ödemesini yeniden kullanır veya önceki ödemeyi devre dışı bırakır. Tekrarlanan bildirimler ve geri dönüşler hiçbir zaman ikinci bir sipariş oluşturmaz ve ödemeyi iki kez kaydetmez.

Sandbox ve canlı ortam: ayrı token'lar. Bir siparişin durum sorgulamaları ve iadeleri her zaman ödemenin yapıldığı ortamı kullanır.

Sipariş sayfasından iadeler: PagBank payment bloğunda tam ve kısmi iadeler; PagBank'ın tahsil ettiği tutara kadar ve yalnızca PagBank onayladığında kaydedilir. Tam iade siparişi Refunded durumuna getirir.

Gereksinimler

PrestaShop 8.0 ile 9.x, PHP 8.0 veya üzeri. Sepet para birimi olarak Brezilya reali (BRL). İnternetten HTTPS ile erişilebilen bir mağaza. Canlı token'a sahip bir PagBank hesabı ve testler için bir sandbox token'ı. vibefox.net üzerinden alınmış bir VibeFox lisans anahtarı (alan adı başına bir anahtar).