VibeFox Stripe for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

Stripe hesabı: Stripe hesabınızın gizli API anahtarlarına ve Stripe Dashboard'da bir webhook uç noktasına ihtiyacınız vardır (bkz. Yapılandırma). Yalnızca gizli anahtarlar ve webhook imza sırları 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 bir alan adında çalışır.

Kurulum

İndirilen dosya, iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Arşivi bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_stripe_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_stripe_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve wcp_stripe_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu yüzden Extensions > Modifications sayfasını yenilemeniz 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 sayfasına gidin ve türü Payments olarak seçin. VibeFox Stripe Gateway eklentisini bulun ve Install düğmesine (yeşil +) tıklayın. Yönetici kullanıcınızın ödeme eklentileri listesini değiştirme yetkisi olmalıdır.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem simgesi) tıklayın. VibeFox lisans anahtarınızı sayfanın üstündeki lisans bloğunda bulunan License key alanına yapıştırın 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 sırları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.

OpenCart 4

1. Yönetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve wcp_stripe_gateway.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve adı değiştirilmiş paket çalışmaz.

2. Paket, aynı sayfadaki kurulu eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil +) tıklayın.

3. Extensions > Extensions sayfasına gidin ve türü Payments olarak seçin. VibeFox Stripe Gateway eklentisini bulun, Install düğmesine (yeşil +) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını, Stripe anahtarlarını ve webhook'u OpenCart 3 için 3-5. adımlarda olduğu 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 Stripe Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa, geçerli modda gizli anahtar yoksa (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) veya webhook imza sırrı yoksa (bu durumda siparişler yalnızca müşteri ödemeden sonra mağazaya döndüğünde onaylanır) sizi uyarır ve test modu açıkken Test mode is on: no real payments are taken. ifadesini gösterir. Eklentiyi değiştirme yetkiniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Kaydederken Title 1 ila 128 karakter olmalıdır, Sort Order tam sayı olmalıdır ve Total 0 veya daha büyük bir sayı olmalıdır. Bir anahtar veya sır beklenen ön ekle başlamıyorsa ayarlar kaydedilir ve ayarların üstünde alanın adını belirten bir uyarı gösterilir.

Stripe Checkout

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

Title: müşterinin ödeme sayfasında gördüğü ödeme yönteminin adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Stripe. Zorunlu.

Description: müşterinin Confirm Order adımında onay düğmesinin üstünde gördüğü metin. Varsayılan: Pay securely with your credit or debit card via Stripe.

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

Geo Zone: Stripe'ı yalnızca seçili bölgedeki ödeme adresleri için sunun. Varsayılan: All zones. Bölgeler System > Localisation > Geo Zones altında tanımlanır.

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

API anahtarları

Gizli anahtarları Stripe Dashboard > Developers > API keys sayfasından kopyalayın (sayfada bir bağlantı vardır). Test ve canlı anahtarlar ayrıdır. Test modu yalnızca test anahtarlarını, canlı mod yalnızca canlı anahtarları kullanır.

Test Mode: Stripe test anahtarlarını kullanır. Gerçek para tahsil edilmez; 4242 4242 4242 4242 gibi Stripe test kartlarıyla ödeme yapın. Varsayılan: açık. Gerçek ödemeleri kabul etmek için kapatın. Açık olduğu sürece müşteriler Confirm Order adımında Test modu: gerçek ödeme alınmıyor. ifadesini görür.

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

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

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

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

Kayıtlı anahtarlar ve sırlar bir daha gösterilmez. Alan boş kalır ve Kayıtlı — korumak için boş bırakın. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı bir değeri silmek için alanın altındaki Clear the saved value on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Webhook

Webhook, mağazanıza bir ödemenin yapıldığını bildirir. Stripe Dashboard > Developers > Webhooks sayfasında test modu için bir uç nokta, canlı mod için başka bir uç nokta ekleyin. Bu bölümdeki Endpoint URL alanında gösterilen URL'yi kullanın. OpenCart 3'te URL şuna benzer: https://your-store/index.php?route=extension/payment/wcp_stripe_gateway/webhook, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_stripe_gateway/payment/wcp_stripe_gateway.webhook. Bu URL, OpenCart kurulumunuzun vitrin adresinden oluşturulur. URL'yi ayarların gösterdiği gibi birebir kopyalayın.

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

Her uç nokta oluşturulduktan sonra, imza sırrını (whsec_...) Stripe'dan kopyalayın ve Test Webhook Secret veya Live Webhook Secret alanına yapıştırın. Geçerli bir imzası olmayan webhook'lar reddedilir. Bir olay yalnızca ödemenin yapıldığı modun sırrıyla imzalanmışsa kabul edilir; bu nedenle test sırrı hiçbir zaman gerçek bir ödemeyi onaylamaz. Webhook yoksa bir sipariş yalnızca müşteri ödemeden sonra mağazaya döndüğünde onaylanır.

