VibeFox Omise 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.

HTTPS: Kart alanları ödeme sayfanızda yer aldığı için ödeme sayfası HTTPS üzerinden sunulmalıdır. Kart verileri yine de hiçbir zaman sunucunuza ulaşmaz. Omise webhook'ları yalnızca HTTPS adreslerine gönderir ve bankanın 3-D Secure sayfası bir HTTPS adresi olmalıdır.

Para birimi: THB, JPY, SGD, MYR, USD, EUR, GBP, AUD, CAD, CHF, CNY, DKK, HKD para birimlerinden biri. Müşteri başka bir para biriminde ödeme yaptığında ödeme yöntemi ödeme sayfasında gizlenir.

Omise hesabı: Test ve canlı mod için Omise hesabınızın genel anahtarına ve gizli anahtarına, Omise panelindeki Settings > Keys bölümünden ihtiyacınız vardır; ayrıca Settings > Webhooks bölümünde bir webhook uç noktasına ihtiyacınız vardır (bkz. Configuration).

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek bir alan adında çalışır.

Kurulum

İndirme, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_omise_payment-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_omise_payment.ocmod.zip bulunur. Yalnızca kullandığınız OpenCart sürümünün paketini kurun. Lisans anahtarı her iki sürüm için aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_omise_payment-oc3-(version).ocmod.zip dosyasını seçin. Eklentide OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications bölümü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 bölümüne gidin ve tür olarak Payments seçin. VibeFox Omise Payment öğesini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme eklentileri listesini değiştirme iznine sahip olması gerekir.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem düğmesi) tıklayın. VibeFox lisans anahtarınızı sayfanın üstündeki lisans bloğunda License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. License key).

4. Omise test ve canlı anahtarlarınızı girin ve ayarlar sayfasında gösterilen webhook URL'sini Omise panelinde ekleyin (bkz. Configuration).

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

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_omise_payment.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış bir paket çalışmaz.

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

