VibeFox Kushki for OpenCart — Yardım

Gereksinimler

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

PHP: 8.0 veya üzeri.

Para birimi: USD (Ekvador) veya COP (Kolombiya). Diğer para birimlerindeki siparişler için ödeme yöntemi ödeme sayfasında gösterilmez.

HTTPS: Kushki, canlı modda ödeme sayfasının HTTPS üzerinden sunulmasını gerektirir.

Kushki hesabı: Kushki test (UAT) hesabınızın ve canlı hesabınızın Public ve Private Merchant ID değerlerine ihtiyacınız var. Bunlar Kushki Console'da Developers > Credentials altındadır. İsteğe bağlı webhook için her hesabın webhook imza anahtarına da ihtiyacınız olur (bkz. Yapılandırma).

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek 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. Arşivde README.txt, OpenCart 3 paketi wcp_kushki_payment-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_kushki_payment.ocmod.zip bulunur. Yalnızca OpenCart sürümünüz için olan 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_kushki_payment-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişiklikleri yoktur, bu yüzden 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 Payments türünü seçin. VibeFox Kushki Payment 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 iznine sahip olması gerekir.

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

4. Test Public ve Private Merchant ID değerlerini girin ve Test mode seçeneğini açık bırakın. İsteğe bağlı olarak Kushki Console'da webhook'u yapılandırın ve imza anahtarını yapıştırın (bkz. Yapılandırma).

5. Enable / Disable seçeneğini açın, Save düğmesine tıklayın ve bir deneme siparişi verin. Hazır olduğunuzda canlı Merchant ID değerlerini (ve canlı webhook imzasını) girin ve Test mode seçeneğini kapatın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_kushki_payment.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 uzantı kodunu dosya adından alır ve adı değiştirilmiş bir paket çalışmaz.