Siparişler

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

Order Status After Payment: başarılı bir ödemeden sonra ayarlanan durum. Varsayılan: Processing.

Awaiting Payment Status: ertelenmiş bir ödeme: ödeme sayfası tamamlandı, ancak Stripe parayı henüz onaylamadı. Varsayılan: Pending.

On Hold (Review) Status: ödemenin sizin incelemenizi gerektirdiği durum (bkz. Sipariş durumları). Varsayılan: Pending, çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses altında kendi durumunuzu oluşturup burada seçebilirsiniz.

Failed Payment Status: ertelenmiş bir ödeme başarısız oldu. Varsayılan: Failed.

Refunded Status: ödeme, sipariş sayfasından tamamen iade edildi. Varsayılan: Refunded.

Gelişmiş

Logging: Stripe isteklerini ve webhook'ları OpenCart günlük klasöründeki (storage/logs) strg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz ve 5 MB olduğunda strg_debug.old.log.php adına taşınır. Anahtarlar ve müşteri verileri kaydedilmez. Varsayılan: kapalı. Kapalıyken hatalar dahil hiçbir şey yazılmaz.

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

Delete Data on Uninstall: açıksa, eklentiyi kaldırdığınızda ağ geçidi ayarları ve günlük silinir. Stripe işlemleri ve iadeleri her zaman korunur, bu nedenle eski siparişler iade edilebilir kalır. Varsayılan: kapalı.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. Gizli anahtarlar 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. Kayıtlı gizli anahtarlar korunur.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Stripe). Confirm Order adımında müşteri açıklamanızı ve Ödemeyi güvenli bir şekilde tamamlamak için Stripe'a yönlendirileceksiniz. notunu görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş tutarı için sipariş para biriminde bir Stripe Checkout oturumu oluşturur ve müşteriyi Stripe'ın ödeme sayfasına gönderir. Orada müşteri kredi veya banka kartıyla öder. OpenCart 4'te müşteri ödeme yöntemini, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde seçer ve ödeme sayfasının altındaki Confirm Order düğmesine tıklar. Müşterinin e-postası Stripe'a iletilir ve ödeme Stripe sayfasında sipariş numarasıyla birlikte Order # olarak görünür.

Ödemeden sonra müşteri mağazanıza döner. Sipariş, yalnızca Stripe onayladıktan sonra ödenmiş olarak işaretlenir: imzalı webhook ile veya müşteri döndüğünde Stripe'a sunucu tarafı bir istekle. Ardından sipariş, OpenCart'ın standart yoluyla durum alır; olağan sipariş e-postaları ve stok güncellemesi yapılır ve müşteri OpenCart sipariş başarı sayfasını görür. Ertelenmiş bir ödeme için sayfa ayrıca Ödemeniz Stripe tarafından onaylanıyor. Onaylanır onaylanmaz size bir e-posta gönderilecek. ifadesini gösterir. Müşteri döndüğünde Stripe ödemeyi henüz onaylamadıysa, aynı metni ve bir Check again düğmesini içeren bir Ödeme onayı sayfası gösterilir; webhook geldiği anda sipariş durumunu ayarlar.

Müşteri Stripe sayfasında iptal ederse Stripe oturumu kapanır ve müşteri Ödeme iptal edildi. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. mesajıyla ödeme sayfasına döner. Ödeme tamamlanmadıysa veya ertelenmiş bir ödeme başarısız olduysa mesaj Ödeme tamamlanmadı. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. olur. Sepet korunur. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir. Her yeni deneme (OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise ödeme sürecindeki siparişi günceller) sepetin önceki açık Stripe oturumlarını kapatır; böylece sepet iki kez ödenemez. Önceki bir oturumun zaten ödenmiş olduğu ortaya çıkarsa, yeni bir ödeme başlatmak yerine o ödeme onaylanır. Aynı sepetin başka bir siparişi zaten Stripe ile ödenmişse, yeni bir ödeme başlatılmaz ve müşteri sipariş başarı sayfasını görür. Sepetteki bir değişiklik, yeni adet dahil, kendi ödemesini gerektiren yeni bir sepet sayılır.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme sürecinde tutar. Bu sipariş bu arada ödeme yapılmadan kapatılmışsa (örneğin ertelenmiş ödemesi başarısız olduysa veya siz iptal ettiyseniz), müşteri ödeme tamamlanmadı mesajıyla ödeme sayfasına geri gönderilir ve bir sonraki Confirm Order yeni bir siparişin ödemesini başlatır. Ödenmiş bir sipariş, farklı bir sepet için asla ödenmiş gibi gösterilmez.

