VibeFox GMO for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerinde kurulmayı reddeder.

Para birimi: Japon Yeni (JPY). GMO-PG yalnızca yen cinsinden tahsilat yapar; bu nedenle ödeme yöntemi yalnızca sepet para birimi JPY olduğunda gösterilir. Mağazanızda JPY yoksa International > Localization > Currencies bölümünden ekleyin.

GMO Payment Gateway hesabı: Link Type Plus içeren bir GMO-PG satıcı sözleşmesi. Test ve/veya canlı ortamın Shop ID, Shop password ve Link Type Plus Config ID (設定ID) bilgilerine ihtiyacınız vardır; ayrıca GMO-PG mağaza konsolunda sonuç bildirimi (結果通知) açık olmalıdır (bkz. Yapılandırma). Site ID ve Site password kullanılmaz.

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

Kurulum

1. Back office’te Modules > Module Manager bölümüne gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme tamamlandığında Configure düğmesine tıklayın ya da daha sonra modül listesinde VibeFox GMO Payment Gateway öğesini bulup Configure düğmesine tıklayın.

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

4. Test ve/veya canlı ortamın Shop ID, Shop password ve Config ID bilgilerini girin ve Environment seçeneğini belirleyin.

5. GMO-PG mağaza konsolunda 結果通知 (sonuç bildirimi) özelliğini açın ve ayarlarda gösterilen bildirim URL’sini girin (bkz. Yapılandırma).

6. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Test ortamında deneme ödemesi yapın, ardından Environment seçeneğini canlı ortama geçirin.

Kurulumda modül GMO-PG payment on hold sipariş durumunu oluşturur. PrestaShop, tüm para birimleri, ülkeler ve müşteri grupları için yeni bir ödeme modülü sunar. Bunları Payment > Preferences bölümünden sınırlayabilirsiniz; JPY’nin izinli kalması gerekir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox GMO Payment Gateway > Configure. Her Save düğmesi tüm sayfayı kaydeder. Alanların üzerinde sayfa, mağazanın varsayılan para biriminin JPY olmaması durumunda ve geçerli ortamın Shop ID, Shop password veya Config ID bilgisi eksikse uyarır (bu durumda ödeme yöntemi ödeme adımında gizlenir). Ayrıca hangi ortamın etkin olduğunu gösterir: TEST — payments go to pt01.mul-pay.jp with the test credentials, no real money is charged. veya PRODUCTION — payments go to p01.mul-pay.jp. Kimlik bilgilerinin etrafındaki boşluklar kaydedildiğinde silinir.

GMO Payment Gateway — Credit Card

Enable/Disable: Enable GMO Payment Gateway — Credit Card ödeme yöntemini açar veya kapatır. Varsayılan: kapalı.

Title: ödeme adımında gösterilen ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Credit card. Zorunlu.

Description: ödeme adımında ödeme yönteminin altında gösterilen metin. Varsayılan: You will be redirected to the secure GMO Payment Gateway page to pay by credit card.

GMO-PG hesabı

Shop ID ve Shop password, GMO-PG konsolunda Shop management > Shop information altında; Config ID ise Link Type Plus > Settings altında (設定ID) bulunur. Test ve canlı ortamların kimlik bilgileri farklıdır.

Environment: yeni ödemeleri hangi GMO-PG ortamının alacağı.

Production Shop ID: canlı ortamın Shop ID’si.

Production Shop password: canlı ortamın Shop password’ü.

Production Config ID: GMO-PG konsolunda kayıtlı Link Type Plus config ID’si (設定ID).

Test Shop ID: test ortamının Shop ID’si.

Test Shop password: test ortamının Shop password’ü.

Test Config ID: test ortamının Link Type Plus config ID’si (設定ID).

Kaydedilmiş parolalar 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.

Clear saved passwords: bir parolayı işaretleyin ve kaldırmak için Save düğmesine tıklayın. Boş alan kayıtlı değeri korur.

Payment

Capture: kartın ne zaman tahsil edileceği.

Order status after payment: ödenmiş bir siparişin durumu.

Ödeme bildirimleri (結果通知)

Sonuç bildirimi, mağazanıza bir ödemenin yapıldığını bildirir. Zorunludur. GMO-PG mağaza konsolunda 結果通知 (sonuç bildirimi) özelliğini açın ve bu bölümde Notification URL altında gösterilen URL’yi girin. Dostu URL’ler kullanıldığında şuna benzer: https://your-shop/module/wcp_gmo_payment/notify; /ja/ gibi bir dil kodu da içerebilir. URL’yi ayarlarda gösterildiği gibi birebir kopyalayın. İnternetten erişilebilir olmalıdır; bakım modu bunu engellemez.