2. Paket, aynı sayfada kurulu uzantıların 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 Payments türünü seçin. VibeFox Kushki Payment 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ı, Merchant ID değerlerini ve webhook'u OpenCart 3 için 3 ila 5. adımlardaki gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca webhook URL'si farklıdır (bkz. 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 Kushki Payment > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üzerinde sayfa, ödeme yöntemi açık olduğu halde geçerli modun Merchant ID değerleri eksikse (bu durumda ödeme yöntemi ödeme sayfasında gizlenir), mağazanızın varsayılan para birimi USD veya COP değilse, canlı mod HTTPS olmadan kullanılıyorsa (OpenCart 4'te mağaza adresi http:// ile başlıyorsa) ve geçerli modda webhook imza anahtarı yoksa sizi uyarır. Test modu açık olduğunda Test mode is on: the Kushki test environment is used, no real money is charged. mesajını gösterir. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Kaydetme sırasında Title boş olamaz ve 128 karakteri geçemez, Sort Order tam sayı olmalıdır (negatif sayılara izin verilir), Total 0 veya daha büyük bir sayı olmalıdır ve her sipariş durumu mevcut olmalıdır. Bir alan hatalıysa hiçbir şey kaydedilmez ve sayfa alanı belirtir. Kaydetme sırasında kimliklerin etrafındaki boşluklar silinir.

Kushki

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Ayrıca siparişte kaydedilen ödeme yöntemi adıdır. Varsayılan: Credit / debit card (Kushki). Zorunlu, en fazla 128 karakter.

Description: Confirm Order adımında kart formunun üzerinde gösterilen metin. Varsayılan: Pay securely with your card. Card details are entered in a Kushki form and never stored on this site.

Sort Order: Kushki'nin ödeme sayfasındaki ödeme yöntemleri arasındaki konumu. Boş bırakın veya bir tam sayı girin.

Geo Zone: Kushki'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 altında ayarlanır.

Total: Kushki'nin sunulması için siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası tutarı. Her tutar için Kushki sunmak üzere boş bırakın.

API kimlik bilgileri

Public ve Private Merchant ID değerlerini Kushki Console'dan kopyalayın (Developers > Credentials; sayfa Console'a bağlantı verir). Test (UAT) ve canlı hesapların kimlikleri farklıdır. Test modu yalnızca test kimliklerini, canlı mod ise yalnızca canlı kimlikleri kullanır.

Test mode: Kushki test (UAT) ortamını kullanır: test Merchant ID'leri, test kart formu ve test API'si birlikte kullanılır. Gerçek para çekilmez ve ödeme sayfasında bir TEST MODE rozeti gösterilir. Varsayılan: açık. Gerçek ödemeleri kabul etmek için kapatın. Geri ödemeler her zaman ödemenin yapıldığı ortama gider.

Test Public Merchant ID: Kushki test hesabınızın Public Merchant ID değeri. Kart formunu yükler.

Test Private Merchant ID: Kushki test hesabınızın Private Merchant ID değeri. Sunucuda tahsilat ve geri ödemeler için kullanılır.

Live Public Merchant ID: Kushki canlı hesabınızın Public Merchant ID değeri.

Live Private Merchant ID: Kushki canlı hesabınızın Private Merchant ID değeri. Gizli tutun.

Kaydedilmiş Private Merchant ID değerleri ve webhook imzaları 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 değeri kaldırmak için alanın altındaki Clear the saved value on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Webhook (önerilir)

Ödemeler Kushki API yanıtıyla hemen onaylanır, bu yüzden webhook zorunlu değildir. Yanıtı kaybolan bir ödemeyi (örneğin zaman aşımı nedeniyle) onaylar ve Kushki Console'da yapılan iptalleri, geri ödemeleri ve chargeback'leri bildirir. Kushki Console'da (Webhooks) bu bölümdeki Webhook URL alanında gösterilen URL'yi ekleyin. OpenCart 3'te şuna benzer: https://your-store/index.php?route=extension/payment/wcp_kushki_payment/webhook, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_kushki_payment/payment/wcp_kushki_payment.webhook şeklindedir ve OpenCart kurulumunuzun mağaza adresinden oluşturulur. URL'yi ayarların gösterdiği gibi tam olarak kopyalayın. Bunu hem test hesabı hem de canlı hesap için yapın.

Eklenti şu kart bildirimlerini işler:

Test webhook signature: Kushki test hesabının webhook imza anahtarı (Console > Webhooks).

Live webhook signature: Kushki canlı hesabının webhook imza anahtarı.

Geçerli imzası olmayan webhook'lar reddedilir. Bir bildirim, ödemenin yapıldığı modun anahtarıyla imzalanmalıdır; bu nedenle test bildirimi hiçbir zaman canlı bir ödemeyi onaylamaz. İmza anahtarı yoksa tüm webhook bildirimleri reddedilir, ancak ödemeler çalışmaya devam eder, çünkü API yanıtıyla onaylanırlar.

Siparişler

OpenCart, siparişi Confirm Order adımında durumsuz (eksik sipariş) olarak oluşturur. Sipariş, Kushki kart tahsilatını onayladıktan sonra bir durum alır. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: Kushki, tahsilatı sipariş tutarı ve para birimi için bir fiş numarasıyla onayladı. Varsayılan: İşleniyor.

On Hold (Review) Status: Kushki, tahsilatı fiş numarası olmadan onayladı veya başka bir tutar ya da para birimi bildirdi. Bir not nedenini açıklar; sevkiyattan önce ödemeyi Kushki Console'da kontrol edin. Varsayılan: Ödeme bekliyor, çünkü OpenCart'ta Beklemede durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturup burada seçebilirsiniz.

Failed Status: inceleme durumundaki ve tahsilatı daha sonra Kushki tarafından reddedildi olarak bildirilen bir sipariş (webhook). Varsayılan: Başarısız.

Canceled Status: bu durumdaki siparişler (veya iade edilmiş durumdaki siparişler) geç gelen bir webhook ile asla yeniden açılmaz. Varsayılan: İptal edildi.

Refunded Status: ödeme, sipariş sekmesinden geri ödendikten sonra ayarlanır. Varsayılan: İade edildi.

Gelişmiş

Debug log: Kushki isteklerini ve webhook'ları OpenCart log klasöründeki (storage/logs) kushki_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Uyarılar ve hatalar her zaman kaydedilir. Günlükler hiçbir zaman Merchant ID, kart token'ları veya müşteri e-postalarını içermez. Varsayılan: kapalı.

Log: günlüğün boyutunu ve en son girişlerini gösterir. Temizlemek için Clear log düğmesine tıklayın.

Delete data on uninstall: açıksa eklentiyi kaldırmak ayarları ve günlüğü siler. Kushki ödeme kayıtları (tahsilatlar ve geri ödemeler) her zaman korunur; böylece eski siparişler yeniden kurulumdan sonra da geri ödenebilir. Varsayılan: kapalı.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Private Merchant ID değerleri ve webhook imzaları 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. Kaydedilmiş gizli bilgiler korunur.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit / debit card (Kushki)). OpenCart siparişi, hâlâ durumsuz olarak Confirm Order adımında oluşturur. Orada müşteri açıklamanızı ve sipariş para biriminde sipariş toplamıyla birlikte Kushki kart formunu görür. Müşteri kartı girer, Kushki formu taksit sunuyorsa taksit seçer ve Kushki formunun içindeki ödeme düğmesine basar. Ödeme, formun altındaki notta yazdığı gibi otomatik olarak gönderilir: Enter your card in the secure Kushki form above and press its pay button — the payment is sent automatically. Müşteri bunun yerine OpenCart'ın Confirm Order düğmesine tıklarsa Please enter your card details in the Kushki form and press its pay button. mesajı gösterilir.

