VibeFox Omise for WooCommerce — Yardım

Gereksinimler

WordPress: 6.2 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleştirilmez; WooCommerce daha sonra devre dışı bırakılırsa ağ geçidi yüklenmez ve bir yönetici bildirimi gösterilir.

PHP: 8.0 veya üzeri.

HTTPS: kart alanları ödeme sayfanızdadır, bu nedenle ödeme sayfası HTTPS üzerinden sunulmalı ve güvenilmeyen betiklerden arındırılmış olmalıdır. Kart verileri yine de sunucunuza hiçbir zaman ulaşmaz. Omise webhook'ları yalnızca HTTPS adreslerine gönderir.

Mağaza para birimi: THB, JPY, SGD, MYR, USD, EUR, GBP, AUD, CAD, CHF, CNY, DKK, HKD para birimlerinden biri. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir.

Omise hesabı: test ve canlı mod için Omise hesabınızın genel ve gizli anahtarlarına, Omise panelinde Settings > Keys altından ulaşabilirsiniz. Ayrıca Settings > Webhooks altında bir webhook uç noktası gerekir (bkz. Yapılandırma).

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar 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. Alternatif olarak wcp_omise_payment klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Payments > Omise > 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. Omise test ve canlı anahtarlarınızı girin ve ayarlar sayfasında gösterilen webhook URL'sini Omise panelinde ekleyin (bkz. Yapılandırma).

6. Enable/Disable seçeneğini etkinleştirin. 4242 4242 4242 4242 gibi bir Omise test 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 bulunur: WooCommerce > Settings > Payments > Omise. Test modu açıkken sayfa alanların üzerinde Test mode is on — orders are charged with the test keys, no real money is moved. uyarısını gösterir; geçerli modun genel veya gizli anahtarı eksikse ya da mağaza para birimi Omise tarafından desteklenmiyorsa da sizi uyarır. Her iki durumda da ödeme yöntemi ödeme sayfasında gizlenir. Ödeme yöntemleri listesinde Omise, geçerli modun iki anahtarı da girilene kadar kurulum gerektiren olarak işaretlenir.

Genel

Enable/Disable: Enable card payments via Omise ö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: Credit / Debit Card.

Description: ödeme sayfasında kart formunun üstünde gösterilen metin. Varsayılan: Pay securely with your credit or debit card via Omise.

API anahtarları

Anahtarlarınızı Omise panelinde Settings > Keys altında bulabilirsiniz. Test anahtarları pkey_test_ ve skey_test_ ile, canlı anahtarlar pkey_ ve skey_ ile başlar. Kaydettiğinizde yanlış önekli bir anahtar (örneğin canlı bir alana girilen test anahtarı) bir hatayla reddedilir ve önceki değer korunur.

Test mode: Use the test keys (no real charges). İki anahtarı birlikte değiştirir. Bir siparişin iadeleri, tahsilatları ve durum kontrolleri her zaman siparişin ödendiği modun anahtarlarını kullanır. Varsayılan: açık.

Test public key: test modunun genel anahtarı, pkey_test_...

Test secret key: test modunun gizli anahtarı, skey_test_...

Live public key: canlı modun genel anahtarı, pkey_...

Live secret key: canlı modun gizli anahtarı, skey_...

Ödeme ve webhook

Bu bölüm mağazanızın webhook URL'sini gösterir. URL şuna benzer: https://your-site/wp-json/omise-payment/v1/webhook. Ayarlarda gösterildiği gibi aynen kopyalayın ve Omise panelinde Settings > Webhooks altına ekleyin (yalnızca HTTPS). Eklenti şu olayları işler:

Webhook içeriğine asla güvenilmez: tahsilat siparişte kayıtlı olan olmalıdır ve durumu, siparişin modunun anahtarlarıyla Omise API'sinden yeniden okunur. Webhook olmazsa, müşterisi 3-D Secure sırasında tarayıcıyı kapatan bir sipariş, Omise: Sync payment status çalıştırana kadar Beklemede kalır; Omise panelinde yapılan tahsilatlar da otomatik alınmaz.

Payment action: kart tutarına ne olacağı.

Per-charge webhook: Send the webhook URL with every charge. Birden fazla mağazanın tek bir Omise hesabını paylaştığı durumlarda kullanışlıdır. Yalnızca site HTTPS kullanıyorsa çalışır; aksi halde panel webhook'u kullanılır. Varsayılan: kapalı.

Gelişmiş

Debug log: Log API requests and payment events ödeme adımlarını WooCommerce > Status > Logs altına, wcp_omise_payment kaynağıyla yazar. Anahtarlar, jetonlar ve kart verileri hiçbir zaman günlüğe yazılmaz. Varsayılan: kapalı.

