VibeFox IntaSend for WooCommerce — Yardım

Gereksinimler

WordPress: 6.2 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin. WooCommerce olmadan eklenti etkinleştirilmez.

PHP: 8.0 veya üzeri.

HTTPS: IntaSend, canlı ödemeler ve webhook'lar için HTTPS ister. Canlı mod açıksa ve mağaza adresi HTTPS değilse ayarlar sayfası 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ı ya da her 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, ödeme durumunu IntaSend'den sorgulamak için yalnızca sunucunuzda kullanılır.

Mağaza para birimi: KES, USD, EUR, GBP, UGX, TZS, NGN, GHS, XAF veya XOF. Diğer para birimlerinde ö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. WordPress'te Plugins > Add New > Upload Plugin bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_intasend_pay klasörünü FTP ile /wp-content/plugins/ klasörüne yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Payments > IntaSend > Manage, ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

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

6. Enable/Disable seçeneğini açın. Test mode açıkken bir ödeme deneyin, ardından gerçek ödemeleri kabul etmek için Test mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > IntaSend. 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. Geçerli modun anahtarları eksik ya da hatalıysa (ödeme yöntemi ödeme sayfasında gizlenir), mağaza para birimi desteklenmiyorsa, webhook doğrulama ifadesi ayarlanmamışsa ve canlı mod HTTPS olmadan kullanılıyorsa da uyarır. Ödeme yöntemleri listesinde, geçerli modun anahtarları doğru olana kadar IntaSend "kurulum gerekli" olarak işaretlenir. Yapıştırılan anahtarlar kaydedilirken boşluklardan arındırılır.

Genel

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

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

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 bölümünden alın; sandbox paneli ve canlı panel için ayrı ayrı. Test modu sandbox anahtarlarını ve sandbox API'sini, canlı mod ise canlı anahtarları ve canlı API'yi kullanır. Eklenti, 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: Use the IntaSend sandbox (no real money is charged). Varsayılan: açık. Gerçek ödemeleri canlı anahtarlarla kabul etmek için işaretini kaldırın. Test modu açıkken ödeme sayfasında ödeme yönteminin altında TEST MODE - IntaSend sandbox, no real money is charged. görünür.

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

Sandbox secret key: ISSecretKey_test ile başlar. Yalnızca sunucunuzda, ödemeleri Payment Status API ile doğrulamak için kullanılır.

Live publishable key: ISPubKey_live ile başlar.

Live secret key: ISSecretKey_live ile başlar. Yalnızca sunucunuzda ödemeleri doğrulamak için kullanılır.

Webhook

Webhook, müşteri mağazaya geri dönmese bile (tarayıcı kapatıldı, M-Pesa daha sonra onayladı) mağazanıza bir ödemenin yapıldığını bildirir. IntaSend panelinde, sandbox ve canlı için Webhooks bölümünü açın ve ayarların bu bölümünde gösterilen URL'yi ekleyin. Şöyle görünür: https://your-site/wc-api/intasend_pay/. Orada bir doğrulama ifadesi girin ve aynı ifadeyi eklentiye girin. Sandbox ve canlı için tek bir doğrulama ifadesi kullanın.

Webhook challenge: IntaSend panelindekiyle aynı doğrulama ifadesi. Farklı ifadeli webhook'lar reddedilir. Bu alan boş olduğu sürece webhook'lar işlenmez ve ödemeler yalnızca müşteri mağazaya döndüğünde onaylanır. Bu webhook'lar hata değil, Ignored yanıtı alır; böylece ifadeyi girmeden IntaSend webhook'u devre dışı bırakmaz.

Eklenti, IntaSend'in bildirdiği şu ödeme durumlarına tepki verir. Siparişi değiştirmeden önce her seferinde Payment Status API'den gerçek durumu sorgular:

COMPLETE: ödeme yapıldı. Tutar ve para birimi kontrolünden sonra sipariş ödenmiş olarak işaretlenir.

FAILED or CANCELED: ödeme başarısız oldu. Sipariş hâlâ bu ödeme denemesini bekliyorsa "Başarısız" durumuna geçer.

PARTIAL: fatura kısmen ödendi. Sipariş beklemeye alınır.

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

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

Gelişmiş

Debug log: Log checkout, return and webhook events seçeneği, WooCommerce > Status > Logs sayfasında, kaynak wcp_intasend_pay. Hatalar her zaman kaydedilir. API anahtarları ve müşteri verileri asla kaydedilmez. Varsayılan: kapalı.

Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted. Siparişlerde saklanan IntaSend referansları ödeme geçmişidir ve her zaman korunur. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak IntaSend (M-Pesa, card)) ve siparişi verir. Eklenti, sipariş toplamı için sipariş para biriminde bir IntaSend ödeme sayfası oluşturur ve müşteriyi IntaSend tarafından barındırılan ödeme sayfasına yönlendirir. Orada müşteri M-Pesa, kart ya da IntaSend hesabınızda etkin olan başka bir yöntemle öder. Fatura e-postası, ad, adres, telefon ve ülke, IntaSend'in alan kurallarına uyduğunda IntaSend'e iletilir. Boş ya da uygun olmayan alanlar atlanır.