OpenCart 4'te müşteri, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde ödeme yöntemini seçer. Kushki kart formu bu durumda ödeme sayfasının altındaki sipariş onay bloğunda, Confirm Order düğmesinin üstünde görünür ve OpenCart bu bloğu her yeniden yüklediğinde geçerli sipariş toplamı için yeniden oluşturulur.

Mağazanız daha sonra kartı sunucuda tahsil eder. Sipariş yalnızca Kushki bir fiş numarasıyla onayladıktan sonra ödenmiş olarak işaretlenir. Ardından sipariş, OpenCart'ın standart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle durum alır, sepet boşaltılır ve müşteri OpenCart sipariş başarı sayfasını Your card payment has been received. ifadesiyle görür. Kushki'nin bildirdiği tutar ve para birimi siparişle karşılaştırılır. İnceleme durumundaki bir sipariş Your payment is being reviewed. We will update your order as soon as the review is complete. mesajını gösterir.

Kart reddedilirse sipariş durumsuz kalır, müşteri Your payment was declined ve Kushki'nin bildirdiği nedenle Confirm Order adımında kalır ve yeniden yüklenen formda başka bir kart deneyebilir. Ağ, anahtar veya sunucu sorunlarında müşteri The payment could not be processed right now. Please try again in a moment or choose another payment method. mesajını görür. Teknik neden günlüğe ve sipariş notlarına yazılır. Bir ödeme işlenirken ikinci kez tıklanırsa A payment for this order is already being processed. Please wait a moment and check your order status. mesajı gösterilir.

OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise siparişi tutar ve günceller. Her iki durumda da bir sepet yalnızca bir kez ödenir: zaten ödenmiş bir sepet veya siparişinin henüz durumu olmayan onaylanmış bir tahsilat hiçbir zaman yeniden tahsil edilmez ve müşteri başarı sayfasını görür. Kushki yanıtı kaybolursa (örneğin zaman aşımı nedeniyle) müşteri genel mesajı görür, ancak tahsilat denemesi korunur. İmzalı webhook onaylanmış tahsilatı bildirdiğinde sipariş durumunu alır. Herhangi bir webhook gelmeden müşteri tekrar öderse bu yeni bir tahsilattır; ilk tahsilatın geç onaylanması yalnızca olası çift tahsilat hakkında bir not ekler.

OpenCart 4 siparişi, başarı sayfası gösterilene kadar ödeme sayfasında tutar. Bu arada sipariş kapatıldıysa (ödeme yapılmadan kapatıldıysa, örneğin inceleme altındaki tahsilat sonradan reddedildiyse veya siz iptal ettiyseniz), ya da sipariş zaten önceki bir sepet için ödenmişse ve müşteri o zamandan beri sepeti değiştirdiyse, müşteri ödeme sırasında ödeme sayfasına geri gönderilir ve bir sonraki Confirm Order yeni bir sipariş oluşturur. Ödeme sayfasının üstünde müşteri, sipariş kapatıldıysa Your previous order is closed (declined, cancelled or refunded by the store). Please confirm the order again: the cart will be paid with a new order. veya önceki bir sepet için ödenmişse Your previous order is already paid for other cart contents. Please confirm the order again: the current cart will be paid with a new order. mesajını görür. Sepetteki bir değişiklik, yeni adet dahil, kendi ödemesi gereken yeni bir sepet sayılır.

Webhook, mağaza bakım modundayken de çalışır: OpenCart 3 ödeme eklentilerinden gelen isteklere izin verir, OpenCart 4'te ise eklenti bunun için bir başlangıç eylemi ekler. 3-D Secure, sahteciliğe karşı kurallar ve sunulan taksitler Kushki Console'da ayarlanır.

Eklenti yalnızca tek adımlı kart ödemelerini destekler. Kısmi geri ödeme, kayıtlı kart veya abonelik yoktur; nakit, havale (PSE) veya banka kartı yönlendirmeli ödemeler yoktur; ayrı yetkilendirme ve tahsilat da yoktur.

