VibeFox Omise for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

PHP: 8.0 veya üzeri. Modül eski PHP sürümlerine kurulmayı reddeder.

HTTPS: kart alanları ödeme sayfanızda yer aldığı için ödeme sayfası HTTPS üzerinden sunulmalıdır. Yine de kart verileri sunucunuza hiçbir zaman 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. Başka bir para biriminde sepet için ödeme yöntemi ödeme sayfasında gösterilmez.

Omise hesabı: test ve canlı mod için Omise hesabınızın genel ve gizli anahtarına ihtiyacınız vardır; bunlar Omise panelinde Settings > Keys altında bulunur. 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. Yönetim panelinde Modules > Module Manager sayfasına gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme bittiğinde Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Omise Payment öğesini bulup Configure düğmesine tıklayın.

3. Configure sayfasının üstündeki lisans bloğunda License key alanına VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

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

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 ödeme deneyin, ardından Test mode seçeneğini kapatın.

Kurulumda modül üç sipariş durumu oluşturur: Omise payment authorized, Omise payment on hold ve Awaiting Omise payment. Ödeme yöntemi, kurulum sırasında aktif olan ülkeler için sunulur. Daha sonra başka ülkeleri etkinleştirirseniz, modüle onlar için Payment > Preferences bölümünde izin verin; burada modülü para birimi ve müşteri grubuna göre de sınırlayabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Omise Payment > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanların üstünde sayfa, test modu açık olduğu sürece 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 ve Omise mağazanızın varsayılan para birimini kabul etmediğinde de uyarır. Bu durumlarda ödeme yöntemi ödeme sayfasında gizlenir.

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 de kaydedilen addır. Varsayılan: Credit / Debit Card. Zorunlu.

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 alanda test anahtarı) kaydedilmez: önceki değer korunur ve bir uyarı gösterilir.

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_...

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_...

Kayıtlı gizli anahtarlar bir daha gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. mesajını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Clear saved secrets: bir gizli anahtarı işaretleyip Save düğmesine tıklayarak kaldırın. Boş alan kayıtlı değeri korur.

Ödeme ve webhook

Webhook URL: mağazanızın webhook adresi. Dostu URL'lerle şöyle görünür: https://your-shop/module/wcp_omise_payment/webhook. Ayarların gösterdiği gibi tam olarak kopyalayın ve Omise panelinde Settings > Webhooks altına ekleyin (yalnızca HTTPS). Modül şu olayları işler (bu bölümde de listelenmiştir):

Omise webhook'ları imzalamaz, bu nedenle webhook içeriğine hiçbir zaman güvenilmez: tahsilat, bu mağaza tarafından o sepet 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 oluşturulmaz ve Omise panelinde yapılan tahsilatlar siz Sync payment status seçeneğine tıklayana kadar alınmaz.

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

Per-charge webhook: her tahsilatla birlikte webhook URL'sini gönderir. Birden fazla 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.

Gelişmiş

Debug log: API isteklerini ve ödeme olaylarını modül klasöründeki logs/omise_p_debug.log.php dosyasına yazar. Dosya web üzerinden okunamaz. Anahtarlar, jetonlar ve kart verileri hiçbir zaman kaydedilmez. Varsayılan: off. Kapalıyken hatalar dahil hiçbir şey yazılmaz, bu yüzden bir sorunu araştırırken açın.

Log: günlüğün boyutunu ve son kayıtlarını, ayrıca temizleme düğmesini gösterir.

Delete data on uninstall: açıksa modülü kaldırdığınızda 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.

Ödeme sayfası

Ödeme adımında 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. mesajını gösterir. Müşteri siparişi verdiğinde Omise.js, sepetteki fatura adresini kullanarak kartı tarayıcıda tek kullanımlık bir jetona dönüştürür. Kart alanları hiçbir zaman mağazanıza gönderilmez. Eksik veya geçersiz alanlar formun altında gösterilir, örneğin Please enter a valid card number.

