VibeFox KOMOJU for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. Eklenti onsuz etkinleşmez.

PHP: 8.0 veya üzeri.

HTTPS: sitenizde HTTPS olmalı ve KOMOJU webhook URL’sine erişebilmelidir.

KOMOJU account: gizli anahtar (sk_live_... ve test için sk_test_...) ile KOMOJU panelinde oluşturulan webhook’un gizli jetonu gerekir (bkz. Yapılandırma). Yayımlanabilir anahtar gerekmez.

Store currency: JPY, USD, EUR, TWD, KRW, PLN, GBP, HKD, SGD, NZD, AUD, IDR, MYR, PHP, THB, CNY, BRL, CHF, CAD veya VND. Diğer para birimlerinde yöntem gizlenir.

VibeFox license key: vibefox.net üzerinden alınır. Bir anahtar bir alan adında çalışır.

Kurulum

1. WordPress’te Plugins > Add New > Upload Plugin yolunu açın, eklentinin ZIP dosyasını seçip Install Now düğmesine tıklayın. wcp_komoju_payment klasörünü FTP ile /wp-content/plugins/ konumuna da yükleyebilirsiniz.

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

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

4. VibeFox lisans anahtarınızı üstteki lisans bloğuna girip Activate düğmesine tıklayın.

5. KOMOJU panelinde ayar sayfasındaki URL ve olaylarla bir webhook ekleyip gizli jetonunu kopyalayın (bkz. Yapılandırma).

6. Canlı gizli anahtarı ve webhook gizli jetonunu, sandbox için de test değerlerini girin. Enable/Disable seçeneğini açıp kaydedin.

Yapılandırma

Tüm ayarlar tek sayfadadır: WooCommerce > Settings > Payments > KOMOJU Payment. Test modunda alanların üstünde KOMOJU Sandbox Mode is enabled. görünür. Geçerli modda gizli anahtar yoksa (yöntem ödeme sayfasında gizlenir), webhook gizli jetonu yoksa (KOMOJU bildirimleri reddedilir, konbini ve havaleler asla onaylanmaz) veya para birimi desteklenmiyorsa uyarır. Ödeme yöntemleri listesinde geçerli modun gizli anahtarı olana kadar KOMOJU kurulum gerektiriyor olarak işaretlenir; sandbox açıkken test rozeti gösterir.

Genel

Enable/Disable: Enable KOMOJU Payment Gateway yöntemi açar veya kapatır. Varsayılan: off.

Title: müşterilerin ödeme sayfasında gördüğü yöntem adı. Varsayılan: KOMOJU Payment.

Description: ödeme sayfasında yöntemin altındaki metin. Varsayılan: Pay securely on the KOMOJU payment page: credit card, convenience store (konbini), PayPay, bank transfer and other local payment methods.

Canlı API anahtarları

Anahtarları KOMOJU panelinde bulun: gizli anahtar Settings > API keys, webhook gizli jetonu Settings > Webhooks altında (önce aşağıdaki webhook URL’sini ekleyin).

Live Secret Key: KOMOJU canlı gizli anahtarınız. sk_live_ ile başlar.

Live Webhook Secret Token: canlı webhook’un gizli jetonu. Her bildirimin imzasını doğrular.

Test modu

KOMOJU test ve canlı ödemeler için aynı API adresini kullanır: modu anahtar belirler. Siparişler ödeme modunu saklar; iadeler ve durum kontrolleri hep o modun anahtarını kullanır.

Sandbox Mode: Enable test mode (use the test keys below, no real payments). Varsayılan: off. Açıkken ödeme sayfasında açıklamanın üstünde Test mode görünür.

Sandbox Secret Key: KOMOJU test gizli anahtarınız. sk_test_ ile başlar.

Sandbox Webhook Secret Token: test webhook’unun gizli jetonu.

Webhook URL’si

Webhook, gecikmeli konbini ve havaleler dahil ödemeleri mağazanıza bildirir. KOMOJU panelinde Settings > Webhooks altında, ayarların bu bölümündeki URL’yi canlı ve test için ekleyin. Şu biçimdedir: https://your-site/wc-api/komoju_p_webhook/. URL’lerde dil öneki varsa adresi ayarlardan aynen kopyalayın. Sonra her webhook’un gizli jetonunu Live Webhook Secret Token veya Sandbox Webhook Secret Token alanına kopyalayın.

Şu olayları seçin:

Süre dolması, iptal ve hata olayları siparişi yalnızca geçerli ödemesi için değiştirir; önceki denemenin ödemesi başka yolla ödenmekte olan siparişi iptal edemez. Geçerli imzası olmayan webhook’lar reddedilir. İki gizli jetondan herhangi biriyle imzalananlar yalnızca aynı modun siparişleri için kabul edilir. Webhook olmadan kartlar müşteri dönünce onaylanır, ancak konbini ve havaleler asla onaylanmaz.