Siparişler ve geri ödemeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri ödeme yapmadı, kart reddedildi veya Kushki yanıtı kayboldu ve webhook henüz gelmedi. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Order Status After Payment (varsayılan İşleniyor): Kushki tahsilatı onayladı (API yanıtıyla veya webhook ile). Bir not modu, tutarı, Kushki fiş numarasını ve referansı gösterir.

On Hold (Review) Status (varsayılan Ödeme bekliyor): Kushki fiş numarası olmadan başarı bildirdi veya siparişten farklı bir tutar ya da para birimi bildirdi. Not bunu açıklar. Kushki Console'da işlemi kontrol edin ve siparişi tamamlayın veya ödemeyi geri ödeyin. Fiş numarası ve eşleşen tutarla sonradan gelen imzalı bir onay siparişi Order Status After Payment durumuna geçirir.

Failed Status (varsayılan Başarısız): webhook, inceleme durumundaki bir siparişin tahsilatının reddedildiğini bildirdi.

Refunded Status (varsayılan İade edildi): ödeme eklenti üzerinden geri ödendi.

Kushki, zaten ödenmiş, iptal edilmiş veya iade edilmiş bir sipariş için başka bir onaylanmış tahsilat bildirirse sipariş değişmez. Bir not, çift tahsilatı kontrol etmenizi ve bunu Kushki Console'da geri ödemenizi ister. Canlı bir ödeme için test ortamından gelen bir webhook (veya tersi) bir notla birlikte yok sayılır.

Notlar, müşterinin görmediği sipariş History kayıtlarıdır.

VibeFox Kushki Payment sekmesi

Sales > Orders bölümünde Kushki ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında, VibeFox Kushki Payment sekmesi Ticket number (test ödemeleri için TEST etiketiyle), Transaction reference, Environment, Result, Charged / order amount tutarlarını, geri ödeme formunu, geri ödeme geçmişini ve siparişin Kushki notes kayıtlarını gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

Geri ödemeler

Kushki tüm tahsilatı geri öder, bu yüzden yalnızca tam geri ödemeler mümkündür. VibeFox Kushki Payment sekmesinde, Kushki'nin tahsil ettiği Amount doldurulur. İsterseniz bir Reason (optional) girin, Refund via Kushki düğmesine tıklayın ve ardından Refund the full payment through Kushki? This cannot be undone. sorusunu onaylayın. Eklentiyi değiştirme izniniz olmalıdır (System > Users > User Groups altında ayarlanır). Diğer tutarlar için eklenti Kushki refunds the full payment only. Enter the full charged amount mesajını tutarla birlikte gösterir ve hiçbir şey gönderilmez. Geri ödeme, Kushki'nin tahsil ettiği tutar ve para biriminde yapılır; bu nedenle tutar uyuşmazlığından sonra müşteri sipariş toplamını değil, gerçekte tahsil edilen tutarı geri alır. Bir ödeme yalnızca bir kez geri ödenebilir.

Geri ödeme, ödemenin yapıldığı modda (test veya canlı) gönderilir; bu yüzden o modun Private Merchant ID değeri ayarlanmış olmalıdır. Kushki geri ödemeyi kabul etmezse sekme, Kushki kodu ve mesajıyla birlikte Kushki refund failed gösterir ve hiçbir geri ödeme kaydedilmez. Başarılı bir geri ödeme, geri ödeme geçmişine ve Kushki geri ödeme fişiyle birlikte notlara eklenir; sipariş müşteriye bildirilmeden ve manuel durum değişikliğinde olduğu gibi ürünler stoğa geri eklenmeden Refunded Status durumuna geçer. Geri ödemeler, fiş numarası olan onaylanmış bir Kushki tahsilatı gerektirir.

Sales > Returns bölümündeki ürün iadeleri Kushki üzerinden para geri göndermez. Kushki Console'da yapılan iptaller ve geri ödemeler webhook ile gelir ve notlara eklenir. Sipariş durumu otomatik olarak değişmez.

Lisans anahtarı

Eklenti, vibefox.net adresinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Kushki Payment lisans bloğu, Extensions > Extensions > Payments > VibeFox Kushki Payment > 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 Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: opencart-payment-kushki 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 izni olan yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini bildirir, ö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 düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar tek 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 Kushki, ö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ıdan giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada hâlâ (unlicensed — visible to admins only) işaretiyle görür; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme yoktur: mağaza yönetici girişini görmez, bu nedenle etkin anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma belirir. 7 gün gizlemek için × ile kapatın. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır ve geri ödemeler ç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 Dashboard sayfasını veya Edit sayfasını açtığınızda otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Kushki ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu ve geçerli modda her iki Merchant ID değerinin de bulunduğunu kontrol edin: test modunda test kimlikleri, canlı modda canlı kimlikler. Ayarlar sayfası kimlikler eksik olduğunda uyarı gösterir. Sipariş para biriminin USD veya COP olduğunu, ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total değerine ulaştığını kontrol edin.