3. Extensions > Extensions bölümüne gidin ve tür olarak Payments seçin. VibeFox Omise Payment öğesini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını, Omise anahtarlarını ve webhook'u OpenCart 3 için 3. ila 5. adımlardaki gibi girin. Ayarlar sayfası ve alanları her iki sürümde de aynıdır. Yalnızca webhook URL'si farklıdır (bkz. Ödeme ve 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 Omise Payment > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa, test modu açıkken Test mode is on — orders are charged with the test keys, no real money is moved. mesajını gösterir; geçerli modun genel veya gizli anahtarı eksikse uyarır (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve Omise mağazanızın varsayılan para birimini kabul etmiyorsa uyarır. Eklentiyi düzenleme iznine sahip değilseniz sayfa ayarları gösterir ancak kaydedemez.

Kaydetme sırasında boş veya 128 karakterden uzun bir Title, tam sayı olmayan bir Sort Order, 0 veya daha büyük bir sayı olmayan bir Total ya da bilinmeyen bir sipariş durumu kaydetmeyi durdurur: hiçbir şey kaydedilmez ve hata gösterilir. Yanlış önekli bir anahtar (örneğin canlı bir alana girilen test anahtarı) kaydedilmez: önceki değer korunur, bir uyarı alanı belirtir ve diğer alanlar kaydedilir.

Omise

Enable/Disable: Enable card payments via Omise ödeme yöntemini açar veya kapatır. Varsayılan: off.

Title: müşterinin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Credit / Debit Card. Zorunlu, 128 karaktere kadar.

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

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

Geo Zone: kart formunu yalnızca seçilen coğrafi bölgedeki ödeme adresleri için gösterir. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde ayarlanır. OpenCart 4'te mağaza ödeme adresi istemediğinde teslimat adresi kullanılır.

Total: ödeme yönteminin sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası toplamı. Herhangi bir tutar için sunmak üzere boş bırakın.

API anahtarları

Anahtarlarınızı Omise panelinde Settings > Keys bölümünde bulabilirsiniz (sayfa oraya bir bağlantı içerir). Test anahtarları pkey_test_ ve skey_test_ ile, canlı anahtarlar pkey_ ve skey_ ile başlar.

Test mode: test anahtarlarını kullanır, gerçek tahsilat yapılmaz. İki anahtarı birlikte değiştirir. Bir siparişin tahsilatları, iadeleri ve durum kontrolleri her zaman siparişin ödendiği modun anahtarlarını kullanır. Varsayılan: on.

Test public key: test modunun genel anahtarı, pkey_test_..., tarayıcıda Omise.js tarafından kullanılır.

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

Live public key: canlı modun genel anahtarı, pkey_..., tarayıcıda Omise.js tarafından kullanılır.

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

Kayıtlı gizli anahtarlar bir daha gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı bir anahtarı kaldırmak için alanın altındaki Clear the saved value on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Ödeme ve webhook

Webhook URL: mağazanızın webhook adresi. OpenCart 3'te https://your-store/index.php?route=extension/payment/wcp_omise_payment/webhook, OpenCart 4'te https://your-store/index.php?route=extension/wcp_omise_payment/payment/wcp_omise_payment.webhook biçimindedir ve OpenCart kurulumunuzun vitrin adresinden oluşturulur. Ayarların gösterdiği biçimde tam olarak kopyalayın ve Omise panelinde Settings > Webhooks bölümüne ekleyin (yalnızca HTTPS). Eklenti bu olayları işler (bunlar bu bölümde de listelenir):

Omise webhook'ları imzalamaz, bu nedenle webhook içeriğine asla güvenilmez: tahsilat, bu mağaza tarafından o sipariş için oluşturulmuş olmalıdır ve durumu, ödemenin modunun gizli anahtarıyla Omise API'sinden yeniden okunur. Webhook olmadan, müşterisi 3-D Secure sırasında tarayıcıyı kapatan bir sipariş otomatik olarak güncellenmez ve Omise panelinde yapılan yakalamalar siz Sync payment status düğmesine tıklayana kadar algılanmaz.

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

Per-charge webhook: her tahsilatla webhook URL'sini gönderir. Birden çok mağazanın tek bir Omise hesabını paylaştığı durumlarda kullanışlıdır. Yalnızca mağaza HTTPS kullanıyorsa çalışır; aksi halde panel webhook'u kullanılır. Varsayılan: off.

Siparişler

Sipariş, Confirm Order adımında durumsuz (eksik sipariş) olarak oluşturulur ve yalnızca Omise kart için yanıt verdikten sonra bir durum alır. OpenCart'ta On hold durumu yoktur: varsayılan olarak yetkilendirilmiş, incelemede ve beklemede durumların tümü Pending'dir ve sipariş sekmesi ile notlar bunları birbirinden ayırır. Kendi durumlarınızı System > Localisation > Order Statuses bölümünde oluşturabilir ve burada seçebilirsiniz.

Order Status After Payment: kart tahsil edildi (Capture immediately veya daha sonra bir tahsilat). Varsayılan: Processing.

Authorized Status: Authorize only: tutar ayrılmıştır, henüz tahsil edilmemiştir. Varsayılan: Pending.

On Hold (Review) Status: tahsil edilen tutar veya para birimi siparişten farklıdır. Varsayılan: Pending.

Awaiting Payment Status: müşteri işlemi tamamladı, ancak Omise tahsilatı henüz onaylamadı. Varsayılan: Pending.

Failed Status: bir durumu olan siparişin bekleyen tahsilatı sonradan başarısız oldu. Varsayılan: Failed.

Canceled Status: tahsilatın süresi doldu veya yetkilendirme iptal edildi; hiçbir para alınmadı. Varsayılan: Canceled.

Refunded Status: ödeme sipariş sekmesinden tamamen iade edildikten sonra ayarlanır. Varsayılan: Refunded.

Gelişmiş

Debug log: API isteklerini ve ödeme olaylarını OpenCart günlük klasöründe (storage/logs) bulunan omise_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında omise_p_debug.old.log.php dosyasına taşınır. Anahtarlar, belirteçler ve kart verileri hiçbir zaman günlüğe yazılmaz. Varsayılan: off. Kapalıyken hiçbir şey yazılmaz, hatalar dahil; bu nedenle bir sorunu araştırırken açın.

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

Delete data on uninstall: açıksa eklentinin kaldırılması sırasında ayarlar ve hata ayıklama günlüğü silinir. Siparişlerin Omise tahsilatları ve iadeleri ödeme geçmişidir ve her zaman saklanır. Varsayılan: off.

İç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 Credit / Debit Card). Confirm Order adımında müşteri açıklamanızı ve kart formunu görür: 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. mesajını gösterir. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. OpenCart 4'te müşteri ödeme yöntemini, ödeme yöntemi bloğundaki Choose düğmesiyle Payment method options penceresinden seçer; kart formu, ödeme sayfasının altındaki onay bölümünde, Confirm Order düğmesinin üstündedir. Müşteri Confirm Order düğmesine tıkladığında Omise.js, siparişin ödeme adresini kullanarak kartı tarayıcıda tek kullanımlık bir belirteçe dönüştürür (OpenCart 4'te, mağaza ödeme adresi istemediğinde teslimat adresi kullanılır). Kart alanları hiçbir zaman mağazanıza gönderilmez. Eksik veya geçersiz alanlar formun üstünde gösterilir, örneğin Please enter a valid card number.

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

