VibeFox Stripe for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, yüklü ve etkin. Eklenti WooCommerce olmadan etkinleştirilemez.

PHP: 8.0 veya üzeri.

HTTPS: Canlı ödemeler için sitenizin HTTPS kullanması gerekir.

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. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. wcp_stripe_gateway klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

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

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

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

5. 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).

6. Enable/Disable seçeneğini açın. 4242 4242 4242 4242 kartıyla test modunda bir ödeme deneyin, ardından Test Mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfada: WooCommerce > Settings > Payments > Stripe. Alanların üstünde, geçerli modda gizli anahtar (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ya da webhook imza gizli anahtarı yoksa sayfa sizi uyarır ve test modu açıkken Test mode is on: no real payments are taken. ifadesini gösterir. Ödeme yöntemleri listesinde, geçerli modda gizli anahtar olana kadar Stripe kurulum gerektiriyor olarak işaretlenir.

Genel

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

Title: Müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Varsayılan: Stripe.

Description: Ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: 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 önekle başlamıyorsa eklenti sizi uyarır; örneğin gizli anahtar yerine yayınlanabilir anahtar yapıştırıldığında.

Test Mode: Enable test mode Stripe test anahtarlarını kullanır. Gerçek para çekilmez; 4242 4242 4242 4242 gibi Stripe test kartlarıyla ödeme yapın. Varsayılan: açık. Gerçek ödemeleri kabul etmek için işaretini kaldırın.

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

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_ ile başlar (kısıtlı bir anahtar için rk_live_).

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

Webhook

Webhook, bir ödemenin yapıldığını mağazanıza bildirir. Stripe Dashboard > Developers > Webhooks bölümünde test modunda bir uç nokta, canlı modda da başka bir uç nokta ekleyin. Ayarların bu bölümünde gösterilen URL'yi kullanın. Şuna benzer: https://your-site/wc-api/strg_stripe_webhook/. Sitenizde URL'lerde dil öneki kullanılıyorsa, Stripe yönlendirmeleri takip etmediği için URL'yi ayarların gösterdiği gibi birebir kopyalayın.

Her uç nokta için bu olayları seçin:

Her uç nokta oluşturulduktan sonra, Stripe'tan imza gizli anahtarını (whsec_...) kopyalayın ve Test Webhook Secret veya Live Webhook Secret alanına yapıştırın. Geçerli imzası olmayan webhook'lar reddedilir. Webhook olmadan bir sipariş, yalnızca müşteri ödeme yaptıktan sonra mağazaya döndüğünde onaylanır.

Siparişler

Order Status After Payment: başarılı bir ödemeden sonra ayarlanan sipariş durumu. Durum hemen ayarlanır, ikinci bir durum değişikliği olmaz.

Gelişmiş

Logging: Enable logging, Stripe isteklerini ve webhook'ları WooCommerce > Status > Logs sayfasına, kaynak wcp_stripe_gateway olarak yazar. Anahtarlar ve müşteri verileri günlüğe kaydedilmez. Varsayılan: kapalı.

Delete Data on Uninstall: açıksa, eklentiyi silmek ağ geçidi ayarlarını, siparişlerde saklanan Stripe verilerini ve günlükleri kaldırır. Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak Stripe) ve siparişi verir. Eklenti, sipariş toplamı için sipariş para biriminde bir Stripe Checkout Oturumu oluşturur ve müşteriyi Stripe ödeme sayfasına yönlendirir. Orada müşteri kredi veya banka kartıyla öder. Müşterinin fatura e-postası Stripe'a iletilir ve ödeme Stripe sayfasında Order # ve sipariş numarası olarak görünür.

Ödemeden sonra müşteri, mağazanızın sipariş alındı sayfasına döner. Sipariş yalnızca Stripe onayladıktan sonra ödenmiş olarak işaretlenir: imzalı webhook ile veya müşteri bu sayfaya geldiğinde Stripe'a sunucu tarafında yapılan bir istekle. Ödeme henüz onaylanmamışsa sayfa Your payment is being confirmed by Stripe. You will receive an e-mail as soon as it is confirmed. mesajını gösterir.

Müşteri Stripe sayfasında iptal ederse sipariş, WooCommerce'in standart yöntemiyle iptal edilir. Müşteri, ödenmemiş bir siparişi örneğin Pay for order sayfasından yeniden ödeyebilir. Her yeni deneme, önceki Stripe oturumunu kapatır; bu nedenle sipariş iki kez ödenemez.

Stripe ödemeyi başlatamazsa müşteri kısa bir mesaj görür; örneğin sipariş toplamının bu para biriminde Stripe'ın tahsil edebileceği asgari tutarın altında olduğunu ve başka bir ödeme yöntemi seçebileceğini. Teknik neden sipariş notlarına ve günlüğe eklenir. Oturum açmış mağaza yöneticileri bunu mesajda da görü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 kart ödemelerini kabul eder; bunlar Stripe sayfasında hemen tahsil edilir. Kayıtlı kart, abonelik veya yinelenen ödeme, sitede kart formu, sitenizde Apple Pay veya Google Pay düğmesi ve ayrı yetkilendirme ve tahsilat yoktur.