Gelişmiş

Invoice Prefix: KOMOJU’ya gönderilen sipariş numaralarının öneki. Aynı hesapla birden fazla mağaza kullanıyorsanız her mağaza için benzersiz yapın. Varsayılan: WC-.

Enable Logging: Log KOMOJU events and API calls, WooCommerce > Status > Logs içinde, kaynak wcp_komoju_payment, anahtar veya müşteri verisi olmadan. Hatalar daima kaydedilir. Varsayılan: off.

Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Sipariş verileri (KOMOJU ödeme kimlikleri) hep korunur. Varsayılan: off.

Ödeme

Müşteri yöntemi seçer (varsayılan KOMOJU Payment) ve sipariş verir. Eklenti, sipariş toplamı ve para birimiyle KOMOJU oturumu oluşturup müşteriyi KOMOJU ödeme sayfasına gönderir. Fatura e-postası, ad, fatura ve teslimat adresleri ile ürünler KOMOJU’ya iletilir. Sayfa site diline göre Japonca, İngilizce veya Korece gösterilir (diğer dillerde İngilizce). Müşteri orada yöntem seçer. Sunulan yöntemler KOMOJU hesabınıza ve siparişin para birimine bağlıdır.

Ödemeden sonra müşteri mağazaya döner. Eklenti sipariş modunun anahtarıyla API’den oturumu okur. Sipariş yalnızca KOMOJU onayıyla ödenmiş işaretlenir: imzalı webhook veya dönüşte oturum okuması. KOMOJU’ya o anda ulaşılamazsa müşteri sipariş alındı sayfasına şu mesajla gider: We could not confirm the payment status with KOMOJU yet. If you completed the payment, your order will be updated automatically in a few minutes.

Konbini ve havalede müşteri ödeme belgesi alır. Sipariş beklemeye alınır; müşteri ödeyip KOMOJU webhook gönderince tamamlanır. Belgenin süresi dolarsa iptal edilir.

Ödeme tamamlanmadıysa müşteri Pay for order sayfasına The payment was not completed. You can try again or choose another payment method. mesajıyla döner. Toplam aynıysa yeni deneme açık oturumu kullanır. Eski toplamlı oturum KOMOJU’da iptal edilir, arada ödenmiş oturum siparişi onaylar. Ödenmemiş sipariş iptal edilince (siz, müşteri veya WooCommerce stok tutma sayacı tarafından), açık KOMOJU oturumu da iptal edilir ve artık ödenemez.

KOMOJU ödemeyi başlatamazsa müşteri kısa bir mesaj görür; örneğin nedeni ile KOMOJU could not accept this payment:, KOMOJU payments are temporarily unavailable. Please choose another payment method or contact us. veya Payment error: Could not connect to KOMOJU. Please try again in a moment. Ayrıntılar sipariş notlarına ve günlüğe eklenir.

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

Eklentide sitenizde kart formu, kayıtlı kartlar veya abonelikler yoktur. Yöntemleri kısıtlamaz; KOMOJU sayfasında seçilirler. Elle tahsilat yoktur: bunun için yetkilendirilmiş ödemeleri KOMOJU panelinde tahsil edin; o zamana kadar sipariş beklemededir.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri KOMOJU’ya yönlendirildi ve henüz ödemedi veya KOMOJU henüz onaylamadı.

Processing or Completed: KOMOJU ödemeyi onayladı. WooCommerce ödenmiş siparişin olağan durumunu atar. Notta KOMOJU ödeme kimliği, yöntem ve onay yolu (webhook veya dönüş) vardır. İşlem kimliği KOMOJU ödeme kimliğidir ve sipariş ekranından paneldeki ödemeye bağlanır.

On hold: konbini veya havale belgesi oluşturuldu, ödeme bekleniyor veya ödeme KOMOJU panelinde tahsilat bekliyor. Tutar/para birimi uyuşmazsa ya da iptalden sonra tahsil edilirse de sipariş beklemeye alınır. Not açıklar. Siparişi yerine getirin veya ödemeyi iade edin.

Failed: ödeme başarısız. Müşteri yeniden deneyebilir.

Cancelled: belge süresi doldu veya ödeme iptal edildi.

Refunded: ödeme WooCommerce veya KOMOJU panelinden tamamen iade edildi.

Ödenmiş bir sipariş için ikinci ödeme tahsil edilirse sipariş tekrar değişmez. Not, mükerrerse KOMOJU panelinden iade etmenizi ister. İade edilmiş siparişler asla yeniden açılmaz.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girip Refund via KOMOJU Payment düğmesine tıklayın. Tam ve kısmi iadeler desteklenir. Siparişin ödendiği modun anahtarı kullanılır; gizli anahtarı ayarlanmış olmalıdır. Eklenti önce KOMOJU’da ödemeyi kontrol eder, kalan iade edilebilir tutarı aşan iadeleri reddeder. KOMOJU otomatik iade yapamazsa (konbini gibi yöntemler müşterinin banka bilgilerini gerektirebilir), hatası gösterilir ve hiçbir şey kaydedilmez: bunları KOMOJU panelinde işleyin. İade ancak KOMOJU onaylayınca tamamlanmış sayılır. Başarılı iade sipariş notlarına eklenir.