Sipariş, yalnızca Omise onayladıktan sonra ödenmiş olarak işaretlenir: tahsilatın yakalanmış olması ve tutarının ile para biriminin siparişle eşleşmesi gerekir. Sipariş daha sonra OpenCart'ın standart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle bir durum alır ve müşteri Your card payment has been received. mesajını içeren OpenCart sipariş başarı sayfasını görür. Authorize only ile sayfa Your card payment has been authorized. The amount will be charged when your order is processed. der. Omise ödemeyi hâlâ beklemede gösteriyorsa sipariş Awaiting Payment Status durumunu alır ve sayfa Your payment is being confirmed by Omise. You will receive an e-mail as soon as it is confirmed — please do not pay again. der. Omise ödemeyi daha sonra onaylar veya reddederse (webhook ya da müşterinin dönüşü ile), yeni sipariş durumu müşteri bildirimiyle gönderilir ve OpenCart bunu müşteriye e-posta ile iletir. Ödeme 3-D Secure sonrasında hemen onaylanamazsa bir Payment confirmation sayfası 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ı ve bir Check again düğmesini gösterir.

Kart reddedilirse sipariş durumsuz kalır. Müşteri Confirm Order adımında Payment failed: ve bir nedenle (örneğin yetersiz bakiye, geçersiz güvenlik kodu veya kart veren bankanın reddi) kalır ve aynı sepetle yeniden deneyebilir. 3-D Secure başarısız olursa müşteri nedeniyle birlikte ödeme sayfasına döner; bu arada tahsilatın süresi dolduysa veya iptal edildiyse mesaj The payment was not completed. Please try again. olur. OpenCart 4'te 3-D Secure sonrasındaki bu mesajlar ödeme sayfasının üstünde gösterilir.

Yeniden deneme hiçbir zaman iki kez tahsilat yapmaz. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise ödeme için tek bir sipariş tutar ve onu günceller, bu nedenle reddedilen bir karttan veya başarısız bir 3-D Secure'dan sonra müşteri aynı siparişi yeni bir tahsilatla öder. Sepetin önceki tahsilatı zaten ödenmiş veya yetkilendirilmişse, o sipariş kendi durumunu alır ve yeni bir tahsilat yapılmaz. Tamamlanmamış bir 3-D Secure denemesi, yeni bir tahsilat yapılmadan önce sona erer. Zaten ödenmiş bir sepet için ikinci bir tahsilat hâlâ ödenmişse (örneğin başka bir tarayıcı sekmesinde), hiçbir sipariş değiştirilmez ve ödenmiş siparişteki bir not, bunu Omise panelinde iade etmeniz ya da iptal etmeniz için sizden ister.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme sayfasında tutar. Bu arada sipariş kapatıldıysa (örneğin tahsilatı başarısız olduysa veya süresi dolduysa ya da siz iptal edip iade ettiyseniz), müşteri Your previous order was cancelled or refunded. Please confirm the order again to pay with a new order. mesajıyla ödeme sayfasına geri gönderilir ve bir sonraki Confirm Order yeni bir sipariş öder. Bu sipariş zaten ödenmişse ve sepette artık başka ürünler veya adetler varsa, müşteri yine ödeme sayfasına geri gönderilir ve yeni sepet yeni bir sipariş alır.

Webhook, mağaza bakım modundayken de çalışır: OpenCart 3 ödeme eklentilerinin isteklerine izin verir ve OpenCart 4'te eklenti, webhook'un ve müşterinin 3-D Secure'dan dönüşünün geçmesine izin veren bir başlangıç eylemi ekler.

Eklenti yalnızca kartları kabul eder. Diğer Omise ödeme yöntemlerini (PromptPay, TrueMoney, mobil bankacılık, taksitler), kayıtlı kartları veya Omise müşterilerini, abonelikleri ve kısmi tahsilatı desteklemez.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): Müşteri 3-D Secure aşamasındadır veya kart reddedilmiştir. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