Mağazanız ardından gizli anahtarla, sepet para biriminde sepet toplamı için tahsilat oluşturur. Tahsilat açıklaması mağaza adı ve sepet numarasıdır; sepet kimliği tahsilatın meta verilerinde saklanır. Bu aşamada henüz sipariş yoktur. 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ş, Omise onayladıktan sonra ödenmiş olarak işaretlenir: tahsilat yakalanmış olmalı ve tutarı ile para birimi sepetle eşleşmelidir. Müşteri standart sipariş onay sayfasını Your card payment has been received. mesajıyla 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 bildiriyorsa sipariş Awaiting Omise payment durumunda oluşturulur 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. mesajını gösterir. Ödeme 3-D Secure'dan hemen sonra onaylanamazsa 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 Check again düğmesini gösterir.

Kart reddedilirse sipariş oluşturulmaz. Müşteri ödeme sayfasında Payment failed: ve bir nedenle kalır (örneğin yetersiz bakiye, geçersiz güvenlik kodu veya kart kuruluşunun reddi) ve aynı sepetle yeniden deneyebilir. 3-D Secure başarısız olursa müşteri neden bilgisiyle ödeme sayfasına döner; tahsilatın süresi dolmuş veya bu arada iptal edilmişse mesaj The payment was not completed. Please try again. olur.

Yeniden deneme hiçbir zaman çift tahsilat yapmaz: sepetin önceki tahsilatı zaten ödenmiş veya yetkilendirilmişse sipariş yeni bir tahsilat yapılmadan oluşturulur. Tamamlanmamış bir 3-D Secure denemesi, yeni tahsilat yapılmadan önce sona erdirilir. Zaten siparişi olan bir sepet için ikinci bir tahsilat hâlâ ödenmiş durumdaysa (örneğin başka bir tarayıcı sekmesinde), sipariş değiştirilmez ve bir not sizden bunu Omise panelinde iade etmenizi veya iptal etmenizi ister.

Webhook, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez.

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

Siparişler ve iadeler

Sipariş durumları

No order yet: müşteri 3-D Secure aşamasındadır veya kart reddedilmiştir. Yalnızca sepet mevcuttur.

Payment accepted: ödeme onaylandı. Ödeme, Omise tahsilat kimliği (chrg_...) ile işlem kimliği olarak kaydedilir; bir not tutarı, tahsilatı ve nasıl onaylandığını gösterir (ödeme sayfası, 3-D Secure dönüşü, webhook, ödeme yeniden denemesi, manuel tahsilat veya manuel senkronizasyon). Notlar siparişin özel mesajlarıdır ve yalnızca arka ofiste görünür.

Omise payment authorized: kart Authorize only ile yetkilendirildi. Capture payment veya Void authorization kullanın.

Awaiting Omise payment: Omise ödemeyi henüz onaylamadı. Webhook veya Sync payment status siparişi günceller.

Omise payment on hold: tahsilat tutarı veya para birimi siparişten farklı; örneğin 3-D Secure sırasında sepet değiştirildi. Not iki değeri de gösterir. Tahsil edilmiş bir ödeme yine de siparişe kaydedilir. Siparişi kontrol edin ve tamamlayın veya ödemeyi iade edin.

Payment error: beklemedeki bir ödeme daha sonra başarısız oldu. Ödenmiş bir sipariş, sonraki başarısız bir olayla hiçbir zaman düşürülmez.

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

Refunded: ödeme modül üzerinden tamamen iade edildi.

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

Omise ödeme bloğu

Sipariş sayfasında, tahsilat kimliği, ödeme işlemi, tahsilat durumu, kart markası ve son haneler, tahsil edilen, siparişin ve iade edilen tutarlar, test ödemeleri için bir Test mode rozeti ve iade geçmişiyle birlikte bir Omise payment bloğu görünür. Bloğun düğmeleri siparişleri düzenleme yetkisi ile ödemenin yapıldığı modun gizli anahtarını gerektirir. Modüller sayfalarına erişim gerekmez. Her işlemin sonucu bloğun üst kısmında gösterilir.

Capture payment: yetkilendirilen tutarın tamamını tahsil eder ve siparişi Payment accepted olarak ayarlar. Yalnızca yetkilendirilmiş siparişlerde gösterilir.

Void authorization: yetkilendirmeyi iptal eder; para tahsil edilmez ve sipariş Canceled olarak ayarlanır. Yalnızca yetkilendirilmiş siparişlerde gösterilir.

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

İadeler