KOMOJU’nun başka para birimine çevirdiği ödemelerde (örneğin EUR siparişi için JPY konbini) WooCommerce’den yalnızca tam iade yapılabilir. Kısmi iadeleri KOMOJU panelinde yapın.

Paneldeki iadeler webhook ile gelir ve otomatik WooCommerce iadesi olarak kaydedilir. Tam iade durumu İade edildi yapar. Çevrilmiş ödemelerin paneldeki kısmi iadeleri yalnızca not edilir: karşılık gelen tutarı WooCommerce’de "Refund manually" ile kaydedin.

Lisans anahtarı

Eklenti vibefox.net’ten VibeFox anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > KOMOJU Payment üstündedir. Anahtarı License key alanına yapıştırıp Activate düğmesine tıklayın. Blok durum, örneğin geçerlilik tarihi ve alan adını gösterir. Yeniden kontrol için Check now, başka anahtar için Change key, 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 bir alan adında çalışır. Siteden kaldırmak alan adı yerini boşaltmaz. vibefox.net hesabınızdan boşaltın.

Etkin anahtar yoksa müşteriler ödeme sayfasında KOMOJU’yu görmez. Yine de ödeme başlarsa This payment method is not available. Please choose another one. görürler. Oturum açmış mağaza yöneticileri, satın almadan kurup test edebilmeniz için yöntemi (unlicensed — visible to admins only) işaretiyle görür. Eklentiler ve WooCommerce sayfalarında hatırlatma çıkar. Mevcut siparişler etkilenmez: başlatılan ödemeler onaylanır, iadeler çalışır.

Lisans bitince eklenti çalışır, ancak güncelleme ve destek yenileme gerektirir. Durum arka planda otomatik yeniden kontrol edilir.

Sorun giderme

KOMOJU ödeme sayfasında görünmüyor: etkin lisansı, Enable/Disable açık olmasını ve modun gizli anahtarını kontrol edin: sandbox için Sandbox Secret Key, canlı için Live Secret Key. Para birimi desteklenmelidir. Ayarlar eksikleri bildirir.

Ödeme yapıldı, sipariş Pending payment durumunda: webhook çalışmıyor. Panelde doğru mod için bulunduğunu, URL’nin ayarlarla aynı olduğunu ve olayları kontrol edin. Jetonu doğru alanda (Live Webhook Secret Token veya Sandbox Webhook Secret Token) doğrulayın; WooCommerce > Status > Logs, kaynak wcp_komoju_payment bölümüne bakın. Kartlar dönüşte de onaylanır, konbini ve havaleler yalnızca webhook ile.

Webhook Failed to verify KOMOJU webhook signature yanıtı veriyor: gizli jeton eksik veya başka webhook’a ait. KOMOJU bildirimi yeniden dener.

Webhook Mode mismatch, ignored yanıtı veriyor: siparişin ödendiğinden farklı modun jetonuyla imzalanmış. Canlı ve test için ayrı webhook ve jeton kullanın.

Webhook Order is busy, retry later veya Temporary error, retry later yanıtı veriyor: başka istek siparişi güncelliyordu veya ödeme o anda kontrol edilemedi. KOMOJU bildirimi yeniden dener.

Sipariş On hold durumunda: notu okuyun. Belge ödeme, ödeme panelde tahsilat bekliyor; tutar veya para birimi uyuşmadı ya da ödeme iptalden sonra geldi.

İade başarısız: mesajı okuyun. Ödeme modunun anahtarı eksik olabilir, otomatik iade mümkün olmayabilir (panelden yapın) veya çevrilmiş ödeme yalnızca tam iadeye izin verebilir.

Lisans bloğunda hata: mesajı izleyin. Anahtar başka alandaysa vibefox.net hesabından yer boşaltıp Check now düğmesine tıklayın. Site adresi değiştiyse yeni alanda etkinleştirmek için Check now kullanın. Lisans sunucusuna ulaşılamazsa son bilinen durumla çalışır.

Geliştiriciler para birimlerini komoju_p_supported_currencies, oturumu, örneğin yöntemleri komoju_p_session_params filtresiyle değiştirebilir.

Kaldırma

Devre dışı bırakmak tüm verileri korur. Kaldırmak için Plugins sayfasında devre dışı bırakıp silin. Lisans anahtarı ve durumu daima kaldırılır. Ağ geçidi ayarları ve günlükler yalnızca Delete data on uninstall açıkken kaldırılır; aksi halde yeniden kurulum için kalır. Siparişler ödeme notlarını ve işlem kimliklerini korur.

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