VibeFox Conekta for PrestaShop

Genel bakış

VibeFox Conekta Gateway, PrestaShop'a Conekta (Meksika) üzerinden ödeme alma imkânı ekler. Ödeme adımında müşteri Conekta'yı seçer, Conekta tarafından barındırılan güvenli ödeme sayfasına yönlendirilir ve kredi veya banka kartı ile, OXXO ve diğer mağazalarda nakit olarak, SPEI banka havalesiyle ya da BNPL ile ödeme yapar; bu yöntemlerden hangilerine izin verdiğinize göre. Ardından müşteri mağazanıza geri döner. Kart bilgileri hiçbir zaman sitenize ulaşmaz. Sipariş, yalnızca Conekta ödemeyi onayladıktan veya bir OXXO ya da SPEI referansı düzenledikten sonra oluşturulur; bu nedenle yarıda bırakılan ödemeler ödenmemiş sipariş bırakmaz.

Bu modül, MXN veya USD ile satış yapan ve kart ile nakit ödemelerini tek bir ödeme yöntemiyle, bir Conekta hesabı üzerinden kabul etmek isteyen Meksikalı mağazalar için uygundur. Modül yalnızca tek seferlik ödemeleri destekler. Ödeme sayfanızda kart formu yoktur; kayıtlı kart, abonelik, ön provizyon ve tahsilat ya da aylık taksit (MSI) desteği de yoktur. Conekta panelinde yapılan iadeler veya chargeback'ler yalnızca siparişe not olarak eklenir; otomatik olarak kaydedilmez.

Temel özellikler

Conekta tarafından barındırılan ödeme sayfası: sepet tutarı için, sepet para biriminde bir Conekta siparişi oluşturulur. Nakit, SPEI ve BNPL yalnızca MXN sepetler için sunulur; USD sepetlerinde yalnızca kart kabul edilir.

Yalnızca Conekta onayladığında ödenmiş sayılır: hem webhook hem de müşterinin dönüşü yalnızca Conekta API'sinden siparişi özel anahtarınızla (Private Key) okuma işlemini tetikler. Bildirimde veya dönüş URL'sinde yer alan hiçbir veriye güvenilmez.

Tutar ve para birimi kontrolü: kuruş cinsinden tutar ve para birimi sepetle karşılaştırılır. Herhangi bir fark veya mağaza canlı moddayken alınan bir test modu ödemesi, siparişi inceleme için Conekta payment on hold durumuna alır.

OXXO ve SPEI: müşteri bir ödeme referansı aldığında sipariş Awaiting Conekta payment olarak oluşturulur ve Conekta ödemeyi bildirdiğinde Payment accepted durumuna geçer.

Çift işlem yok: tekrarlanan veya eşzamanlı bildirimler hiçbir zaman ikinci bir sipariş oluşturmaz ve ödemeyi iki kez kaydetmez. Açık bir Conekta ödeme sayfası, yenisi oluşturulmadan önce yeniden kullanılır veya iptal edilir; böylece eski bir bağlantı iki kez ödenemez.

Test ve canlı modlar: her mod için ayrı özel anahtarlar ve ödeme sayfasında bir TEST MODE bildirimi. İadeler ve bildirimler her zaman, ödemenin yapıldığı modun anahtarını kullanır.

Sipariş sayfasından iadeler: siparişin Conekta payment bloğunda tam ve kısmi iadeler, Conekta'nın gerçekte tahsil ettiği tutara kadar. Tam iade siparişi Refunded durumuna alır.

Sipariş sayfasındaki Conekta bloğu: Conekta siparişi, tahsilat, durum, tutarlar, iade geçmişi ve modülün notları. API anahtarları veya müşteri iletişim bilgileri içermeyen isteğe bağlı günlük.

Gereksinimler

PrestaShop 8.0 ila 9.x, PHP 8.0 veya üzeri. Sepet para birimi MXN veya USD. Test ve canlı özel anahtarlara (Private Key) sahip bir Conekta hesabı ve Conekta panelinde bir webhook. vibefox.net üzerinden alınan bir VibeFox lisans anahtarı (alan adı başına bir anahtar).