VibeFox iPay88 for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 - 9.x.

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

iPay88 satıcı hesabı: Merchant Code ve Merchant Key, satıcı hesabınız etkinleştirildiğinde iPay88 tarafından verilir. Ayrıca iPay88 satıcı portalında görüntülenirler. Henüz satıcı değilseniz iPay88 web sitesinden başvurun. Merchant Key'i gizli tutun: ödemeleri imzalar. iPay88'in ayrı bir sandbox ortamı yoktur, bu nedenle test anahtarı da yoktur.

Request URL: web sitenizin adresi iPay88'e Request URL olarak kayıtlı olmalıdır. Aksi halde iPay88 sayfası "Permission not allow" uyarısını gösterir.

Para birimi: Malaysia — MYR ve iPay88 hesabınızda çoklu para birimi seçeneği etkinse USD, SGD, AUD, CAD, EUR, GBP, HKD, CNY, TWD, INR, IDR, PHP veya THB; Philippines — PHP veya USD; Indonesia — IDR; Thailand — THB. Sepet para birimi bölgenizde tahsil edilemiyorsa ödeme yöntemi ödeme adımında gizlenir.

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 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 veya daha sonra modül listesinde VibeFox iPay88 Payment modülünü bulup Configure düğmesine tıklayın.

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

4. iPay88 region bölgenizi seçin, Merchant Code ve Merchant Key bilgilerini girin, Enable/Disable seçeneğini açın ve Save düğmesine tıklayın.

5. Kurulumu kontrol etmek için Test mode açıkken bir ödeme yapın, ardından test modunu kapatın.

Kurulumda modül iki sipariş durumu oluşturur: Awaiting iPay88 payment ve iPay88 payment on hold. PrestaShop, yeni ödeme modülünü tüm para birimleri, ülkeleri ve müşteri gruplarında kullanılabilir hale getirir. Bunları Payment > Preferences bölümünden sınırlayabilirsiniz. Modülü kurduktan sonra etkinleştirdiğiniz bir ülke de orada modül için işaretlenmelidir; aksi halde o ülkedeki müşteriler iPay88'i görmez. Yanıt ve backend URL'leri her ödemeyle birlikte gönderilir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox iPay88 Payment > Configure. Her Save düğmesi tüm sayfayı kaydeder. Alanların üstünde sayfa, bir anahtar eksik olduğu sürece iPay88 Merchant Code ve Merchant Key bilgilerini girin — bu yapılana kadar ödeme yöntemi ödeme adımında gösterilmez. mesajını, mağazanın varsayılan para birimi seçilen bölgede tahsil edilemiyorsa uyarıyı (bu durumda ödeme yöntemi ödeme adımında gizlenir) ve test modu açık olduğu sürece uyarıyı gösterir.

iPay88

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

Title: Müşterilerin ödeme adımında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: iPay88.

Description: Ödeme adımında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely via iPay88 (credit card, online banking, e-wallet).

iPay88 hesabı

iPay88 region: iPay88 satıcı hesabınızın ülkesi. iPay88 ödeme sayfasını ve tahsil edilebilecek para birimlerini belirler. Sipariş her zaman kendi para biriminde tahsil edilir. Varsayılan: Malaysia.

Merchant Code: iPay88 Merchant Code'unuz, örneğin M01234.

Merchant Key: iPay88 Merchant Key'iniz. Ödeme isteklerini imzalar ve iPay88 yanıtlarını doğrular. Gizli tutun. Kayıtlı anahtar bir daha asla gösterilmez: alan boş kalır ve Kaydedildi — korumak için boş bırakın. yazısını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Anahtar, tırnaklar ve ters eğik çizgiler dahil, girildiği gibi kaydedilir.

Clear saved secret: Kayıtlı anahtarı kaldırmak için Merchant Key kutusunu işaretleyin ve Save düğmesine tıklayın. Boş bir alan kayıtlı değeri korur.

Signature type: Ödeme isteklerinin nasıl imzalanacağı. Yanıtlar her iki biçimde de doğrulanır; bu nedenle bir değişiklikten önce başlatılan ödemeler doğrulanabilir kalır.

Ödeme

Payment method: Malaysia PaymentId listesinden bir iPay88 ödeme yöntemini önceden seçin veya Let the customer choose on the iPay88 page seçeneğini bırakın (varsayılan). Liste; Credit Card (MYR), FPX (Online Banking), Maybank2U, Alliance Online, AmBank, RHB Bank, Hong Leong Bank, CIMB Clicks, Web Cash, PayPal (MYR), Credit Card (PHP), Boost, Touch n Go eWallet, GrabPay ve ShopeePay yöntemlerini içerir.