Ödeme başarılı oldu, ancak sipariş durumsuz kaldı: Kushki API yanıtı, örneğin zaman aşımı nedeniyle kaybolmuş. Webhook bu tür ödemeleri onaylar. Kushki Console'da webhook URL'sinin Webhook URL altında gösterilenle tam olarak aynı olduğunu, kullandığınız modun hesabı için geçerli olduğunu ve o hesabın imza anahtarının ilgili alanda (Test webhook signature veya Live webhook signature) bulunduğunu kontrol edin. Ödenen tutar ve para birimi olmadan onaylanmış bir tahsilat siparişi On Hold (Review) Status durumuna alır.

Webhook, Webhook signature not configured yanıtı veriyor: hiçbir webhook imzası ayarlanmamış. İmza anahtarını ayarlara yapıştırın.

Webhook, Invalid signature yanıtı veriyor: imza anahtarı başka bir hesaba veya moda ait ya da bildirim yolda değiştirilmiş.

Webhook, Order mismatch yanıtı veriyor: bildirim bu siparişin bir tahsilat denemesine ait değil (yanlış deneme anahtarı veya işlem). Hiçbir şey değişmez.

Webhook, Busy, retry later yanıtı veriyor: sipariş aynı anda başka bir istek tarafından işleniyordu veya sipariş durumu ayarlanamadı. Kushki bildirimi yeniden gönderebilir. Hatalar her zaman günlüğe yazılır.

Webhook URL'si tarayıcıda yalnızca POST gösteriyor: bu normaldir. URL yalnızca Kushki'den gelen bildirimleri kabul eder.

Kart formu yüklenmiyor: müşteri The Kushki card form could not be loaded. Please reload the page or choose another payment method. mesajını görür. Geçerli modun Public Merchant ID değerini kontrol edin.

Müşteri This payment option is not available in this store. Please pay by card.: mesajını görüyor: Kushki formunda kart olmayan bir ödeme seçeneği seçildi. Eklenti yalnızca kartlardan tahsilat yapar.

Müşteri ödeme yaparken bir hata görüyor: Debug log seçeneğini açın ve eklenti sayfasındaki Log alanına bakın. This payment method is not available. Please reload the checkout page. mesajı, ödeme sayfası oturumunun artık siparişle eşleşmediği veya bu arada ödeme yönteminin kapatıldığı anlamına gelir: müşterinin ödeme sayfasını yeniden yüklemesi gerekir. Yanlış veya eksik bir Private Merchant ID, ödemenin işlenemediğine dair genel mesajı verir.

Müşteri Your payment was received, but the order could not be completed automatically: mesajını görüyor: Kushki tahsilatı onayladı, ancak OpenCart sipariş durumunu ayarlayamadı. Günlük nedeni gösterir. Aynı sepetin bir sonraki ödeme denemesi, yeni bir tahsilat yapmadan durumu ayarlar.

Geri ödeme mod hakkında bir mesajla başarısız oluyor: ödeme test veya canlı modda yapıldı ve o modun Private Merchant ID değeri ayarlanmamış. Girin ve tekrar deneyin.

Sekmede geri ödeme formu yok: sekme nedenini gösterir: ödeme zaten geri ödenmiş, siparişin Kushki fiş numarası yok (No Kushki ticket number found for this order — refund it in the Kushki Console.), kullanıcı grubunuzun eklentiyi değiştirme izni yok veya ödemenin modunun Private Merchant ID değeri ayarlanmamış.

Kaldırma

Extensions > Extensions bölümüne gidin, Payments türünü seçin ve VibeFox Kushki Payment 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ılanlarına döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te ayrıca olayları, bu arada sipariş durumuna dair mesajı gösteren olayı ve bakım modunda webhook'u geçiren başlangıç eylemi de). Delete data on uninstall açıksa diğer ayarlar (başlık, açıklama, test modu, Merchant ID değerleri, webhook imzaları, günlük kaydı) ve günlük kaldırılır. Kapalıysa sonraki bir yeniden kurulum için saklanırlar. Kushki ödeme kayıtları (tahsilatlar ve geri ödemeler) her zaman korunur; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da geri ödenebilir. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te eklentinin dosyalarını da silmek için, kaldırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu uzantılar listesinde VibeFox Kushki Payment yanındaki Uninstall düğmesine (turuncu − düğmesi) ve ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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