Stripe ödemeyi başlatamazsa müşteri, düğmenin üstündeki kısa bir mesajla Confirm Order adımında kalır; örneğin Sipariş tutarı, 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.

Mağaza bakım modundayken de webhook çalışır, çünkü OpenCart ödeme eklentisi isteklerine izin verir.

Eklenti yalnızca kart ödemelerini kabul eder ve bunlar Stripe sayfasında hemen tahsil edilir. Kayıtlı kart, abonelik veya yinelenen ödeme yoktur; sitenizde kart formu, sitenizde Apple Pay veya Google Pay düğmeleri yoktur ve ayrı bir yetkilendirme ile tahsilat yapılmaz.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri Stripe'a yönlendirildi ve ödeme yapmadı ya da Stripe ödemeyi henüz onaylamadı. Sales > Orders sayfasında bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Order Status After Payment (varsayılan Processing): ödeme onaylandı. Bir notta Stripe ödemesi (pi_...), oturum ve nasıl onaylandığı (webhook veya dönüş) gösterilir.

Awaiting Payment Status (varsayılan Pending): müşteri ertelenmiş bir ödeme yöntemiyle ödeme sayfasını tamamladı. Stripe ödemeyi onayladığında sipariş Order Status After Payment durumuna geçer; ödeme başarısız olduğunda Failed Payment Status durumuna geçer. OpenCart müşteriyi bu değişiklikler hakkında bilgilendirir.

On Hold (Review) Status (varsayılan Pending): Stripe, sipariş toplamından farklı bir tutar veya para birimi bildirdi ya da ödeme, sipariş iptal edildikten veya durumu değiştikten sonra geldi. Not bunu açıklar. Siparişi kontrol edin ve yerine getirin veya ödemeyi iade edin.

Refunded Status (varsayılan Refunded): ödeme eklenti üzerinden tamamen iade edildi.

Zaten ödenmiş bir siparişi olan bir sepet için ikinci bir ödeme gelirse, ödenmiş sipariş değiştirilmez. Bir not, bunu kontrol etmenizi ve çift ödemeyi Stripe Dashboard'da iade etmenizi ister. Ödeme, zaten ödenmiş bir sepetin başka bir siparişine aitse de aynısı geçerlidir: o sipariş durumsuz kalır ve not ödenmiş siparişe eklenir.

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

VibeFox Stripe Gateway sekmesi

