VibeFox Stripe for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül, eski PHP sürümlerine kurulmayı reddeder.

Stripe hesabı: Stripe hesabınızın gizli API anahtarlarına ve Stripe Dashboard'da bir webhook uç noktasına ihtiyacınız var (bkz. Yapılandırma). Yalnızca gizli anahtarlar ve webhook imza gizli anahtarları kullanılır. Yayınlanabilir anahtarlar (pk_...) gerekli değildir, çünkü Stripe Checkout Stripe tarafından barındırılan bir sayfadır.

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 veya daha sonra modül listesinde VibeFox Stripe Gateway öğesini bulup Configure düğmesine tıklayın.

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

4. Stripe gizli anahtarlarınızı yapıştırın, Stripe Dashboard'da webhook'u ayarlayın ve imza gizli anahtarlarını yapıştırın (bkz. Yapılandırma).

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. 4242 4242 4242 4242 kartıyla test modunda bir ödeme deneyin, ardından Test Mode seçeneğini kapatın.

Kurulumda modül iki sipariş durumu oluşturur: Awaiting Stripe payment ve Stripe payment on hold. PrestaShop, yeni ödeme modülünü tüm para birimleri, ülkeleri ve müşteri gruplarında etkinleştirir. 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 Stripe 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 sayfa, geçerli modda gizli anahtar yoksa (bu durumda ödeme yöntemi ödeme adımında gizlenir) veya webhook imza gizli anahtarı yoksa (bu durumda siparişler yalnızca müşteri mağazaya döndüğünde onaylanır) sizi uyarır. Test modu açıkken sayfa ayrıca Test modu açık: gerçek ödeme alınmaz. uyarısını gösterir.

Stripe Checkout

Enable/Disable: Enable Stripe Gateway ödeme yöntemini açar veya kapatır. Default: off.

Title: müşterilerin ödeme adımında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Default: Stripe. Zorunlu.

Description: ödeme adımında ödeme yönteminin altında gösterilen metin. Default: Pay securely with your credit or debit card via Stripe.

API anahtarları

Gizli anahtarları Stripe Dashboard > Developers > API keys bölümünden kopyalayın. Test ve canlı anahtarlar ayrıdır. Test modu yalnızca test anahtarlarını, canlı mod yalnızca canlı anahtarları kullanır. Kaydettiğinizde bir değer beklenen ön ekle başlamazsa modül sizi uyarır; örneğin gizli anahtar yerine yayınlanabilir bir anahtar yapıştırıldığında.

Test Mode: Stripe test anahtarlarını kullanır. Gerçek para çekilmez; 4242 4242 4242 4242 gibi Stripe test kartlarıyla ödeme yapın. Default: on. Gerçek ödeme almak için kapatın. Açıkken müşteriler ödeme yönteminin altında Test modu: gerçek ödeme alınmaz. ifadesini görür.

Test Secret Key: test modunun gizli anahtarı. sk_test_ (veya kısıtlı bir anahtar için rk_test_) ile başlar.

Test Webhook Secret: test modunda oluşturulan webhook uç noktasının imza gizli anahtarı (whsec_...).

Live Secret Key: canlı modun gizli anahtarı. sk_live_ (veya kısıtlı bir anahtar için rk_live_) ile başlar.

Live Webhook Secret: canlı modda oluşturulan webhook uç noktasının imza gizli anahtarı (whsec_...).

Kaydedilmiş anahtarlar ve gizli anahtarlar bir daha asla gösterilmez. Alan boş kalır ve Kaydedildi — korumak için boş bırakın. gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Clear saved secrets: bir anahtarı veya gizli anahtarı işaretleyip Save düğmesine tıklayarak kaldırın. Boş alan kayıtlı değeri korur.

Webhook

Webhook, mağazanıza bir ödemenin yapıldığını bildirir. Stripe Dashboard > Developers > Webhooks bölümünde bir uç nokta test modunda, bir diğeri canlı modda ekleyin. Bu bölümdeki Endpoint URL alanında gösterilen URL'yi kullanın. Dostça URL'lerle şöyle görünür: https://your-shop/module/wcp_stripe_gateway/webhook; başında /en/ gibi bir dil kodu da olabilir. URL'yi ayarların gösterdiği gibi birebir kopyalayın, çünkü Stripe yönlendirmeleri takip etmez.

