VibeFox IntaSend for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: cURL eklentisi bulunan 8.0 veya üzeri. Modül, daha eski PHP sürümlerinde ya da cURL olmadan kurulmaz.

HTTPS: IntaSend, canlı ödemeler ve webhook'lar için HTTPS gerektirir. Ayarlar sayfası, canlı mod açıkken mağazanın HTTPS kullanmadığını gördüğünde sizi uyarır.

IntaSend hesabı: IntaSend hesabınızın genel anahtarına (ISPubKey_...) ve gizli anahtarına (ISSecretKey_...) ihtiyacınız var; bunlar sandbox, canlı veya ikisi için olabilir. Ayrıca IntaSend panelinde doğrulama ifadeli bir webhook gerekir (bkz. Yapılandırma). Genel anahtar ödeme sayfasını oluşturur. Gizli anahtar yalnızca ödeme durumunu IntaSend'e sormak için sunucunuzda kullanılır.

Mağaza para birimi: KES, USD, EUR, GBP, UGX, TZS, NGN, GHS, XAF veya XOF. Diğer para birimleri için ödeme yöntemi gizlenir.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek bir alan adında çalışır.

Kurulum

1. Back Office'te Modules > Module Manager bölümüne gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme bittiğinde Configure düğmesine tıklayın ya da daha sonra modül listesinde VibeFox IntaSend Pay Gateway öğesini bulup Configure düğmesine tıklayın.

3. VibeFox lisans anahtarınızı Configure sayfasının üstündeki lisans bloğunda License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. IntaSend sandbox ve/veya canlı anahtarlarınızı yapıştırın, IntaSend panelinde webhook'u ekleyin ve modüle aynı doğrulama ifadesini girin (bkz. Yapılandırma).

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Test mode açıkken bir ödeme deneyin, ardından gerçek ödemeleri kabul etmek için Test mode seçeneğini kapatın.

Kurulumda modül IntaSend payment on hold sipariş durumunu oluşturur. PrestaShop, tüm para birimleri, ülkeler ve müşteri grupları için yeni bir ödeme modülü sunar. Bunları Payment > Preferences bölümünden sınırlayabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox IntaSend Pay Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanların üstünde bir durum kutusu Test mode: IntaSend sandbox, no real money is charged. ya da Live mode: real payments are accepted. gösterir. Ayrıca geçerli modun anahtarları eksik ya da hatalıysa (bu durumda ödeme yöntemi ödeme sayfasında gizlenir), mağazanın varsayılan para birimi desteklenmiyorsa, webhook doğrulama ifadesi ayarlanmamışsa ve canlı mod HTTPS olmadan kullanılıyorsa sizi uyarır. Yapıştırılan anahtarlar kaydederken başındaki ve sonundaki boşluklardan arındırılır.

IntaSend

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: IntaSend (M-Pesa, card). Zorunlu.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: You will be redirected to IntaSend to pay securely with M-Pesa, card or another available method.

API anahtarları

Anahtarları IntaSend panelinde Settings > API Keys altından alın; sandbox paneli ve canlı panel için ayrı ayrı (bölümde ikisine de bağlantılar vardır). Test modu sandbox anahtarlarını ve sandbox API'sini, canlı mod ise canlı anahtarları ve canlı API'yi kullanır. Modül, genel anahtarın ISPubKey_ ile, gizli anahtarın ISSecretKey_ ile başladığını ve anahtarların geçerli moda ait olduğunu kontrol eder: sandbox anahtarları _test, canlı anahtarlar _live içerir. Değilse ödeme yöntemi gizlenir ve durum kutusu nedenini açıklar.

Test mode: IntaSend sandbox'ını kullanır, gerçek para çekilmez. Varsayılan: açık. Gerçek ödemeleri canlı anahtarlarla kabul etmek için kapatın. Test modu açıkken ödeme sayfası, ödeme yönteminin altında TEST MODE - IntaSend sandbox, no real money is charged. gösterir.

Sandbox publishable key: ISPubKey_test ile başlar. Bir ödeme sayfası oluşturulduğunda işletmenizi tanımlar.

Sandbox secret key: ISSecretKey_test ile başlar. Ödemeleri Payment Status API ile onaylamak için yalnızca sunucunuzda kullanılır.

Live publishable key: ISPubKey_live ile başlar.