Sales > Orders sayfasında Stripe ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox Stripe Gateway sekmesi, Stripe ödeme kimliğini (Stripe Dashboard'daki ödemeye bağlantılı) gösterir; test ödemeleri için Test mode etiketi, Checkout Session, ödeme Status değeri, Paid / refunded tutarları, iade formu, iade geçmişi ve siparişin Stripe notes notları. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox Stripe Gateway sekmesinde Amount değerini girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) 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. Eklentiyi değiştirme yetkisine ihtiyacınız vardır (System > Users > User Groups altında ayarlanır). İadeler, sipariş toplamı değil, Stripe'ın tahsil ettiği tutar ve para biriminde yapılır. İade, ödemenin yapıldığı modda (test veya canlı) gönderilir; bu nedenle o modun gizli anahtarı ayarlanmış olmalıdır. Stripe iadeyi kabul etmezse sekme hatayı gösterir ve iade kaydedilmez. Başarılı bir iade, Stripe iade kimliğiyle birlikte geçmişe ve notlara eklenir. Tam iade, siparişi müşteriye bildirmeden ve ürünleri stoka geri koymadan Refunded Status durumuna alır; tıpkı manuel bir durum değişikliği gibi. Kısmi iade durumu değiştirmez. İadeler, Stripe ödemeyi onayladıktan sonra kullanılabilir.

Sales > Returns altındaki ürün iadeleri Stripe üzerinden para geri göndermez.

Stripe Dashboard'da yapılan iadeler charge.refunded webhook'u ile gelir ve Stripe'daki toplam iade tutarıyla birlikte notlara eklenir. Sipariş durumu otomatik olarak değişmez. Gerekirse elle güncelleyin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Stripe Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Stripe Gateway > 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 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: opencart-payment-stripe 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 yetkisine sahip yönetici kullanıcılar değiştirebilir. Bloktaki metinler yönetici panelinin dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir; örneğin Anahtar bulunamadı, Bu anahtar başka bir ürüne ait, Alan adı limitine ulaşıldı veya tarihle birlikte Lisans şu tarihte sona erdi. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvası boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak 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 Bu ödeme yöntemi kullanılamıyor. Lütfen başka birini seçin. mesajını görür. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada yine görür ve (unlicensed — visible to admins only) ibaresiyle işaretlenir; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza, yönetici panelinde oturum açıldığını görmez; bu yüzden etkin anahtar yoksa ödeme yöntemi herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: Zaten başlatılmış ödemeler onaylanmaya devam eder 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. Yönetici Dashboard veya Edit sayfasını açtığınızda durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

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 modun gizli anahtarının bulunduğunu kontrol edin: test modunda Test Secret Key, canlı modda Live Secret Key. Anahtar eksikse ayarlar sayfası bir uyarı gösterir. Ayrıca ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlardaki Total değerine ulaştığını kontrol edin.

Ödeme yapıldı ama sipariş durumsuz kalıyor: webhook çalışmıyor. Stripe Dashboard'da, kullandığınız modda (test veya canlı) uç noktanın var olduğunu, URL'sinin Endpoint URL alanında gösterilenle birebir aynı olduğunu ve dört olayın seçili olduğunu kontrol edin. Bu uç noktanın imza sırrının ilgili alanda (Test Webhook Secret veya Live Webhook Secret) olduğunu doğrulayın. Stripe Dashboard, her webhook için mağazanızın yanıtını gösterir. Müşteri ödemeden sonra mağazaya döndüğünde sipariş de durum alır.

Webhook "Webhook secret not configured" yanıtı veriyor: hiçbir webhook sırrı ayarlanmamış. İmza sırrını ayarlara yapıştırın.

Webhook "Invalid signature" yanıtı veriyor: imza sırrı başka bir uç noktaya veya başka bir moda ait ya da sunucu saati yanlış. Stripe imzaları yalnızca sunucu saatinden itibaren 5 dakika içinde kabul edilir. Canlı bir ödemenin olayı test sırrıyla imzalandığında veya tersi olduğunda da yanıt "Invalid signature" olur: test ve canlı sırların karıştırılmadığını kontrol edin.

Webhook "Busy, retry" yanıtı veriyor: sipariş tam o sırada başka bir istek tarafından onaylanıyordu ya da sipariş durumu ayarlanamadı. 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'dan gelen istekleri kabul eder.

Kaydederken "The value does not look right" uyarısı: bir anahtar yanlış alana yapıştırılmış. Gizli anahtarlar sk_test_ / rk_test_ veya sk_live_ / rk_live_ ile, webhook sırları whsec_ ile başlar.

Müşteri Confirm Order sonrası bir hata görüyor: Logging seçeneğini açın ve eklenti sayfasındaki Log alanına bakın. Bu ödeme yöntemi kullanılamıyor. Lütfen ödeme sayfasını yeniden yükleyin. mesajı, ödeme oturumunun artık siparişle eşleşmediği veya bu sırada ödeme yönteminin kapatıldığı anlamına gelir: müşteri ödeme sayfasını yeniler. Yanlış bir anahtar, ödeme yönteminin düzgün yapılandırılmadığı mesajını verir. Para biriminin Stripe asgari tutarının altında kalan bir sipariş toplamı (örneğin 0,50 EUR) Stripe ile ödenemez.

Test ödemeleri canlı bir ödemeyi onaylamaz: 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ş inceleme durumunda: VibeFox Stripe Gateway sekmesindeki notları okuyun (bkz. Sipariş durumları), ardından siparişi yerine getirin veya ödemeyi iade edin.

Sekmede iade formu yok: sekme nedenini belirtir: ödeme henüz onaylanmadı, tamamen iade edildi veya kullanıcı grubunuzun eklentiyi değiştirme yetkisi yok.

İade, mod ile ilgili bir mesajla başarısız oluyor: ödeme test veya canlı modda yapıldı ve o modun gizli anahtarı ayarlanmamış. Girin ve tekrar deneyin.

Geliştiriciler için: Stripe oturumu oluşturulmadan önce eklenti, oturum parametreleri ve sipariş ile OpenCart olayı strg_checkout_session_params'ı tetikler.

Kaldırma

Extensions > Extensions sayfasına gidin, türü Payments olarak seçin ve VibeFox Stripe Gateway yanındaki Uninstall düğmesine (kırmızı −) 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ılan değerlerine döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te ayrıca olayları ve bakım modunda webhook'a izin veren başlangıç eylemi de kaldırılır). Delete Data on Uninstall açıksa, diğer ağ geçidi ayarları (başlık, açıklama, test modu, anahtarlar, webhook sırları, günlük kaydı) ve günlük silinir. Kapalıysa, sonraki bir yeniden kurulum için saklanırlar. Stripe işlemleri ve iadeleri her zaman korunur; bu nedenle daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te eklenti dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer sayfasına gidin, kurulu eklentiler listesinde VibeFox Stripe Gateway yanındaki Uninstall düğmesine (turuncu −) tıklayın, ardından yüklenen paketi kaldırmak için Delete düğmesine (kırmızı çöp kutusu) tıklayın.

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