Reference prefix: İsteğe bağlı. iPay88 referansında (RefNo) sepet numarasının önüne eklenir, örneğin SHOP1-. Aynı iPay88 hesabını kullanan her mağazada farklı bir önek kullanın; böylece bir mağazanın yanıtı asla başka bir mağazanın sepetine uygulanmaz. Harfler, rakamlar, "-" ve "_" kullanılabilir, en fazla 10 karakter. Kaydederken diğer karakterler kaldırılır ve rakamla biten bir önekin sonuna "-" eklenir, çünkü sepet numarası RefNo'nun sonundan okunur. Sayfa daha sonra kaydedilen değeri gösterir. Aynı iPay88 hesabıyla WooCommerce'ten PrestaShop'a geçiyorsanız, yeni referansların eski sipariş numaralarını tekrarlamaması için bir önek belirleyin.

Test mode: Charge a fixed test amount instead of the order total. iPay88'in ayrı bir sandbox ortamı yoktur: test ödemeleri, canlı iPay88 sayfasında küçük bir tutarla yapılan gerçek işlemlerdir (1,00; IDR 10.000). Test tutarı alındığında sipariş ödenmiş olarak işaretlenir ve sipariş notu bunu belirtir. Test modu açık olduğu sürece ödeme adımında TEST MODE: only a test amount of ... will be charged. ifadesi gösterilir. Test modunda başlatılan bir ödeme, iPay88 yanıt vermeden test modunu kapatsanız bile her zaman test tutarına göre kontrol edilir. Canlı bir mağazada test modunu asla açık bırakmayın. Varsayılan: kapalı.

Yanıt ve backend URL'leri

Modül her ödemeyle iki URL'yi de gönderir; bu nedenle yapılandırılacak bir şey yoktur. iPay88 bunları isterse bu bölümden kopyalayın. Dostça URL'lerle şu biçimde görünürler: https://your-shop/module/wcp_ipay88_payment/response (Response URL, müşterinin dönüşü) ve https://your-shop/module/wcp_ipay88_payment/backend (Backend URL, sunucudan sunucuya bildirim), isteğe bağlı olarak /en/ gibi bir dil koduyla. Bölüm ayrıca iPay88'e Request URL olarak kayıtlı olması gereken web sitesi adresinizi gösterir.

iPay88'in iki yanıtı da aynı şekilde kontrol edilir: zorunlu alanlar, Merchant Key'iniz ile oluşturulan imza ve bu mağazanın bu sepet için başlattığı bir ödemenin referansı. Geçerli imzası olmayan yanıtlar reddedilir ve asla bir sepeti veya siparişi değiştirmez. Backend bildirimi, yalnızca işlendikten sonra RECEIVEOK yanıtını alır; aksi halde iPay88 bildirimi yeniden gönderir. Mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez. iPay88 şu ödeme durumlarını bildirir:

Gelişmiş

Debug log: Ödeme isteklerini ve iPay88 yanıtlarını modül klasöründeki logs/ipay88_p_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Kişisel veri, Merchant Key veya imza kaydedilmez. Hatalar ve uyarılar, anahtar kapalı olsa bile her zaman kaydedilir. Varsayılan: kapalı.

Log: Günlüğün boyutunu ve son kayıtlarını gösterir. Temizlemek için Clear log düğmesine tıklayın.

Delete data on uninstall: Modül kaldırıldığında ayarları, günlükleri ve iPay88 ödeme verilerini siler. Siparişler ve sipariş durumları asla silinmez. Varsayılan: kapalı.

Ödeme adımı

Ödeme adımında müşteri ödeme yöntemini (varsayılan olarak iPay88) seçer ve onaylar. Bir form, bölgenize ait iPay88 ödeme sayfasına gönderilirken sonraki sayfa Redirecting to iPay88 payment gateway... ve Please do not close this window. ifadelerini gösterir. JavaScript olmadan müşteri Pay Now düğmesine tıklar. Bu noktada henüz bir sipariş yoktur. Modül, sepet toplamını sepet para biriminde (test modunda test tutarını), ürün adlarını ve müşterinin adını, e-posta adresini ve telefonunu iletir. iPay88 sayfasında müşteri kartla, FPX çevrimiçi bankacılık, e-cüzdan veya hesabınızın sunduğu başka bir yöntemle öder.