GMO-PG bildirimleri imzalı değildir, bu nedenle modül içeriklerine asla güvenmez. Bildirim, yapılandırılmış Shop ID’lerinden birinden gelmeli ve ödemenin yapıldığı ortamda bu mağaza tarafından oluşturulmuş bir ödemeye ait olmalıdır. Modül ardından Shop password’ünüzle GMO-PG’den işlemi (SearchTrade) ister ve sepeti veya siparişi yalnızca bu yanıta göre değiştirir. Gerçek bir işlemle eşleşmeyen bir bildirim hiçbir şeyi değiştirmez. Mağaza tarafından oluşturulmayan işlemler, örneğin GMO-PG konsolunda yapılanlar, onaylanır ve yok sayılır. Modül bir bildirimi doğrulayamadığında, GMO-PG’nin bildirimi yeniden göndermesini sağlayacak şekilde yanıt verir (GMO-PG en fazla 5 kez yeniden dener).

Bildirim olmadan sipariş, müşteri ödemeden sonra mağazaya döndüğünde oluşturulur.

Advanced

Debug log: API isteklerini ve bildirimleri modül klasöründeki logs/gmo_pg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar, anahtar kapalıyken bile her zaman kaydedilir. Parolalar ve müşteri verileri maskelenir. Varsayılan: kapalı.

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 modül kaldırıldığında ağ geçidi ayarları ve günlük silinir. Sipariş verileri (GMO OrderID, işlem kimlikleri) her zaman saklanır. Varsayılan: kapalı.

Ödeme

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit card) ve açıklamasını görür. Test ortamında, bunun üstünde TEST — GMO-PG test environment, no real charges. rozeti gösterilir. Onaylandıktan sonra modül, sepet toplamı için tam yene yuvarlanmış bir GMO-PG Link Type Plus ödemesi oluşturur ve müşteriyi GMO-PG ödeme sayfasına gönderir. Müşteri orada kredi kartıyla öder. 3-D Secure 2.0 GMO-PG tarafından yürütülür ve müşterinin e-posta adresi 3-D Secure için GMO-PG’ye iletilir. Ödeme sayfası, müşterinin diline göre Japonca, Çince veya İngilizce açılır. Ödeme GMO-PG’de PS- ve sepet numarasıyla görünür. Başka müşteri verisi gönderilmez. Bu noktada henüz bir sipariş yoktur.

Ödemeden sonra müşteri mağazanıza döner. İmzalı sonuç, ödemenin yapıldığı ortamın Shop password’üyle kontrol edilir ve sipariş yalnızca GMO-PG onayladıktan sonra ödenmiş olarak işaretlenir: müşteri döndüğünde sunucu tarafında yapılan bir SearchTrade isteğiyle ya da sonuç bildirimiyle. İkisi de aynı mantığı kullanır, bu nedenle sipariş asla iki kez oluşturulmaz. Ardından müşteri standart sipariş onay sayfasını görür. GMO-PG ödemeyi henüz onaylamadıysa, Your card payment is being confirmed by GMO Payment Gateway. You will receive an e-mail as soon as it is confirmed. mesajı ve Check again düğmesi ile bir Payment confirmation sayfası görünür; bildirim geldiği anda sipariş oluşturulur.

Kart reddedilirse veya GMO-PG sayfasında ödeme başarısız olursa, müşteri The card payment was declined or could not be completed. Please try again or use another card. mesajıyla ödeme adımına döner. Müşteri ödeme yapmadan GMO-PG sayfasından ayrılırsa mesaj The payment was not completed. You can try again or choose another payment method. olur. Sepet korunur. Her yeni deneme önceki ödenmemiş ödeme bağlantısını iptal eder. Önceki bağlantı bu arada ödendiyse sipariş o ödemeden oluşturulur ve yeni bir bağlantı üretilmez.

1 ile 9.999.999 JPY arasındaki sepet toplamları ödenebilir. Daha yüksek toplamlarda ödeme yöntemi gizlenir. Ödeme başlatılamazsa müşteri ödeme adımında kalır ve Card payment could not be started. Please try again or choose another payment method. gibi kısa bir mesaj görür; neden günlüğe yazılır.

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