Delete data on uninstall: Remove the settings and debug logs when the plugin is deleted. Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak Credit / Debit Card) ve kart formunu doldurur: Name on card, Card number, Expiry month (MM), Expiry year (YYYY) ve Security code (CVV). Test modunda form TEST MODE — use Omise test cards (e.g. 4242 4242 4242 4242), no real charges are made. ifadesini gösterir. Sipariş verildiğinde Omise.js, kartı tarayıcıda tek kullanımlık bir jetona dönüştürür. Kart alanları hiçbir zaman sunucunuza gönderilmez.

Mağazanız, tahsilatı sipariş tutarı için sipariş para biriminde gizli anahtarla oluşturur. Tahsilat açıklaması mağaza adı ve sipariş numarasıdır; sipariş kimliği tahsilatın meta verilerinde saklanır. Banka 3-D Secure istiyorsa müşteri bankaya yönlendirilir ve ardından mağazanıza geri döner. Sonuç her zaman Omise API'sinden yeniden okunur.

Sipariş, Omise onaylayana kadar ödenmiş olarak işaretlenmez: tahsilat çekilmiş olmalı, tutarı ve para birimi siparişle eşleşmelidir. Authorize only ile yetkilendirme başarılı olduğunda sipariş Beklemede durumuna alınır. Müşteri sipariş alındı sayfasını görür.

Kart reddedilirse müşteri ödeme sayfasında kalır; Payment failed: mesajı ve bir neden görür (örneğin yetersiz bakiye, geçersiz güvenlik kodu veya kart veren kuruluşun reddi) ve tekrar deneyebilir. Başarısız bir 3-D Secure'den sonra müşteri Pay for order sayfasına yönlendirilir. 3-D Secure'den hemen sonra ödeme onaylanamazsa müşteri We could not confirm your payment yet. If your card was charged, the order will be updated automatically — please do not pay again. mesajını görür.

Yeniden deneme hiçbir zaman iki kez tahsilat yapmaz: siparişin önceki tahsilatı zaten ödenmiş ya da yetkilendirilmişse, sipariş yeni bir tahsilat yapılmadan tamamlanır. Tamamlanmamış bir 3-D Secure denemesi, yeni bir tahsilat oluşturulmadan önce sona erdirilir.

Ö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. Diğer Omise ödeme yöntemleri (PromptPay, TrueMoney, mobil bankacılık, taksit, Konbini, PayNow), kayıtlı kartlar veya Omise müşterileri, abonelikler ve kısmi tahsilat desteklenmez.

Siparişler ve iadeler

Sipariş durumları

Ödeme bekleniyor: müşteri 3-D Secure aşamasındadır veya ödemeyi henüz tamamlamamıştır.

İşleniyor: ödeme onaylandı. Yalnızca sanal, indirilebilir ürün içeren siparişler, WooCommerce'te olduğu gibi Tamamlandı durumuna geçer. Sipariş notu tutarı, tahsilat kimliğini ve onay şeklini gösterir (ödeme sayfası, 3-D Secure dönüşü, webhook, manuel tahsilat veya manuel senkronizasyon). İşlem kimliği, Omise tahsilat kimliğidir (chrg_...).

Beklemede, tahsilat bekleniyor: kart Authorize only ile yetkilendirildi. Omise: Capture payment veya Omise: Void authorization kullanın.

Beklemede, ödeme beklemede: Omise ödemeyi henüz onaylamadı; örneğin müşteri 3-D Secure sırasında tarayıcıyı kapattı. Webhook veya Omise: Sync payment status siparişi günceller.

Beklemede, uyuşmazlık: tahsilatın tutarı veya para birimi siparişten farklı. Not iki değeri de gösterir. Siparişi kontrol edin ve tamamlayın ya da ödemeyi iade edin.

Başarısız: ödeme reddedildi. Ödenmiş bir sipariş, sonradan gelen bir başarısızlık olayıyla asla geri alınmaz.

İptal edildi: tahsilatın süresi doldu veya yetkilendirme iptal edildi.

Zaten İptal edilmiş veya İade edilmiş bir sipariş için ödenmiş ya da yetkilendirilmiş bir tahsilat gelirse sipariş yeniden açılmaz. Bir not, Omise panelini kontrol edip ödemeyi manuel olarak iade etmenizi veya siparişi yeniden açmanızı ister.

Sipariş işlemleri

Omise: Capture payment: yetkilendirilen tutarın tamamını tahsil eder. Yalnızca yetkilendirilmiş siparişlerde gösterilir.

Omise: Void authorization: yetkilendirmeyi iptal eder; tahsilat yapılmaz ve sipariş iptal edilir. Yalnızca yetkilendirilmiş siparişlerde gösterilir.

