VibeFox Kushki for OpenCart

Genel bakış

VibeFox Kushki Payment, Ekvador ve Kolombiya'daki mağazalar için OpenCart 3 ve OpenCart 4'e Kushki üzerinden banka kartı ödemeleri ekler. Confirm Order adımında müşteri kartını, ödeme sayfanızın içinde gösterilen ancak Kushki tarafından sunulan barındırılan kart formuna girer. Form tek kullanımlık bir jeton döndürür ve mağazanız bu jetonu Kushki API'si üzerinden sunucu tarafında tahsil eder. Kart numaraları hiçbir zaman sitenize ulaşmaz. OpenCart siparişi ödemeden önce oluşturur, ancak sipariş yalnızca Kushki tahsilatı onayladıktan sonra bir durum alır; bu nedenle reddedilen veya terk edilen ödemeler, durumsuz siparişler (missing orders) olarak kalır.

USD veya COP ile tahsilat yapan ve kart verisiyle uğraşmadan kendi ödeme sayfasında kart formu isteyen mağazalar için uygundur. Eklenti yalnızca tek adımlı ödemeleri destekler. Kısmi iade, kayıtlı kart, abonelik, nakit veya banka havalesi (PSE) ödemesi, yönlendirmeli banka kartı ödemesi ile ayrı provizyon ve tahsilat (authorize and capture) desteği yoktur.

Temel özellikler

Kushki barındırılan kart formu: OpenCart ödeme sayfasının Confirm Order adımında Kushki'nin kart formu. Müşteri formdaki ödeme düğmesine bastığı anda ödeme gönderilir. Formda seçilen taksitler (diferido) tahsilata aktarılır.

Yalnızca Kushki onayladığında ödenmiş sayılır: sipariş durumu, Kushki tahsilatı bir fiş numarasıyla onayladıktan sonra ayarlanır. Kushki farklı bir tutar veya para birimi bildirirse sipariş bir not ile inceleme durumuna alınır. Ardından OpenCart normal sipariş e-postalarını gönderir.

Vergi IVA olarak: tutar ve para birimi siparişten alınır. Siparişin vergisi Kushki'ye IVA olarak bildirilir, vergisiz kalemler ayrı olarak bildirilir.

İmzalı webhook'lar: isteğe bağlı webhook'lar, API yanıtı kaybolan bir ödemeyi onaylar ve Kushki Console'da yapılan iptal (void) ve iadeler için notlar ekler. Geçerli imzası olmayan bildirimler reddedilir.

Çift tahsilat yok: sepet bazında bir kilit, çift tıklama veya ikinci bir sekmede çift tahsilatı önler; zaten ödenmiş bir sepet bir daha asla tahsil edilmez. Tekrarlanan webhook'lar bir ödemeyi asla iki kez uygulamaz.

Test ve canlı modlar: her mod için ayrı Merchant ID'ler ve webhook imzaları. İadeler her zaman ödemenin yapıldığı moda gider.

Sipariş sayfasından tam iade: siparişin VibeFox Kushki Payment sekmesi, Kushki'nin tahsil ettiği tutarın tamamını iade eder ve fiş numarasını, referansı, iade geçmişini ve Kushki notlarını gösterir.

Kendi sipariş durumlarınız ve OpenCart koşulları: ödenmiş bir sipariş, inceleme altındaki bir ödeme, başarısız bir ödeme, iptal edilmiş ve iade edilmiş bir sipariş için OpenCart durumunu seçin. Coğrafi bölge, minimum sipariş tutarı ve sıralama. Merchant ID'leri, kart jetonları veya müşteri e-postaları olmadan günlük (log) tutma.

Gereksinimler

OpenCart 3.0.x (3.0.5.0 üzerinde test edildi) veya OpenCart 4.0.2 ve üzeri (4.1.0.3 üzerinde test edildi), PHP 8.0 veya üzeri. Tek bir indirme iki sürüm için de paketleri içerir. Sipariş para birimi USD veya COP. Test ve canlı için Public ve Private Merchant ID'leri olan bir Kushki hesabı; canlı ödemeler için HTTPS. vibefox.net üzerinden alınan bir VibeFox lisans anahtarı (alan adı başına bir anahtar).