Omise payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden 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'un 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çekte ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı modda gönderilir; bu yüzden o modun gizli anahtarı ayarlanmış olmalıdır. Neden, iadeyle birlikte Omise'ta kaydedilir. Başarılı bir iade, Omise iade kimliğiyle birlikte iade geçmişine ve notlara eklenir. Tam iade siparişi Refunded durumuna getirir; kısmi iade durumu değiştirmez. Henüz tahsil edilmemiş bir yetkilendirme için yalnızca tam iade mümkündür ve yetkilendirmeyi iptal eder. Omise iadeyi reddederse blok, Omise mesajıyla birlikte Refund failed. gösterir ve hiçbir iade kaydedilmez.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Omise üzerinden para iade etmez. Omise panelinde yapılan iadeler PrestaShop'ta kaydedilmez; Sync payment status iade edilen toplamı gösterir.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Omise Payment lisans bloğu, Modules > Module Manager > VibeFox Omise Payment > Configure sayfasının en üstündeki ilk bloktur ve ayarların üstünde yer alır. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu tarihi 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: presta-payment-omise satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisi olan çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli 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ı sınırına ulaşıldı veya tarihiyle birlikte Lisans şu tarihte sona erdi. Mağazanın 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 modül son bilinen durumla çalışmaya devam eder.

Bir anahtar yalnızca bir alan adında çalışır: çoklu mağaza kurulumunda da ana mağazanın alan adında. 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 adımı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 bir yöntem seçin. mesajını görür. PrestaShop vitrini arka ofise giriş yaptığınızı bilmez, bu nedenle ödeme yöntemi sizin için de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ancak ödeme adımında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder ve iadeler de çalışır.

Bir lisansın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, arka ofiste çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Omise does not appear at checkout: 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 sepet para biriminin desteklenen para birimlerinden biri olduğunu kontrol edin. Anahtarlar eksikse ayarlar sayfası bir uyarı gösterir. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşteri grubu için izinli olduğunu kontrol edin.

The payment went through, but no order was created or the order stays Awaiting Omise payment: webhook çalışmıyor. Omise panelinde webhook URL'sinin Webhook URL altında gösterilenle tam olarak 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 answers Charge ID does not match order or Order not found: olaydaki tahsilat, bu mağaza tarafından o sepet için oluşturulmadı. Hiçbir şey değiştirilmez.

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

Webhook answers The order could not be created, retry later: sipariş oluşturulamadı; örneğin modül devre dışı olduğu için. Nedenini görmek için Debug log seçeneğini açın.

The webhook URL shows Method not allowed in the browser: bu normaldir. URL yalnızca Omise'tan gelen istekleri kabul eder.

Warning on save: key must start with ... or 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.

The customer sees Card payments are temporarily unavailable: anahtarlar yanlış veya kart jetonu diğer moda ait (canlıda test jetonu ya da tersi). Anahtarları ve Test mode seçeneğini kontrol edin.

The customer sees We could not reach the payment provider: tahsilat oluşturulurken Omise'tan geçerli bir yanıt gelmedi. Tahsilat yine de oluşturulmuş olabilir; müşteri tekrar ödemeden önce Omise panelini kontrol edin.

The customer sees This order is already being paid: ödeme sayfası aynı anda iki kez gönderildi. Müşteri bir süre bekler ve tekrar denemeden önce e-postasını kontrol eder.

Order is Omise payment on hold after payment: siparişteki notu okuyun (bkz. Sipariş durumları), ardından siparişi tamamlayın veya ödemeyi iade edin.

Refund fails with a message about the mode: ödeme test veya canlı modda yapıldı ve o modun gizli anahtarı ayarlanmamış. Anahtarı girin ve tekrar deneyin.

Partial refund of an authorized order fails: ödeme yalnızca yetkilendirilmiş. Önce tahsil edin veya iptal etmek için tam tutarı iade edin.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Omise Payment yanındaki menüyü açın ve Uninstall seçeneğini seçin. Bu modülün lisans anahtarı ve lisans durumu her zaman kaldırılır. Delete data on uninstall açıksa ayarlar ve hata ayıklama günlüğü silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Omise tahsilatları ve iadeleri ile Omise payment authorized, Omise payment on hold ve Awaiting Omise payment sipariş durumları her zaman saklanır; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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