VibeFox GMO for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin. Eklenti bu olmadan etkinleştirilemez.

PHP: 8.0 veya üzeri.

Mağaza para birimi: Japon Yeni (JPY). Başka bir mağaza para biriminde ödeme yöntemi ödeme sayfasında gizlenir. Pay for order sayfasında siparişin para birimi esas alınır.

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) bilgileri gerekir; 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 bir alan adında çalışır.

Kurulum

1. WordPress’te Plugins > Add New > Upload Plugin yoluna gidin, eklentinin ZIP dosyasını seçip Install Now düğmesine tıklayın. wcp_gmo_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 > GMO Payment Gateway — Credit Card > Manage veya Eklentiler sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bölümüne VibeFox lisans anahtarınızı girip Activate düğmesine tıklayın.

5. Test ve/veya canlı ortamın Shop ID, Shop password ve Config ID bilgilerini girip Environment seçimini yapın.

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

7. Enable/Disable seçeneğini açın. Test ortamında bir test ödemesi yapın, ardından Environment seçimini canlı ortama geçirin.

Yapılandırma

Tüm ayarlar tek sayfadadır: WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card. Sayfa başlığında geçerli ortam için TEST veya PRODUCTION rozeti görünür. Mağaza para birimi JPY değilse veya geçerli ortamın Shop ID, Shop password ya da Config ID bilgisi eksikse alanların üzerinde uyarı gösterilir. Her iki durumda da ödeme yöntemi ödeme sayfasında gizlenir. Geçerli ortamın kimlik bilgileri girilene kadar ağ geçidi, ödeme yöntemleri listesinde kurulum gerekiyor olarak işaretlenir. Kimlik bilgilerinin başındaki ve sonundaki boşluklar kaydedilirken kaldırılır.

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

Title: ödeme sayfasında görünen ödeme yöntemi adı. Varsayılan: Credit card.

Description: ödeme sayfasında ödeme yönteminin altında görünen 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 mağaza konsolundaki Shop management > Shop information bölümünde; Config ID ise Link Type Plus > Settings (設定ID) bölümündedir. Test ve canlı ortamların kimlik bilgileri farklıdır.

Environment: ödemeleri alacak GMO-PG ortamı.

Canlı ortam kimlik bilgileri (p01.mul-pay.jp)

Production Shop ID: canlı ortamın Shop ID bilgisi.

Production Shop password: canlı ortamın Shop password bilgisi.

Production Config ID: GMO-PG konsolunda kayıtlı Link Type Plus yapılandırma kimliği (設定ID).

Test kimlik bilgileri (pt01.mul-pay.jp)

Test Shop ID: test ortamının Shop ID bilgisi.

Test Shop password: test ortamının Shop password bilgisi.

Test Config ID: test ortamının Link Type Plus yapılandırma kimliği (設定ID).

Ödeme

Capture: karttan ne zaman tahsilat yapılacağı.

Order status after payment: ödenmiş bir siparişin durumu. Tek bir durum değişikliği ve tek bir müşteri e-postasıyla hemen ayarlanır.

Ödeme bildirimleri (結果通知)

Sonuç bildirimi mağazanıza bir ödeme yapıldığını bildirir. Zorunludur. GMO-PG mağaza konsolunda 結果通知 (sonuç bildirimi) seçeneğini açın ve ayarların bu bölümünde gösterilen bildirim URL’sini tanımlayın. URL, https://your-site/wc-api/gmo_pg_webhook/ biçimindedir. URL’yi ayarlarda gösterildiği şekilde aynen kopyalayın.

GMO-PG bildirimleri imzalı değildir; bu nedenle eklenti içeriklerine asla güvenmez. Bildirim, yapılandırdığınız Shop ID’lerden birinden gelmeli ve siparişin ödendiği ortamda bu mağazanın oluşturduğu bir ödemeye ait olmalıdır. Eklenti daha sonra Shop password bilginizle GMO-PG’den işlemi ister (SearchTrade) ve siparişi yalnızca bu yanıta göre değiştirir. Gerçek bir işlemle eşleşmeyen bildirim hiçbir şeyi değiştirmez. Mağazanın oluşturmadığı, örneğin GMO-PG konsolunda yapılan işlemler için alındı yanıtı verilir ve bunlar yok sayılır. Eklenti bir bildirimi doğrulayamazsa GMO-PG’nin yeniden göndermesini sağlayacak şekilde yanıt verir (GMO-PG en fazla 5 kez yeniden dener).

Bildirim olmadan sipariş yalnızca müşteri ödeme yaptıktan sonra mağazaya döndüğünde onaylanır.

Gelişmiş