Her uç nokta için şu olayları seçin (bu bölümde de listelenmiştir):

Her uç noktayı oluşturduktan sonra Stripe'tan imza gizli anahtarını (whsec_...) kopyalayıp Test Webhook Secret veya Live Webhook Secret alanına yapıştırın. Geçerli imzası olmayan webhook'lar reddedilir. Bir olay, ödemenin yapıldığı modun gizli anahtarıyla imzalanmış olmalıdır; bu nedenle test gizli anahtarı hiçbir zaman gerçek bir ödemeyi onaylamaz. Webhook olmadan, sipariş yalnızca müşteri ödemeden sonra mağazaya döndüğünde oluşturulur.

Siparişler

Order Status After Payment: başarılı bir ödemeden sonra ayarlanan sipariş durumu.

Gecikmeli ödemeler Awaiting Stripe payment durumunda bekler. Tutar veya para birimi uyuşmazlıkları her zaman Stripe payment on hold durumuna gider.

Gelişmiş

Logging: Stripe isteklerini ve webhook'ları modül klasöründeki logs/strg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Anahtarlar ve müşteri verileri günlüğe yazılmaz. Default: off. Kapalıyken hiçbir şey yazılmaz.

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

Delete Data on Uninstall: açıkken modülü kaldırmak ağ geçidi ayarlarını ve günlüğü siler. Stripe işlemleri ve iadeleri ile modülün sipariş durumları her zaman korunur, böylece mevcut siparişler çalışmaya devam eder. Default: off.

Ödeme

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Stripe) ve Ödemeyi güvenli bir şekilde tamamlamak için Stripe'a yönlendirileceksiniz. notunu görür. Onaylandıktan sonra modül, sepet toplamı için sepet para biriminde bir Stripe Checkout oturumu oluşturur ve müşteriyi Stripe'ın ödeme sayfasına gönderir. Müşteri orada kredi veya banka kartıyla öder. Müşterinin e-posta adresi Stripe'a iletilir ve ödeme Stripe sayfasında sepet numarasıyla birlikte Cart # olarak görünür. Bu noktada henüz bir sipariş yoktur.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş yalnızca Stripe onayladıktan sonra ödenmiş olarak işaretlenir: imzalı webhook ile veya müşteri geri döndüğünde Stripe'a yapılan sunucu tarafı bir istekle. Sipariş bu noktada oluşturulur ve müşteri standart sipariş onay sayfasını görür: Stripe ile ödemeniz alındı. Gecikmeli bir ödemede sayfa Ödemeniz Stripe tarafından onaylanıyor. Onaylandığında size bir e-posta göndereceğiz. mesajını gösterir. Gecikmeli bir ödeme daha sonra başarısız olursa sayfa Stripe ödemeniz tamamlanmadı. Bu siparişle ilgili bizimle iletişime geçin. mesajını gösterir. Müşteri geri döndüğünde Stripe ödemeyi henüz onaylamadıysa, Payment confirmation sayfası aynı metni ve bir Check again düğmesini gösterir; webhook geldiği anda siparişi oluşturur.

Müşteri Stripe sayfasında iptal ederse Stripe oturumu kapanır ve müşteri şu mesajla ödeme adımına döner: Ödeme iptal edildi. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. Ödeme tamamlanmadıysa mesaj şöyledir: Ödeme tamamlanmadı. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. Sepet korunur. Her yeni deneme önceki Stripe oturumunu kapatır; bu nedenle sepet iki kez ödenemez. Önceki oturum zaten ödenmiş çıkarsa, yeni bir ödeme yerine sipariş oluşturulur.

Stripe ödemeyi başlatamazsa müşteri ödeme adımında kısa bir mesajla kalır, örneğin Sipariş toplamı, bu para biriminde Stripe'ın tahsil edebileceği asgari tutarın altında. Lütfen başka bir ödeme yöntemi seçin. Teknik neden günlüğe yazılır.