Sipariş, iPay88 imzalı bir yanıtla onaylayana kadar, müşterinin dönüşünde veya backend bildirimiyle ödenmiş olarak işaretlenmez. Başarılı bir ödemeden sonra sipariş oluşturulur ve müşteri Your iPay88 payment has been received. ifadesinin yer aldığı standart sipariş onay sayfasını görür. Bekleyen bir ödeme için sayfa Your payment is pending confirmation from iPay88. We will update your order as soon as the payment is confirmed. ifadesini gösterir. Beklemeye alınmış bir sipariş için We have received a payment notification from iPay88 and are reviewing it. We will contact you if anything is needed. ifadesini gösterir. Sipariş Payment error durumundaysa veya iptal edildiyse The payment was not completed. Please contact us. ifadesi gösterilir.

Onay, aynı anda backend bildirimi tarafından işleniyorsa müşteri We have not received the payment confirmation from iPay88 yet. If you completed the payment, your order will be updated shortly. ifadesini ve Check again ile Back to checkout düğmelerini görür.

Ödeme başarısız olduysa veya iptal edildiyse sipariş oluşturulmaz ve sepet korunur. Müşteri, iPay88'in nedeniyle birlikte The payment was not completed: ifadesiyle ödeme adımına döner; ardından You can try again or choose another payment method. ifadesi gelir. Aynı sepet için yapılan her deneme aynı RefNo'yu kullanır. Yanıt doğrulanamazsa müşteri Return to the store düğmesiyle birlikte The payment response could not be verified. If you completed the payment, please contact us with your order number — the payment will be checked manually. ifadesini görür.

Ödeme başlatılamazsa müşteri ödeme adımına This payment method is temporarily unavailable. Please choose another payment method. (anahtarlar eksik veya toplam sıfır) ya da iPay88 cannot accept payments in ... Please choose another payment method. (para birimi bölgede tahsil edilemiyor) ifadeleriyle döner. Sepetin zaten bir siparişi varsa (ödenmiş veya bekleyen bir ödemeyi bekleyen), ikinci bir ödeme formu oluşturulmaz ve müşteri sipariş onay sayfasına yönlendirilir.

Modül yalnızca tek seferlik ödemeleri destekler. PrestaShop üzerinden iade, kayıtlı kart, abonelik, ön provizyon ve tahsilat ile sitenizde kart alanları yoktur. Ödeme durumu için iPay88'e yeniden sorgu yapmaz: siparişler yalnızca iPay88 yanıtı ve backend bildirimiyle güncellenir.

Siparişler

Order statuses

No order yet: Müşteri iPay88'e yönlendirildi ve henüz bir sonuç gelmedi ya da ödeme başarısız oldu. Yalnızca sepet vardır.

Payment accepted: iPay88, beklenen tutar ve para birimiyle başarılı bir ödeme bildirdi. Ödeme, iPay88 TransId'si işlem kimliği olarak kaydedilir. Özel bir not TransID, PaymentID, tutar ve para birimini gösterir. Test modunda ikinci bir not, sipariş toplamı yerine test tutarının tahsil edildiğini belirtir.

Awaiting iPay88 payment: iPay88 ödemeyi bekleyen olarak bildirdi. iPay88 onayladığında sipariş Payment accepted durumuna geçer; ödeme başarısız olursa Payment error durumuna geçer.

Payment error: Bekleyen bir ödeme daha sonra başarısız oldu. Not, iPay88'den gelen nedeni gösterir. Bu sepetin zaten bir siparişi var, bu nedenle müşteri onu yeniden ödeyemez ve yeni bir sipariş verir.

iPay88 payment on hold: iPay88, siparişten farklı bir tutar veya para birimiyle başarılı bir ödeme bildirdi ya da ödeme, sipariş iptal edildikten sonra geldi. Sipariş ÖDENMİŞ olarak işaretlenmedi. Not bunu açıklar. iPay88 portalında ödemeyi kontrol edin, ardından siparişi tamamlayın veya ödemeyi iade edin.

Ödenmiş veya iade edilmiş bir sipariş, sonraki bir yanıtla asla değiştirilmez. Bu sipariş için başka bir başarılı ödeme gelirse bir not, iPay88 portalında kontrol etmenizi ve mükerrer ise iade etmenizi ister. Başarısız bir yanıt, ödenmiş, iade edilmiş veya iptal edilmiş bir siparişi asla değiştirmez. Tekrarlanan yanıtlar yeni bir şey eklemez.

iPay88 ödeme bloğu