Debug log: Log API requests and notifications bunları WooCommerce > Status > Logs bölümüne, wcp_gmo_payment kaynağıyla yazar. Hatalar her zaman günlüğe kaydedilir. Parolalar ve müşteri verileri maskelenir. Varsayılan: kapalı.

Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted. Devre dışı bırakma hiçbir şeyi silmez. Sipariş verileri (işlem kimlikleri) her zaman korunur. Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak Credit card) ve siparişi verir. Eklenti tam yene yuvarlanmış sipariş toplamı için 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 fatura e-posta adresi 3-D Secure için GMO-PG’ye iletilir. Ödeme sayfası sitenizin diline göre Japonca, Çince veya İngilizce açılır. Ödeme GMO-PG’de WC- ve sipariş numarasıyla görünür. Başka müşteri verisi gönderilmez.

Ödemeden sonra müşteri mağazanıza döner. İmzalı sonuç Shop password bilginizle doğrulanır; sipariş yalnızca GMO-PG onayladıktan sonra ödenmiş olarak işaretlenir: müşteri döndüğünde sunucu taraflı SearchTrade isteğiyle veya sonuç bildirimiyle. İkisi de aynı mantığı kullandığından sipariş asla iki kez işlenmez. Ödeme henüz onaylanmadıysa sipariş alındı sayfası Your card payment is being confirmed by GMO Payment Gateway. You will receive an e-mail as soon as it is confirmed. gösterir.

Kart reddedilirse veya GMO-PG sayfasında ödeme başarısız olursa sipariş Başarısız durumuna geçer ve müşteri Pay for order sayfasına The card payment was declined or could not be completed. Please try again or use another card. mesajıyla yönlendirilir. Müşteri GMO-PG sayfasından ödeme yapmadan ayrılırsa aynı sayfa The payment was not completed. You can try again or choose another payment method. gösterir. Her yeni deneme önceki ödenmemiş ödeme bağlantısını iptal eder. Önceki bağlantı bu sırada ödenmişse bu ödeme uygulanır ve yeni bağlantı oluşturulmaz.

Toplamı 1 ile 9.999.999 JPY arasında olan siparişler ödenebilir. Daha yüksek toplamlarda ödeme yöntemi gizlenir. Ödeme başlatılamazsa müşteri örneğin Card payment could not be started. Please try again or choose another payment method. gibi kısa bir mesaj görür ve neden sipariş notlarına eklenir.

Ödeme yöntemi klasik ödeme sayfasında, Sepet ve Ödeme bloklarında ve Pay for order sayfasında çalışır. Ödeme bloğunda kart simgesini ve açıklamayı gösterir. Test ortamında hem klasik ödeme sayfası hem de Ödeme bloğu Test mode — no real charge rozetini gösterir. WooCommerce Yüksek Performanslı Sipariş Depolama (HPOS) ile uyumludur.

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

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri GMO-PG’ye gönderilmiştir ve henüz ödeme yapmamıştır veya GMO-PG ödemeyi henüz onaylamamıştır.

Processing or Completed: ödeme onaylanmıştır. Durum, Order status after payment ayarını izler. Sipariş notu tutarı, GMO-PG durumunu, işlemi ve nasıl onaylandığını (bildirim veya dönüş) gösterir. İşlem kimliği GMO-PG TranID değeridir.

On hold (authorized): Authorize only (仮売上) ile tutar için provizyon alınmıştır. Provizyon süresi dolmadan Capture payment (GMO-PG) sipariş eylemiyle veya GMO-PG konsolunda tahsil edin. Tahsilattan sonra sipariş İşleniyor veya Tamamlandı durumuna geçer. GMO-PG’de provizyon iptal edilirse sipariş iptal edilir.

On hold after payment: GMO-PG sipariş toplamından farklı bir tutar bildirmiştir veya ödeme sipariş iptal edildikten sonra gelmiştir. Sipariş notunda açıklama bulunur. Siparişi kontrol edip yerine getirin veya ödemeyi iade edin.

Failed: kart reddedilmiştir veya GMO-PG sayfasında ödeme tamamlanmamıştır.

Zaten ödenmiş veya kapatılmış bir sipariş için ikinci ödeme gelirse sipariş değiştirilmez. Bir not, yinelenen ödemeyi GMO-PG konsolunda iade etmenizi ister.

Tahsilat

Capture payment (GMO-PG) sipariş eylemi, yalnızca provizyon alınmış Beklemede durumundaki siparişlerde görünür. Provizyon alınan tutarı tahsil eder. İşlem artık provizyonda değilse, örneğin GMO-PG konsolunda zaten tahsil edilmişse eylem geçerli durumu içeren bir not ekler ve bu duruma göre hareket eder.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Credit card düğmesine tıklayın (düğmede Title değeriniz görünür). Tam yen cinsinden tam ve kısmi iadeler desteklenir. Kalan tutarın tamamının iadesi GMO-PG işlemini iptal eder; bunun iptal (void) mi yoksa geri ödeme mi olduğuna GMO-PG karar verir. Kısmi iade işlem tutarını düşürür ve kart şirketi yeni tutara provizyon verir. İade siparişin ödendiği ortama gönderilir; bu ortamın Shop ID ve Shop password bilgileri ayarlanmış olmalıdır. GMO-PG iadeyi kabul etmezse WooCommerce hatayı gösterir ve iade kaydı oluşturulmaz. Başarılı iade sipariş notlarına eklenir.