Live secret key: ISSecretKey_live ile başlar. Ödemeleri onaylamak için yalnızca sunucunuzda kullanılır.

Kaydedilmiş gizli anahtarlar ve webhook doğrulama ifadesi bir daha 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.

Webhook

Webhook, müşteri mağazaya dönmese bile (tarayıcı kapatıldı, M-Pesa onayı daha sonra geldi) mağazanıza bir ödemenin yapıldığını bildirir. IntaSend panelinde, hem sandbox'ta hem canlıda, Webhooks bölümünü açın ve bu bölümdeki Webhook URL alanında gösterilen URL'yi ekleyin. Kolay URL'ler etkinken şuna benzer: https://your-shop/module/wcp_intasend_pay/webhook, bazen /en/ gibi bir dil kodu ile. URL'yi ayarların gösterdiği gibi birebir kopyalayın. Orada bir doğrulama ifadesi girin ve modüle de aynı ifadeyi girin. Sandbox ve canlı için tek bir doğrulama ifadesi kullanın.

Webhook challenge: IntaSend panelindeki ile aynı doğrulama ifadesi. Başka bir ifadeyle gelen webhook'lar reddedilir. Bu alan boşken webhook'lar işlenmez ve ödemeler yalnızca müşteri mağazaya döndüğünde onaylanır. Bu tür webhook'lar hata değil, Ignored yanıtı alır; böylece doğrulama ifadesini girmeden IntaSend webhook'u devre dışı bırakmaz.

Kayıtlı gizli bilgileri temizle: Sandbox secret key, Live secret key veya Webhook challenge seçeneğini işaretleyin ve kaldırmak için Save düğmesine tıklayın. Boş bir alan kayıtlı değeri korur.

Modül, IntaSend'in bildirdiği şu ödeme durumlarına tepki verir. Her seferinde bir şey değiştirmeden önce Payment Status API'den gerçek durumu sorgular:

COMPLETE: ödeme yapıldı. Tutar ve para birimi kontrolünden sonra sipariş oluşturulur.

FAILED or CANCELED: ödeme başarısız oldu. Sepetin son ödeme denemesi, IntaSend'in nedeniyle birlikte başarısız olarak işaretlenir. Sipariş oluşturulmaz ve sepet korunur.

PARTIAL: fatura kısmen ödendi. Sipariş IntaSend payment on hold durumunda oluşturulur.

PENDING, PROCESSING or RETRY: ödeme hâlâ devam ediyor. Son durum gelene kadar hiçbir şey değişmez.

Bu mağazanın ödeme sayfası işlemi olmayan bildirimler, örneğin aynı IntaSend hesabının ödeme bağlantıları ya da para gönderme olayları, Ignored yanıtı alır; böylece IntaSend webhook'u devre dışı bırakmaz.

Gelişmiş

Debug log: ödeme sayfası, dönüş ve webhook olaylarını modül klasöründeki logs/intasend_p_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Hatalar ve uyarılar her zaman kaydedilir. API anahtarları ve müşteri verileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

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

Delete data on uninstall: açıksa modül kaldırıldığında ağ geçidi ayarları ve günlük silinir. Siparişler için kaydedilmiş IntaSend referansları ödeme geçmişidir ve her zaman korunur. Varsayılan: kapalı.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak IntaSend (M-Pesa, card)) ve onaylar. Modül, sepet toplamı için sepet para biriminde bir IntaSend ödeme sayfası oluşturur ve müşteriyi IntaSend tarafından barındırılan ödeme sayfasına gönderir. Orada müşteri M-Pesa, kart ya da IntaSend hesabınızda etkin olan başka bir yöntemle öder. Müşterinin e-postası ile fatura adresinin adı, adresi, telefonu ve ülkesi, IntaSend'in alan kurallarına uyduklarında IntaSend'e iletilir. Boş ya da uygun olmayan alanlar atlanır. Bu noktada henüz bir sipariş yoktur.