Modül kredi kartı ödemelerini yalnızca JPY cinsinden ve her zaman GMO-PG sayfasında kabul eder. Diğer GMO-PG ödeme yöntemleri, birden fazla para birimi, kayıtlı kartlar veya GMO-PG üye kaydı, abonelikler veya tekrarlayan tahsilatlar ve site içinde kart formu yoktur.

Siparişler ve iadeler

Sipariş durumları

Henüz sipariş yok: müşteri GMO-PG’ye yönlendirildi ve henüz ödeme yapmadı ya da GMO-PG ödemeyi henüz onaylamadı. Yalnızca sepet vardır.

Payment accepted veya Delivered: ödeme onaylandı. Durum, Order status after payment ayarını izler. Ödeme, işlem kimliği olarak GMO-PG TranID ile kaydedilir ve bir notta tutar, GMO-PG durumu, işlem ve onay şekli (bildirim ya da dönüş) gösterilir.

GMO-PG payment on hold (provizyonlu): Authorize only (仮売上) seçeneğiyle tutar provizyona alındı. Provizyon sona ermeden Capture payment (GMO-PG) ile ya da GMO-PG konsolunda tahsil edin. Tahsilattan sonra sipariş Payment accepted veya Delivered olur. Provizyon GMO-PG’de iptal edilirse sipariş Canceled olur.

Ödemeden sonra GMO-PG payment on hold: GMO-PG sepet toplamından farklı bir tutar bildirdi ya da sepet JPY değildi. Not bunu açıklar ve ödeme, GMO-PG’nin gerçekte tahsil ettiği tutar için kaydedilir. Siparişi kontrol edin ve yerine getirin ya da ödemeyi iade edin.

Refunded: ödeme modül üzerinden tamamen iade edildi. Hiç tahsil edilmemiş bir provizyonun tam iadesi Canceled durumunu ayarlar.

Siparişi zaten ödenmiş veya kapatılmış bir sepet için ikinci bir ödeme gelirse sipariş değiştirilmez. Bir not, mükerrer ödemeyi GMO-PG konsolunda iade etmenizi ister.

GMO Payment Gateway bloğu

Sipariş sayfasında GMO OrderID, Transaction ID, durum (GMO-PG durumuyla birlikte), Paid / refunded, test ödemeleri için TEST rozeti, iade geçmişi ve siparişin GMO-PG notes bölümü bulunan bir GMO Payment Gateway bloğu gösterilir. Tahsilat ve iadeler için sipariş düzenleme yetkisi gerekir; Modules sayfalarına erişim gerekmez.

Tahsilat

Capture payment (GMO-PG), yalnızca provizyonlanmış ve beklemede olan bir siparişin bloğunda görünür. Capture the authorized GMO-PG payment? onayını verin. Modül işlemi GMO-PG’de kontrol eder ve provizyonlanan tutarı tahsil eder. İşlem artık provizyonlu değilse, örneğin GMO-PG konsolunda zaten tahsil edildiği için, bir not geçerli durumu gösterir ve sipariş bu duruma uyar.

İadeler

Bloğa tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via GMO-PG düğmesine tıklayın. Refund this amount through GMO-PG? onayını verin. Yen cinsinden tam ve kısmi iadeler desteklenir. Sınır, sipariş toplamı değil, GMO-PG’nin gerçekte tahsil edip hâlâ tuttuğu tutardır. Kalan tutarın tamamını iade etmek GMO-PG işlemini iptal eder; bunun iptal mi yoksa iade mi olduğuna GMO-PG karar verir. Kısmi iade işlem tutarını düşürür. İade, ödemenin yapıldığı ortama gönderilir; bu nedenle o ortamın Shop ID ve Shop password’ü tanımlı olmalıdır. GMO-PG iadeyi kabul etmezse blok hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, iade geçmişine ve notlara eklenir. Tam iade siparişi Refunded durumuna getirir; kısmi iade durumu değiştirmez.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri GMO-PG üzerinden para geri göndermez.