GMO-PG konsolunda yapılan iadeler ve iptaller sonuç bildirimiyle gelir ve sipariş notlarına eklenir. Bunlar otomatik olarak WooCommerce iadesi şeklinde kaydedilmez. Gerekirse GMO-PG düğmesini kullanmadan WooCommerce’te manuel iade oluşturun.

Lisans anahtarı

Eklenti vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card sayfasının üstündedir. Anahtarı License key alanına yapıştırıp Activate düğmesine tıklayın. Bölüm, lisansın geçerli olduğu son tarih ve alan adınız gibi durum bilgilerini gösterir. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve 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ı bir siteden kaldırmak alan adı hakkını serbest bırakmaz. Bu hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin anahtar olmadan ödeme yöntemi müşterilere ödeme sayfasında gösterilmez. Yine de ödeme başlatılırsa müşteri This payment method is not available. Please choose another one. görür. Oturum açmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece anahtar satın almadan eklentiyi kurup test edebilirsiniz. Eklentiler ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: başlatılmış ödemeler onaylanmaya devam eder, iadeler ve tahsilatlar çalışır.

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

Sorun giderme

Kredi kartı ödeme sayfasında görünmüyor: lisansın etkin, Enable/Disable seçeneğinin açık, mağaza para biriminin JPY olduğunu ve geçerli ortamın Shop ID, Shop password ve Config ID bilgilerinin girildiğini kontrol edin. 9.999.999 JPY üzerindeki siparişler kartla ödenemez. Para birimi veya kimlik bilgileri yanlışsa ayarlar sayfası uyarı gösterir.

Ödeme yapıldı ancak sipariş Pending payment durumunda kalıyor: sonuç bildirimi çalışmıyordur. Kullandığınız ortamın GMO-PG mağaza konsolunda 結果通知 seçeneğinin açık ve URL’nin ayarlardakiyle birebir aynı olduğunu kontrol edin. Eklenti her bildirimi doğrulamak için kullandığından o ortamın Shop ID ve Shop password bilgilerinin girildiğini kontrol edin. Debug log seçeneğini açıp WooCommerce > Status > Logs bölümünde wcp_gmo_payment kaynağına bakın. Müşteri ödeme sonrasında mağazaya döndüğünde de sipariş onaylanır.

Günlükte Notification rejected: unknown ShopID görünüyor: bildirim, Shop ID bilgisi ayarlarda olmayan bir mağazadan gelmiştir. O ortamın Shop ID bilgisini girin.

Günlükte Notification ignored ... is not a payment of this store görünüyor: işlem bu mağazada oluşturulmamıştır; örneğin GMO-PG konsolunda yapılmıştır. Bir işlem yapmanız gerekmez.

Günlük, siparişin başka bir ortamda ödendiğini gösteriyor: test ve canlı ödemeler ayrı tutulur. Test bildirimi asla canlı siparişi onaylamaz; tersi de geçerlidir.

Müşteri sipariş verirken hata görüyor: sipariş notlarını açın veya Debug log seçeneğini etkinleştirin. Notta GMO-PG hata kodu (ErrCode, ErrInfo) görünür. Genellikle neden yanlış Shop ID, Shop password veya Config ID bilgisidir. GMO Payment Gateway accepts payments in Japanese Yen (JPY) only. siparişin JPY cinsinden olmadığını belirtir.

Sipariş ödemeden sonra On hold durumunda: sipariş notunu okuyun. Sipariş için yalnızca provizyon alınmış ve tahsilat bekleniyordur, ödenen tutar siparişten farklıdır ya da ödeme sipariş iptal edildikten sonra gelmiştir.

İade başarısız oluyor: mesajı okuyun. Sipariş Shop ID ve parolası ayarlanmamış diğer ortamda ödenmiş olabilir, işlem GMO-PG’de zaten iptal edilmiş olabilir veya tutar işlemde kalan tutarı aşıyor olabilir.

Lisans bölümü hata gösteriyor: bölümdeki mesajı izleyin. Örneğin anahtar başka bir alan adında kullanılıyorsa vibefox.net hesabınızda bir alan adı hakkını serbest bırakıp Check now düğmesine tıklayın. Site adresi değiştiyse anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti bilinen son durumla çalışmayı sürdürür.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için Plugins sayfasında devre dışı bırakıp silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları ve günlükler yalnızca Delete data on uninstall açıksa kaldırılır. Aksi halde daha sonra yeniden kurulum için saklanır. Siparişlerde saklanan GMO-PG verileri ödeme geçmişidir ve her zaman korunur. Mevcut siparişlerin ödeme notları ve işlem kimlikleri korunur.

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