Omise: Sync payment status: tahsilatı Omise'tan okur ve siparişi günceller. Not ayrıca Omise'ta toplam iade edilen tutarı gösterir.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Omise düğmesine tıklayın. Tam ve kısmi iadeler desteklenir. İade, ödemenin yapıldığı modda gönderilir; bu nedenle o modun gizli anahtarı girilmiş olmalıdır. Başarılı bir iade, Omise iade kimliğiyle birlikte sipariş notlarına eklenir. Henüz tahsil edilmemiş bir yetkilendirme için yalnızca tam iade mümkündür ve yetkilendirmeyi iptal eder. Omise iadeyi reddederse WooCommerce, Omise mesajıyla birlikte Refund failed. gösterir ve hiçbir iade kaydedilmez.

Omise panelinde yapılan iadeler WooCommerce iadesi olarak içe aktarılmaz. Omise: Sync payment status iade edilen toplamı gösterir; gerekiyorsa WooCommerce'te karşılık gelen manuel iadeleri oluşturun.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Omise 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 geçerli olduğu son tarihi ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key, 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 bir alan adında çalışır. Anahtarın bir siteden kaldırılması alan adı kotasını serbest bırakmaz. Kotayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Omise, ö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 (unlicensed — visible to admins only) etiketiyle görmeye devam eder; böylece bir 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: başlatılmış ödemeler yine onaylanır, tahsilat ve iadeler çalışmaya devam eder.

Lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Omise ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modun iki anahtarının da girildiğini (test modunda test anahtarları, diğer durumda canlı anahtarlar) ve para biriminin desteklendiğini kontrol edin. Pay for order sayfasında sipariş para birimi geçerlidir. Anahtarlar veya para birimi yanlışsa ayarlar sayfası bir uyarı gösterir.

Ödeme geçti ama sipariş Ödeme bekleniyor veya Beklemede durumunda kaldı: webhook çalışmıyor. Omise panelinde webhook URL'sinin ayarlarda gösterilenle birebir aynı ve HTTPS kullandığını kontrol edin. Ardından siparişte Omise: Sync payment status çalıştırın. Webhook yanıtlarını görmek için Debug log seçeneğini açın.

Webhook şu yanıtı veriyor: Earlier charge of the order, order not changed: olay, yeniden denemeyle değiştirilmiş olan siparişin önceki bir denemesine ait. Siparişte hiçbir şey değişmez. Bu önceki tahsilat Omise'ta hâlâ ödenmiş veya yetkilendirilmişse, bir sipariş notu bunu bir kez bildirir: Omise panelinde çifte ödeme olup olmadığını kontrol edin ve oradan iade edin ya da iptal edin.

Webhook şu yanıtı veriyor: Charge ID does not match order: olaydaki tahsilat başka bir siparişe ait. Hiçbir şey değişmez.

Webhook şu yanıtı veriyor: Order is being processed, retry later veya Failed to verify charge: sipariş başka bir istek tarafından kilitlenmiş ya da Omise API'sine ulaşılamamıştır. Omise webhook'u yeniden dener.

Kaydederken hata: key must start with ... veya must be a live key: bir anahtar yanlış alana yapıştırılmış. Test anahtarları pkey_test_ / skey_test_, canlı anahtarlar pkey_ / skey_ ile başlar.

Müşteri şunu görüyor: Card payments are temporarily unavailable: anahtarlar yanlış veya kart jetonu diğer moda ait (canlı modda test jetonu ya da tersi). Anahtarları ve Test mode seçeneğini kontrol edin.

Müşteri şunu görüyor: We could not reach the payment provider: tahsilat oluşturulurken Omise'tan geçerli bir yanıt gelmedi. Tahsilat yine de oluşturulmuş olabilir; sipariş notu, siparişten tekrar tahsilat yapmadan önce Omise panelini kontrol etmenizi ister.

Müşteri şunu görüyor: This order is already being paid: ödeme sayfası aynı anda iki kez gönderildi. Müşteri tekrar denemeden önce beklemeli ve e-postasını kontrol etmelidir.

Ödemeden sonra sipariş Beklemede: sipariş notunu okuyun. Sipariş tahsilat bekliyor, Omise ödemeyi henüz onaylamadı ya da tutar veya para birimi siparişle uyuşmuyor.

İade, mod ile ilgili bir mesajla başarısız oluyor: ödeme test ya da canlı modda yapıldı ve o modun gizli anahtarı girilmemiş. Anahtarı girin ve tekrar deneyin.

Yetkilendirilmiş bir siparişin kısmi iadesi başarısız oluyor: ödeme yalnızca yetkilendirilmiş. Önce tahsil edin ya da yetkilendirmeyi iptal etmek için tam tutarı iade edin.

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 kota serbest bırakı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 eklentiyi Plugins sayfasından devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman silinir. Ağ geçidi ayarları ve günlükler yalnızca Delete data on uninstall açıksa silinir. Aksi halde sonraki bir yeniden kurulum için saklanır. Siparişlerde kayıtlı Omise verileri ödeme geçmişinin parçasıdır ve her zaman korunur. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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