Ödeme ile onayı arasında sepetteki bir kupon geçerliliğini yitirirse, PrestaShop onu siparişten kaldırır. Sipariş, müşterinin indirimli fiyatı ödemiş olması nedeniyle bir notla Stripe payment on hold durumuna geçer.

Webhook, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasından etkilenmez.

Modül yalnızca kart ödemelerini kabul eder ve bunlar Stripe sayfasında hemen tahsil edilir. Kayıtlı kart, abonelik veya tekrarlayan ödeme, sitede kart formu, sitenizde Apple Pay veya Google Pay düğmeleri ve ayrı yetkilendirme ve tahsilat yoktur.

Siparişler ve iadeler

Sipariş durumları

Henüz sipariş yok: Müşteri Stripe'a yönlendirildi ve henüz ödeme yapmadı ya da Stripe ödemeyi henüz onaylamadı. Yalnızca sepet var.

Payment accepted, Delivered or Stripe payment on hold: Ödeme onaylandı. Durum, Order Status After Payment ayarını izler. Ödeme, Stripe ödeme kimliği (pi_...) ile işlem kimliği olarak kaydedilir ve bir not Stripe ödemesini, oturumu ve onay şeklini (webhook veya dönüş) gösterir.

Awaiting Stripe payment: Müşteri, gecikmeli bir ödeme yöntemiyle ödemeyi tamamladı. Stripe ödemeyi onayladığında sipariş ödenmiş duruma geçer.

Stripe payment on hold after payment: Stripe, sipariş toplamından farklı bir tutar veya para birimi bildirdi (örneğin ödeme başladıktan sonra sepet değiştirildi), bir kupon kaldırıldı veya ödeme, sipariş iptal edildikten sonra geldi. Not durumu açıklar. Siparişi kontrol edin ve tamamlayın ya da ödemeyi iade edin.

Payment error: Gecikmeli bir ödeme başarısız oldu.

Refunded: Ödeme modül üzerinden tamamen iade edildi.

Zaten ödenmiş bir sipariş için ikinci bir ödeme gelirse, sipariş değiştirilmez. Bir not, bunu kontrol etmenizi ve kopyayı Stripe Dashboard'da iade etmenizi ister.

Stripe payment bloğu