Siparişler ve iadeler

Sipariş durumları

Pending payment: Müşteri Stripe'a yönlendirildi ve henüz ödeme yapmadı ya da Stripe ödemeyi henüz onaylamadı.

Processing, Completed or On Hold: Ödeme onaylandı. Durum Order Status After Payment ayarını izler. Sipariş notu Stripe ödemesini ve nasıl onaylandığını gösterir (webhook veya dönüş). İşlem kimliği Stripe ödeme kimliğidir (pi_...) ve sipariş ekranında Stripe Dashboard'daki ödemeye bağlanır.

On hold after payment: Stripe, sipariş toplamından farklı bir tutar veya para birimi bildirdi (örneğin ödeme başladıktan sonra sipariş düzenlendi) ya da ödeme sipariş iptal edildikten sonra geldi. Sipariş notu bunu açıklar. Siparişi kontrol edin ve tamamlayın ya da ödemeyi iade edin.

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

Cancelled: Müşteri Stripe sayfasında iptal etti ya da sipariş sizin tarafınızdan veya WooCommerce stok tutma zaman aşımıyla iptal edildi. Siparişin açık Stripe oturumu kapatılır; bu nedenle artık ödenemez.

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

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Stripe düğmesine tıklayın. Tam ve kısmi iadeler desteklenir. İade, ödemenin yapıldığı modda (test veya canlı) gönderilir; bu nedenle o modun gizli anahtarı ayarlanmış olmalıdır. Stripe iadeyi kabul etmezse WooCommerce hatayı gösterir ve iade kaydedilmez. Başarılı bir iade, Stripe iade kimliğiyle birlikte sipariş notlarına eklenir.

Stripe Dashboard'da yapılan iadeler, charge.refunded webhook'u ile gelir ve sipariş notlarına eklenir. Bunlar otomatik olarak WooCommerce iadesi olarak kaydedilmez. Gerekirse Refund via Stripe kullanmadan WooCommerce'de manuel bir iade oluşturun.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Stripe 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 aktif 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, o sitenin alan adı yuvasını boşaltmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

Etkin bir anahtar olmadan Stripe, ö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. Oturum açmış mağaza yöneticileri ödeme yöntemini hâlâ (unlicensed — visible to admins only) işaretiyle görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında 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ı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

Stripe ö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 gizli anahtar bulunduğunu kontrol edin: test modunda Test Secret Key, canlı modda Live Secret Key. Anahtar eksikse ayarlar sayfası bir uyarı gösterir.

Ödeme geçti ama sipariş Pending payment durumunda kalıyor: webhook çalışmıyor. Stripe Dashboard'da, kullandığınız modda (test veya canlı) uç noktanın var olduğunu, URL'sinin ayarlarda gösterilenle birebir aynı olduğunu ve dört olayın 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 ödeme yaptıktan sonra mağazaya döndüğünde de sipariş onaylanır.

Webhook yanıtı Webhook secret not configured: İki webhook gizli anahtarından hiçbiri 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 saatine göre 5 dakika içinde kabul edilir.

Webhook yanıtı Busy, retry: Sipariş aynı anda başka bir istek tarafından onaylanıyordu. Stripe webhook'u otomatik olarak yeniden dener.

Kaydederken görülen uyarı: değer doğru görünmüyor: 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 sipariş verirken hata görüyor: Sipariş notlarını açın veya Logging seçeneğini açıp WooCommerce > Status > Logs sayfasında wcp_stripe_gateway kaynağına bakın. Yanlış ya da eksik 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 siparişi onaylamıyor: Test ve canlı ödemeler ayrı tutulur. Bir test ödemesi asla canlı bir siparişi onaylamaz, tersi de geçerlidir. Test Mode seçeneğini istediğiniz moda getirin ve o modun anahtarlarını ve webhook'unu kullanın.

Sipariş, ödemeden sonra On hold durumunda: Sipariş notunu okuyun. Ödenen tutar veya para birimi siparişten farklıydı ya da ödeme sipariş iptal edildikten sonra geldi. 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ı ayarlanmamış. Anahtarı girin ve yeniden deneyin.

Lisans bloğu bir 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 yuva boşaltın ve Check now düğmesine tıklayın. Site adresi değiştiyse, yeni alan adı için anahtarı 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 silinir. Ağ geçidi ayarları, siparişlerde saklanan Stripe verileri ve günlükler yalnızca Delete Data on Uninstall açıksa silinir. Aksi halde sonraki bir yeniden kurulum için saklanır. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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