Sipariş sayfasında RefNo, TransId, durum, istenen tutar, alınan tutar, PaymentId, AuthCode, hata ve bölgeyi içeren bir iPay88 payment bloğu ile test ödemeleri için bir TEST MODE rozeti gösterilir.

İadeler

İadeler PrestaShop'tan iPay88'e gönderilmez. Ödemeyi iPay88 satıcı portalında iade edin, ardından iadeyi PrestaShop'ta elle kaydedin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox iPay88 Payment lisans bloğu, Modules > Module Manager > VibeFox iPay88 Payment > Configure sayfasında, ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarın maskelenmiş halini, durumu (örneğin lisansın geçerli olduğu tarih 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-ipay88 satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure izni olan çalışanlar değiştirebilir. Bloğun metinleri 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 ya da bir tarihle birlikte License expired on. Mağaza adresi değiştikten sonra ya da hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa 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 iPay88, ö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 kurabilirsiniz, ancak ödeme adımında deneyemezsiniz. Modules > Module Manager bölümünde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır.

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

Sorun giderme

iPay88 ödeme adımında görünmüyor: Lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, Merchant Code ve Merchant Key bilgilerinin girildiğini ve sepet para biriminin seçilen iPay88 region bölgesinde tahsil edilebildiğini kontrol edin. Ayarlar sayfası, eksik bir şey olduğunda uyarı gösterir. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Ödeme geçti ama sipariş oluşturulmadı: Ne müşterinin dönüşü ne de backend bildirimi geçerli bir imzayla mağazanıza ulaştı. Log alanına bakın: hatalar her zaman kaydedilir. Merchant Key değerinin iPay88'in verdiğiyle birebir aynı olduğunu ve sunucunuzun ayarlarda gösterilen Backend URL'deki iPay88 isteklerini kabul ettiğini kontrol edin.

iPay88 sayfası "Permission not allow" gösteriyor: Web sitesi adresiniz iPay88'e Request URL olarak kayıtlı değil. iPay88'den Response and backend URLs bölümünde gösterilen adresi kaydetmesini isteyin.

Backend bildirimi BAD SIGNATURE yanıtı veriyor: İmza, Merchant Key ile eşleşmiyor. Merchant Key değerini kontrol edin. Hiçbir şey değiştirilmedi.

Backend bildirimi NOT CONFIGURED yanıtı veriyor: Merchant Code veya Merchant Key ayarlanmamış, bu nedenle yanıt doğrulanamıyor. iPay88 bildirimi yeniden gönderir.

Backend bildirimi UNKNOWN ORDER yanıtı veriyor: Bu referans için bu mağazada hiçbir iPay88 ödemesi başlatılmadı; örneğin aynı hesabı kullanan başka bir mağaza Reference prefix kullanmıyor veya aynısını kullanıyor ya da iPay88 ödeme verileri modül kaldırılırken silindi.

Backend bildirimi RETRY yanıtı veriyor: Sepet o anda müşterinin dönüşüyle onaylanıyordu veya sipariş oluşturulamadı (örneğin modül devre dışı). iPay88 bildirimi yeniden gönderir.

Backend URL tarayıcıda BAD REQUEST gösteriyor: Bu normaldir. URL yalnızca iPay88'den gelen imzalı istekleri kabul eder.

Sipariş iPay88 payment on hold durumunda: iPay88, siparişle eşleşmeyen bir ödeme bildirdi ya da sipariş iptal edilmişti. Sipariş notunu ve iPay88 portalındaki ödemeyi kontrol edin, ardından siparişi tamamlayın veya ödemeyi iade edin.

Müşteri bir para birimi için "iPay88 cannot accept payments in" görüyor: Sepet para birimi seçilen bölgede tahsil edilemiyor. iPay88 Malaysia'da MYR dışındaki para birimleri için iPay88 hesabınızda çoklu para birimi seçeneğinin de açık olması gerekir.

Gerçek müşteriler yalnızca 1,00 tahsil ediliyor: Test mode açık. Kapatın.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox iPay88 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. Onay mesajı, Delete data on uninstall etkin değilse ayarların ve iPay88 ödeme verilerinin korunduğunu belirtir. Etkinse ayarlar, günlükler ve iPay88 ödeme verileri silinir. Etkin değilse sonraki bir yeniden kurulum için her şey korunur. Awaiting iPay88 payment ve iPay88 payment on hold sipariş durumları her zaman korunur. Siparişler asla silinmez ve ödeme notlarını ile işlem kimliklerini korur.

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