Sipariş sayfası, Stripe ödeme kimliğini (Stripe Dashboard'daki ödemeye bağlı), Checkout Session'ı, ödeme durumunu, Stripe'ın tahsil ettiği tutarı ve iade edilen tutarı, test ödemeleri için bir Test mode rozetini, iade geçmişini ve siparişin Stripe notes bölümünü içeren bir Stripe payment bloğu gösterir.

İadeler

Stripe payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isterseniz bir neden yazın ve Refund via Stripe düğmesine tıklayın. Bu tutar Stripe üzerinden iade edilsin mi? Bu işlem geri alınamaz. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Siparişleri düzenleme yetkisine sahip olmanız gerekir. İadeler, Stripe'ın tahsil ettiği tutar ve para biriminde yapılır; bu nedenle tutar veya para birimi uyuşmazlığından sonra sipariş toplamı yerine müşterinin gerçekte ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı modda (test veya canlı) gönderilir, bu nedenle o modun gizli anahtarı tanımlı olmalıdır. Stripe iadeyi kabul etmezse blok hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, Stripe iade kimliğiyle birlikte iade geçmişine ve notlara eklenir. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez. İadeler, Stripe ödemeyi onayladıktan sonra kullanılabilir.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki PrestaShop'un standart iade düğmeleri Stripe üzerinden para geri göndermez.

Stripe Dashboard'da yapılan iadeler, charge.refunded webhook'u ile gelir ve Stripe'ta iade edilen toplamla birlikte notlara eklenir. Sipariş durumu ve kredi notları otomatik olarak değişmez. Gerekirse bunları elle güncelleyin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Stripe Gateway lisans bloğu, Modules > Module Manager > VibeFox Stripe Gateway > Configure 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 tarih 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: presta-payment-stripe satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure izni olan çalışanlar değiştirebilir. Bloktaki metinler 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 veya tarihle birlikte License expired on. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı hakkını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa 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ı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan Stripe, ödeme adımı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 yüzden ödeme yöntemi sizin için de gizlenir: modülü bir anahtar satın almadan önce ayarlayabilirsiniz, ancak ödeme adımında test edemezsiniz. 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 ve iadeler çalışır.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, back office'te çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, ardından haftada bir. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Stripe ödeme adımında görünmüyor: Lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve geçerli modda bir gizli anahtar bulunduğunu kontrol edin: test modunda Test Secret Key, canlı modda Live Secret Key. Anahtar eksikse ayarlar sayfası bir uyarı gösterir. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Ödeme geçti ama sipariş oluşturulmadı: Webhook çalışmıyor. Stripe Dashboard'da, kullandığınız modda (test veya canlı) uç noktanın var olduğunu, URL'sinin tam olarak Endpoint URL alanında gösterilen URL olduğunu ve dört olayın da seçili olduğunu kontrol edin. Bu uç noktanın imza gizli anahtarının doğru alanda (Test Webhook Secret veya Live Webhook Secret) olduğunu kontrol edin. Stripe Dashboard, her webhook için mağazanızın yanıtını gösterir. Müşteri ödemeden sonra mağazaya döndüğünde de sipariş oluşturulur.

Webhook yanıtı Webhook secret not configured: Hiçbir webhook gizli anahtarı ayarlanmamış. İmza gizli anahtarını ayarlara yapıştırın.

Webhook yanıtı Invalid signature: İmza gizli anahtarı başka bir uç noktaya veya başka bir moda ait ya da sunucu saati yanlış. Stripe imzaları, sunucu saatinden itibaren 5 dakika içinde kabul edilir. Canlı bir ödemenin olayı test gizli anahtarıyla imzalandığında veya tersi olduğunda da yanıt Invalid signature olur: test ve canlı gizli anahtarların yer değiştirmediğini kontrol edin.

Webhook yanıtı Busy, retry: Sipariş aynı anda başka bir istek tarafından onaylanıyordu ya da sipariş oluşturulamadı (örneğin modül devre dışıysa). Stripe webhook'u otomatik olarak yeniden dener. Nedenini görmek için Logging seçeneğini açın.

Webhook URL'si tarayıcıda Method not allowed gösteriyor: Bu normaldir. URL yalnızca Stripe'tan gelen istekleri kabul eder.

Kaydederken değerin doğru görünmediğine dair uyarı: Bir anahtar yanlış alana yapıştırılmış. Gizli anahtarlar sk_test_ / rk_test_ veya sk_live_ / rk_live_ ile, webhook gizli anahtarları whsec_ ile başlar.

Müşteri Stripe'ı seçerken bir hata görüyor: Logging seçeneğini açın ve modül sayfasındaki Log alanına bakın. Yanlış bir anahtar, ödeme yönteminin doğru yapılandırılmadığı mesajını verir. Para birimi için Stripe asgarisinin altındaki bir sipariş toplamı (örneğin 0.50 EUR) Stripe ile ödenemez.

Test ödemeleri canlı bir ödemeyi onaylamıyor: Test ve canlı ödemeler ayrı tutulur. Test Mode seçeneğini istediğiniz moda getirin ve o modun anahtarlarını ve webhook'unu kullanın.

Ödemeden sonra sipariş Stripe payment on hold durumunda: Stripe payment bloğundaki notları okuyun (bkz. Sipariş durumları), ardından siparişi tamamlayın veya ödemeyi iade edin.

İade, mod ile ilgili bir mesajla başarısız oluyor: Ödeme test veya canlı modda yapıldı ve o modun gizli anahtarı tanımlı değil. Anahtarı girin ve yeniden deneyin.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Stripe 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 bir yeniden kurulum için saklanır. Stripe işlemleri ve iadeleri ile Awaiting Stripe payment ve Stripe payment on hold sipariş durumları her zaman saklanır; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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