Ödeme yapıldıktan sonra müşteri mağazanıza döner. Sipariş yalnızca IntaSend onayladığında ödenmiş olarak işaretlenir: modül, müşteri döndüğünde ve webhook geldiğinde Payment Status API'yi sorgular. Ardından sipariş oluşturulur ve müşteri standart sipariş onay sayfasını görür. Sipariş beklemeye alındıysa sayfa Your payment was received and your order is being reviewed. We will contact you if anything is needed. gösterir. Ödeme henüz onaylanmadıysa ya da IntaSend o anda ulaşılamıyorsa, Check again ve Back to checkout düğmeleriyle birlikte, Payment confirmation başlıklı bir sayfa Your payment is being confirmed by IntaSend (M-Pesa confirmations can take a minute). You will receive an e-mail as soon as it is confirmed. mesajını gösterir. Webhook, IntaSend ödemeyi onaylar onaylamaz siparişi oluşturur.

Ödeme başarısız olduysa müşteri, The payment was not successful. Please try again or choose another payment method. mesajıyla ödeme sayfasına döner (IntaSend'in nedeni verilmişse onunla birlikte). Müşteri ödeme yapmadan döndüyse mesaj şudur: The payment was not completed. Please try again or choose another payment method. Sepet korunur ve müşteri yeniden ödeme yapabilir. Her deneme kendi IntaSend referansını alır.

IntaSend ödemeyi başlatamazsa müşteri ödeme sayfasında kalır ve IntaSend could not start the payment: ile IntaSend'in verdiği nedeni ya da IntaSend is temporarily unavailable. Please try again in a moment or choose another payment method. mesajını görür. Ayrıntılar günlüğe yazılır. Toplamı sıfır olan bir sepet IntaSend ile ödenemez.

Webhook, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasından etkilenmez. Kolay URL'ler kapalıyken müşteri, IntaSend'in dönüş adresindeki bazı karakterleri kabul etmediği için mağazanın ana sayfası üzerinden geri döner.

Modül yalnızca tek seferlik ödemeleri kabul eder. İadeler mağazadan IntaSend'e gönderilmez; kayıtlı kart, abonelik ya da gömülü (açılır pencereli) ödeme formu yoktur. Aynı sepetin eski ödeme sayfası bağlantıları IntaSend'de iptal edilemez.

Siparişler

Sipariş durumları

No order yet: müşteri IntaSend'e yönlendirildi ve henüz ödeme yapmadı ya da IntaSend ödemeyi henüz onaylamadı. Yalnızca sepet vardır.

Payment accepted: ödeme onaylandı. Ödeme, IntaSend fatura kimliği işlem kimliği olarak kaydedilir ve bir notta fatura, IntaSend'deki ödeme yöntemi, tutar, mod (sandbox ya da canlı) ve onaylanma biçimi (webhook ya da müşteri dönüşü) gösterilir.

IntaSend payment on hold: IntaSend, sepet toplamından farklı bir tutar ya da para birimi, kısmi bir ödeme ya da sipariş iptal edildikten sonra gelen bir ödeme bildirdi. Not bunu açıklar ve IntaSend'in tahsil ettiği tutar sipariş para birimindeyse ödeme olarak kaydedilir. Ödemeyi IntaSend panelinde kontrol edin ve siparişi yerine getirin ya da ödemeyi iade edin. Doğru ödeme daha sonra gelirse sipariş Payment accepted durumuna geçer.

Zaten ödenmiş bir sipariş için ikinci bir ödeme gelirse sipariş değişmez. Bir not, bunun çift ödeme olması durumunda IntaSend panelinden iade etmenizi ister. İade edilmiş bir sipariş için gelen ödeme bir not ekler ve siparişi yeniden açmaz.

IntaSend ödeme bloğu

Sipariş sayfası, siparişin sepetinin her ödeme denemesini (tarih, referans, IntaSend ödeme sayfası, ortam, tutar, fatura ve sonuç; başarısızlık nedeniyle birlikte) ve Invoices processed bölümünü (fatura, IntaSend durumu, tutar ve sonuç) içeren bir IntaSend payment bloğu gösterir. Blok salt okunurdur.

İadeler

İadeler mağazadan IntaSend'e gönderilmez. Ödemeyi IntaSend panelinde iade edin ve iadeyi PrestaShop'ta elle kaydedin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınmış bir VibeFox lisans anahtarıyla çalışır. License — VibeFox IntaSend Pay Gateway lisans bloğu, Modules > Module Manager > VibeFox IntaSend Pay Gateway > Configure sayfasında, ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarın maskelenmiş halini, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve şu düğmeleri gösterir: 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. Bunların altında Product: presta-payment-intasend satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure izni olan çalışanlar değiştirebilir. Bloğun metinleri back office dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir; örneğin Key not found, This key belongs to another product, Domain limit reached ya da bir tarihle birlikte License expired on. Mağaza adresi değiştikten sonra ya da hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa modül son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan IntaSend, ö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. PrestaShop vitrini back office'e giriş yaptığınızı bilmez; bu nedenle ödeme yöntemi sizin için de gizlenir: modülü anahtarı satın almadan önce kurabilirsiniz, ancak ödeme sayfasında deneyemezsiniz. Modules > Module Manager bölümünde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır.

Bir lisansın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Back office'te çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir kez. Cron işi gerekmez. Modülü kaldırmak ya da sıfırlamak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

IntaSend ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve geçerli modun anahtarlarının doldurulmuş ve o moda ait olduğunu kontrol edin: test modunda sandbox anahtarları (_test içeren), canlı modda canlı anahtarlar (_live içeren). Sepet para birimi desteklenmelidir. Ayarlar sayfasının üstündeki durum kutusu neyin yanlış olduğunu gösterir. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşteri grubu için izinli olduğunu kontrol edin.

Ödeme gerçekleşti, ancak sipariş oluşturulmadı: M-Pesa onayları bir süre alabilir. Webhook, IntaSend son durumu bildirdiğinde siparişi oluşturur. IntaSend panelindeki webhook URL'sinin (kullandığınız mod olan sandbox veya canlı) Webhook URL alanında gösterilenle birebir aynı olduğunu ve oradaki doğrulama ifadesinin Webhook challenge ile aynı olduğunu kontrol edin. Müşteri mağazaya döndüğünde ya da Check again düğmesine tıkladığında da sipariş oluşturulur.

Webhook Ignored: webhook challenge not configured yanıtı veriyor: Webhook challenge boş. IntaSend panelindeki doğrulama ifadesini girin.

Webhook Invalid challenge yanıtı veriyor: IntaSend ve modüldeki doğrulama ifadeleri farklı ya da webhook'ta doğrulama ifadesi yok.

Webhook Verification unavailable, retry later ya da Busy, retry later yanıtı veriyor: IntaSend o anda ulaşılamıyordu, sepet başka bir istek tarafından onaylanıyordu ya da sipariş oluşturulamadı (örneğin modül devre dışı). IntaSend webhook'u yeniden dener. Neden günlükte yazılıdır.

Webhook Invoice not verified ya da Invoice does not match the reference yanıtı veriyor: IntaSend, bu faturanın sepete ait olduğunu doğrulamadı. Hiçbir şey değişmez.

Webhook URL'si tarayıcıda Method not allowed gösteriyor: bu normaldir. URL yalnızca IntaSend'den gelen istekleri kabul eder.

Sipariş IntaSend payment on hold durumunda: sipariş notlarını okuyun. Ödenen tutar ya da para birimi sepetten farklıydı, ödeme kısmiydi ya da sipariş iptal edildikten sonra geldi. Ödemeyi IntaSend panelinde kontrol edin.

Müşteri IntaSend'i seçerken bir hata görüyor: modül sayfasındaki Log alanına bakın (daha fazla ayrıntı için Debug log seçeneğini açın). Geçerli modun anahtarları hatalıysa müşteri IntaSend is not available at the moment. Please choose another payment method or contact the store. mesajını görür. Günlükte dönüş URL'sinin IntaSend'in kabul etmediği karakterler içerdiği yazıyorsa neden mağazanın adresidir.

Müşteri We could not match this payment to an order mesajını görüyor: dönüş bağlantısı değiştirilmiş ya da başka bir sepete ait. Müşteri ödeme yaptıysa webhook yine de siparişi oluşturur.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox IntaSend Pay Gateway yanındaki menüyü açın ve Uninstall seçeneğini seçin. Bu modülün lisans anahtarı ve lisans durumu her zaman kaldırılır. Delete data on uninstall açıksa ağ geçidi ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki yeniden kurulum için saklanır. Siparişlerin IntaSend ödeme denemeleri ve faturaları ile IntaSend payment on hold sipariş durumu her zaman korunur. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

IntaSend, ilgili sahibinin ticari markasıdır. Bu modül IntaSend ile bağlantılı değildir ve IntaSend tarafından onaylanmamıştır.