Ödemeden sonra müşteri mağazanıza döner. Sipariş, yalnızca IntaSend onayladığında ödenmiş olarak işaretlenir: eklenti, müşteri döndüğünde ve webhook geldiğinde Payment Status API'yi sorgular. Ödeme henüz onaylanmamışsa sipariş alındı sayfasında 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ı gösterilir. Sipariş beklemeye alındıysa Your payment was received and your order is being reviewed. We will contact you if anything is needed. gösterilir.

Ödeme başarısız olduysa ya da müşteri ödeme yapmadan dönmüşse, müşteri The payment was not successful. Please try again or choose another payment method. (varsa IntaSend'in nedeniyle) ya da The payment was not completed. Please try again or choose another payment method. mesajıyla ödeme sayfasına (ya da Pay for order sayfasına) döner. Müşteri siparişi yeniden ödeyebilir. Her deneme kendi IntaSend referansını alır.

IntaSend ödemeyi başlatamazsa müşteri IntaSend could not start the payment: ve IntaSend'in nedenini 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.

Ödeme yöntemi klasik ödeme sayfasında, Checkout bloğunda ve Pay for order sayfasında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

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

Siparişler

Sipariş durumları

Pending payment: müşteri IntaSend'e yönlendirildi ve henüz ödeme yapmadı ya da IntaSend ödemeyi henüz onaylamadı.

Processing or Completed: ödeme onaylandı. WooCommerce, ödenmiş bir sipariş için olağan durumu ayarlar. Sipariş notu IntaSend faturasını, IntaSend'deki ödeme yöntemini, tutarı, modu (sandbox ya da canlı) ve onaylanma şeklini (webhook ya da müşterinin dönüşü) gösterir. İşlem kimliği IntaSend fatura kimliğidir.

On hold: IntaSend, sipariş toplamından farklı bir tutar ya da para birimi, kısmi bir ödeme ya da sipariş iptal edildikten sonra gelen bir ödeme bildirdi. Sipariş notu bunu açıklar. Ödemeyi IntaSend panelinde kontrol edin ve siparişi tamamlayın ya da ödemeyi iade edin.

Failed: son ödeme denemesi başarısız oldu. Not, IntaSend'in nedenini gösterir. Müşteri yeniden deneyebilir.

Zaten ödenmiş bir sipariş için ikinci bir ödeme gelirse sipariş bir daha değiştirilmez. Yinelenen bir ödemeyse bir not, bunu IntaSend panelinde iade etmenizi ister. İade edilmiş bir sipariş için gelen ödeme bir not ekler ve siparişi yeniden açmaz.

İadeler

İadeler WooCommerce'den IntaSend'e gönderilmez. Ödemeyi IntaSend panelinde iade edin ve iadeyi WooCommerce'de elle kaydedin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu, WooCommerce > Settings > Payments > IntaSend sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu gösterir; örneğin lisansın hangi tarihe kadar etkin olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar tek bir alan adında çalışır. Anahtarı bir siteden kaldırmak alan adı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan IntaSend müşterilere ödeme sayfasında 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. Oturum açmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma çıkar. Mevcut siparişler etkilenmez: başlatılmış ödemeler yine onaylanır.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, arka planda otomatik olarak yeniden kontrol edilir.

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). Mağaza para birimi desteklenmelidir. Ayarlar sayfasının üstündeki durum kutusu sorunu gösterir.

Ödeme yapıldı ama sipariş Pending payment durumunda kalıyor: M-Pesa onayları bir süre alabilir. Webhook, IntaSend son durumu bildirdiğinde siparişi onaylar. IntaSend panelindeki webhook URL'sinin (sandbox ya da canlı, kullandığınız mod) ayarlarda gösterilenle birebir aynı olduğunu ve oradaki doğrulama ifadesinin Webhook challenge ile aynı olduğunu kontrol edin.

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'deki ve eklentideki doğrulama ifadeleri farklı.

Webhook Verification unavailable, retry later ya da Busy, retry later yanıtı veriyor: IntaSend o anda ulaşılamadı ya da sipariş başka bir istek tarafından onaylanıyordu. IntaSend webhook'u yeniden dener.

Webhook Invoice not verified ya da Invoice does not match the reference yanıtı veriyor: IntaSend, bu faturanın siparişe ait olduğunu doğrulamadı. Sipariş değiştirilmez.

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

Müşteri sipariş verirken hata görüyor: Debug log seçeneğini açın ve WooCommerce > Status > Logs sayfasında, kaynak wcp_intasend_pay olan kayda bakın. Sipariş toplamı sıfırdan büyük olmalıdır. Günlük, dönüş URL'sinde IntaSend'in kabul etmediği karakterler olduğunu söylüyorsa neden mağaza adresi ya da içindeki bir dil parametresidir.

Lisans bloğu hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa vibefox.net hesabınızda bir hak serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse, anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Gateway ayarları ve günlükler yalnızca Delete data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için kalırlar. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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