OpenCart 4'te, ödeme sayfasının ödenmemiş bir siparişi Voided durumunu alabilir; bu durum, müşteri Confirm Order adımına döndüğünde OpenCart 4 tarafından ayarlanır. Eklenti böyle bir siparişi durumsuz sipariş olarak ele alır ve sonraki bir ödeme yine de onu onaylar.

Order Status After Payment (varsayılan Processing): ödeme onaylandı. Bir notta tutar, Omise tahsilatı (chrg_...) ve onayın nasıl gerçekleştiği (ödeme sayfası, 3-D Secure dönüşü, webhook, ödeme yeniden denemesi, manuel yakalama veya manuel eşitleme) gösterilir.

Authorized Status (varsayılan Pending): kart Authorize only ile yetkilendirildi. Capture payment veya Void authorization kullanın.

Awaiting Payment Status (varsayılan Pending): Omise ödemeyi henüz onaylamadı. Webhook veya Sync payment status siparişi günceller.

On Hold (Review) Status (varsayılan Pending): tahsil edilen tutar veya para birimi siparişten farklıdır; örneğin sipariş 3-D Secure sırasında değiştirilmiştir. Not her iki değeri de gösterir. Siparişi kontrol edin ve yerine getirin veya ödemeyi iade edin.

Failed Status (varsayılan Failed): bekleyen bir ödeme sonradan başarısız oldu. Ödenmiş bir sipariş, sonraki bir başarısızlık olayıyla asla düşürülmez.

Canceled Status (varsayılan Canceled): tahsilatın süresi doldu veya yetkilendirme iptal edildi.

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

Zaten iptal edilmiş veya iade edilmiş durumdaki bir siparişe ödenmiş ya da yetkilendirilmiş bir tahsilat gelirse sipariş yeniden açılmaz. Bir not, Omise panelini kontrol edip siparişi manuel olarak iade etmeniz veya yeniden açmanız için sizden ister.

Notlar, müşterinin görmediği siparişin History bölümündeki girişlerdir.

VibeFox Omise Payment sekmesi

Sales > Orders bölümünde Omise ile ödenmiş bir siparişi açın. Sipariş sayfasının alt kısmında, History ve Additional yanında bulunan VibeFox Omise Payment sekmesi; test ödemeleri için Test etiketiyle birlikte tahsilat kimliğini, ödeme işlemini, tahsilat durumunu, kart markasını ve son haneleri, Charged / order / refunded tutarlarını, düğmeleri, iade formunu, iade geçmişini ve siparişin Omise notes bilgilerini gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir. Düğmeler, eklentiyi düzenleme iznini (System > Users > User Groups bölümünde ayarlanır) ve ödemenin yapıldığı modun gizli anahtarını gerektirir. Her işlemin sonucu sekmede gösterilir.

Capture payment: yetkilendirilen tutarın tamamını yakalar ve siparişi Order Status After Payment durumuna ayarlar. Yalnızca yetkilendirilmiş siparişlerde gösterilir.

Void authorization: yetkilendirmeyi iptal eder; hiçbir para yakalanmaz ve sipariş Canceled Status durumuna ayarlanır. Yalnızca yetkilendirilmiş siparişlerde gösterilir.

Sync payment status: örneğin Omise panelinde bir yakalama veya iadeden sonra tahsilatı Omise'den yeniden okur, siparişi günceller ve tahsilat durumu ile Omise'de toplam iade edilen tutarı içeren bir not ekler.

Sekmeden yapılan durum değişiklikleri müşteriye bildirim göndermez ve stok hareketi yaratmaz; tıpkı manuel bir durum değişikliği gibi.

İadeler

Sekmede Amount alanına tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) yazın ve Refund via Omise düğmesine tıklayın. Refund this amount through Omise? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. İadeler, Omise'in tahsil ettiği tutar ve para biriminde yapılır; bu nedenle tutar veya para birimi uyuşmazlığından sonra, sipariş toplamına değil müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı modda gönderilir; bu nedenle o modun gizli anahtarı ayarlanmış olmalıdır. Neden, iadeyle birlikte Omise'de saklanır. Başarılı bir iade, Omise iade kimliğiyle birlikte iade geçmişine ve notlara eklenir. Tam iade siparişi Refunded Status durumuna ayarlar; kısmi iade durumu değiştirmez. Henüz yakalanmamış bir yetkilendirme için yalnızca tam iade mümkündür ve yetkilendirmeyi iptal eder. Omise iadeyi reddederse sekme, Omise mesajıyla birlikte Refund failed. gösterir ve hiçbir iade kaydedilmez.