GMO-PG konsolunda yapılan iadeler ve iptaller sonuç bildirimiyle gelir ve notlara eklenir. Sipariş durumu ve kredi notları, GMO-PG’de iptal edilen provizyon dışında otomatik değişmez. Gerekirse bunları elle güncelleyin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox GMO Payment Gateway lisans bloğu, Modules > Module Manager > VibeFox GMO Payment Gateway > Configure sayfasında ayarların üstünde yer alan ilk bloktur. Anahtarı License key alanına girin 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) gösterir; ayrıca 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üğmeleri bulunur. Bunların altında Product: presta-payment-gmo satırı ile vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı yer alır. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloktaki metinler back office dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir, örneğin Key not found, This key belongs to another product, Domain limit reached veya License expired on ve bir tarih. Mağaza adresi değiştikten 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 tek bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da. 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 GMO-PG kart ödemesi ödeme adımı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. PrestaShop vitrini back office’e giriş yaptığınızı bilmez, bu nedenle ödeme yöntemi sizin için de gizlenir: modülü anahtar satın almadan önce ayarlayabilirsiniz, 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, tahsilat ve iadeler çalışır.

Bir lisansın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek yenileme gerektirir. Back office’te çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonra haftada bir. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Kredi kartı ödeme adımında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, sepet para biriminin JPY olduğunu ve geçerli ortamda Shop ID, Shop password ve Config ID bulunduğunu kontrol edin. 9.999.999 JPY üzerindeki sepet toplamları kartla ödenemez. Para birimi veya kimlik bilgileri yanlışsa ayarlar sayfası uyarı gösterir. Payment > Preferences bölümünde modülün JPY, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Ödeme başarılı oldu ama sipariş oluşmadı: sonuç bildirimi çalışmıyor. Kullandığınız ortamın GMO-PG mağaza konsolunda 結果通知 özelliğinin açık olduğunu ve URL’nin Notification URL altında gösterilenle birebir aynı olduğunu kontrol edin. Modül her bildirimi bu bilgilerle doğruladığı için o ortamın Shop ID ve Shop password’ünün dolu olduğunu kontrol edin. Debug log seçeneğini açın ve modül sayfasındaki Log alanına bakın. Müşteri ödemeden sonra mağazaya döndüğünde de sipariş oluşturulur.

Log, Notification rejected: unknown ShopID ifadesini gösteriyor: bildirim, Shop ID’si ayarlarda bulunmayan bir mağazadan geldi. O ortamın Shop ID’sini girin.

Log, Notification ignored: OrderID is not a payment of this store ifadesini gösteriyor: işlem bu mağaza tarafından oluşturulmadı; örneğin GMO-PG konsolunda yapıldı. Yapılacak bir şey yoktur.

Log, sepetin başka bir ortamda ödendiğini gösteriyor: test ve canlı ödemeler ayrı tutulur. Bir test bildirimi asla canlı bir ödemeyi onaylamaz, bunun tersi de geçerlidir.

Log, Cannot create the order: the module is disabled ifadesini gösteriyor: modül, bir ödeme onaylanırken devre dışı bırakıldı. Etkinleştirin; GMO-PG bildirimi yeniden gönderir.

Müşteri kartla ödemeyi seçtiğinde hata görüyor: Debug log seçeneğini açın ve Log alanına bakın. Günlük, GMO-PG hata kodunu (ErrCode, ErrInfo) gösterir. Yaygın neden yanlış bir Shop ID, Shop password veya Config ID’dir. GMO Payment Gateway accepts payments in Japanese Yen (JPY) only. ifadesi sepetin JPY olmadığı anlamına gelir.

Sipariş GMO-PG payment on hold durumunda: GMO Payment Gateway bloğundaki notları okuyun. Sipariş yalnızca provizyonlandı ve tahsil edilmeyi bekliyor ya da ödenen tutar sepetten farklıydı.

İade veya tahsilat başarısız oluyor: bloktaki mesajı okuyun. Sipariş, Shop ID ve password’ü tanımlı olmayan diğer ortamda ödenmiş olabilir; işlem GMO-PG’de zaten iptal edilmiş olabilir; ya da tutar işlemde kalan miktarı aşıyor olabilir. The order is being updated by GMO-PG right now. Try again in a moment. ifadesi, aynı anda bir bildirimin işlendiği anlamına gelir.

Blok, You do not have permission to refund orders. ifadesini gösteriyor: çalışan profilinizin sipariş düzenleme yetkisi yok. Bir yöneticiden bu yetkiyi isteyin.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox GMO Payment Gateway yanındaki menüyü açın ve Uninstall seçeneğini seçin. Bu modülün lisans anahtarı ve lisans durumu her zaman silinir. Delete data on uninstall açıksa ağ geçidi ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. GMO-PG işlemleri ve iadeleri ile GMO-PG payment on hold sipariş durumu her zaman saklanır; bu sayede daha önce ödenmiş siparişler yeniden kurulumdan sonra da tahsil edilip iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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