Sales > Returns bölümündeki ürün iadeleri Omise üzerinden para geri göndermez. Omise panelinde yapılan iadeler OpenCart'a kaydedilmez; Sync payment status iade edilen toplamı gösterir.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Omise Payment lisans bloğu, Extensions > Extensions > Payments > VibeFox Omise Payment > Edit sayfasında ayarların üstünde yer alan ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınızı) ve 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 düğmelerini gösterir. Bunların altında Product: opencart-payment-omise satırı ve hesabınızdaki vibefox.net hesabını açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca eklenti için Modify izni olan yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini bildirir; örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihli License expired on. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı 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. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada (unlicensed — visible to admins only) işaretiyle hâlâ görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Edit sayfasını bir kez açtıktan sonra yönetici paneli Dashboard bölümünde bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır ve iadeler çalışmaya devam eder.

Bir lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici paneli Dashboard veya Edit sayfası açıldığında durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, ardından haftada bir kez. Cron işi gerekmez. Eklentinin kaldırılması her zaman lisans anahtarını ve lisans durumunu siler.

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 her iki anahtarının girildiğini (test modunda test anahtarları, aksi halde canlı anahtarlar) ve müşterinin desteklenen para birimlerinden biriyle ödeme yaptığını kontrol edin. Anahtarlar eksikse ayarlar sayfası uyarı gösterir. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total tutarına ulaştığını kontrol edin.

Ödeme gerçekleşti, ama sipariş durumsuz kaldı veya Awaiting Payment Status durumunda: webhook çalışmıyor. Omise panelinde webhook URL'sinin Webhook URL alanında gösterilen adresle birebir aynı olduğunu ve HTTPS kullandığını kontrol edin. Mevcut bir siparişte Sync payment status düğmesine tıklayın. Webhook yanıtlarını görmek için Debug log seçeneğini açın.

Webhook şu yanıtları veriyor: Charge ID does not match order veya Order not found: olaydaki tahsilat, bu mağaza tarafından o sipariş için oluşturulmamış. Hiçbir şey değiştirilmez.

Webhook şu yanıtları veriyor: Order is being processed, retry later veya Failed to verify charge: sepet aynı anda başka bir istek tarafından kilitlendi, Omise API'sine ulaşılamadı veya ödeme modunun gizli anahtarı eksik. Omise webhook'u yeniden dener.

Webhook şu yanıtı veriyor: The order status could not be set, retry later: sipariş durumu o anda ayarlanamadı. Omise webhook'u yeniden dener. Nedenini görmek için Debug log seçeneğini açın.

Webhook URL'si tarayıcıda Method not allowed gösteriyor: bu normaldir. URL yalnızca Omise'den gelen istekleri kabul eder.

Kaydetmede uyarı: key must start with ... veya must be a live key: bir anahtar yanlış alana yapıştırıldı ve kaydedilmedi. Test anahtarları pkey_test_ / skey_test_ ile, canlı anahtarlar pkey_ / skey_ ile başlar.

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

Müşteri We could not reach the payment provider mesajını görüyor: tahsilat oluşturulurken Omise'den geçerli bir yanıt gelmedi. Tahsilat yine de oluşturulmuş olabilir; müşteri yeniden ödeme yapmadan önce Omise panelini kontrol edin.

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

Sipariş ödeme sonrası inceleme durumunda: VibeFox Omise Payment sekmesindeki notları okuyun (bkz. Order statuses); ardından siparişi yerine getirin 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.

Yetkilendirilmiş bir siparişin kısmi iadesi başarısız oluyor: ödeme yalnızca yetkilendirildi. Önce yakalayın veya iptal etmek için tam tutarı iade edin.

Kaldırma

Extensions > Extensions bölümüne gidin, tür olarak Payments seçin ve VibeFox Omise Payment yanındaki Uninstall düğmesine (kırmızı − düğmesi) 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ılanlarına döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te ayrıca olayları ve bakım modunda webhook'un ve 3-D Secure dönüşünün geçmesine izin veren başlangıç eylemi). Delete data on uninstall açıksa diğer ayarlar (başlık, açıklama, test modu, anahtarlar, ödeme işlemi, webhook ve günlükleme seçenekleri) ve hata ayıklama günlüğü silinir. Kapalıysa sonraki bir yeniden kurulum için saklanır. Omise tahsilatları ve iadeleri her zaman saklanır; 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 bölümüne gidin, yüklü eklentiler listesinde VibeFox Omise Payment yanındaki Uninstall düğmesine (turuncu − düğmesi) ve ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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